SpekLess：AI 编码 Agent 的轻量级规格优先开发工作流

SpekLess 是一个为 AI 编码 Agent（如 Claude Code）设计的轻量级规格优先开发工作流。它通过单一的设计文档（spec.md）和追加式工作日志（execution.md），配合十个斜杠命令技能，实现澄清→规划→实现→验证的完整生命周期，无需状态机、锁文件或检查点文件。

在 Claude Code 等 AI 编码工具中进行规格驱动开发很有价值，但现有工具存在摩擦：

• Token 消耗高：每个工作流步骤（researcher、planner、plan-checker、executor、verifier、integration-checker、nyquist-auditor...）都启动冷启动的子 Agent，重新读取文件、写入自己的工件
• 强制原子提交：污染 git 历史，锁定你在刚性状态机中

• 将一个功能分散在三个文件（spec.md、plan.md、tasks.md）中
• 使用模板驱动的流程，不与 Claude Code 技能集成

• 人类可读，但 Agent 无法获得帮助——每次讨论、规划和验证都是临时性的

SpekLess 是一个最小系统，保留好的部分，去除其余：

1. 每个功能一个活的 spec.md

   • 像 RFC 一样阅读
   • 包含 Context、Discussion、Plan、Verification 章节
   • 一个功能的所有内容都在一个地方

2. 追加式 execution.md 工作日志

   • 人类可读的实际工作叙述
   • 与规格并存
   • 取代原子提交纪律，不强制按他人节奏提交

3. 扁平的功能列表

   • 没有里程碑→阶段→任务的嵌套层次
   • 大工作通过 part_of: 前元字段分解为兄弟文档

4. 十个技能，而非三十个子 Agent

   • 单一主 Agent 通过斜杠命令驱动一切
   • 子 Agent 仅用作广泛代码库读取的上下文防火墙，从不作为流水线步骤

5. 随时干预

   • 文档就是状态
   • 没有 STATE.md、没有检查点文件、没有锁定步骤顺序
   • 编辑任何章节，重新运行任何技能，随时进行

技能	使用场景
/spek:kickoff	启动绿地项目。运行扩展的 PRD 风格讨论，写入 .specs/project.md，并提议搭建初始功能文件夹
/spek:new	向任何项目添加新功能。创建骨架功能文件夹，仅此而已
/spek:adopt	追溯记录已存在的代码。读取实际文件（通过 Explore 子 Agent），反向工程 Context 和 Plan 章节，将所有任务标记为已完成。SpekLess 独有