Spec-First

Appearance

快速开始 ​

10 分钟完成你的第一次 Spec-First 工作流体验。

前置要求 ​

  • 已安装 spec-first CLI
  • 以下任一 AI 工具：Claude Code 或 OpenAI Codex

第一步：初始化项目 ​

bash
# 进入你的项目目录
cd my-project

# 检查环境
spec-first doctor

# 初始化（根据你的 AI 工具选择）
spec-first init --claude    # Claude Code 用户
# 或
spec-first init --codex     # OpenAI Codex 用户

# 启动你的 AI 工具
claude    # 或 codex

第二步：体验 Brainstorm ​

在 AI 工具中输入：

bash
/spec:brainstorm "给项目添加一个健康检查接口"

AI 会逐步引导你：

  1. 询问健康检查需要返回哪些信息
  2. 讨论是否需要包含依赖服务状态
  3. 确定验收标准
  4. 生成需求文档到 docs/brainstorms/

预期产出： docs/brainstorms/2026-03-31-health-check-requirements.md

第三步：生成计划 ​

基于上一步的需求文档：

bash
/spec:plan docs/brainstorms/2026-03-31-health-check-requirements.md

AI 会分析需求并生成：

  • 技术选型方案
  • 分步任务拆解
  • 风险识别

预期产出： docs/plans/2026-03-31-001-feat-health-check-plan.md

第四步：执行实现 ​

bash
/spec:work docs/plans/2026-03-31-001-feat-health-check-plan.md

AI 会按计划逐步实现代码，每完成一步提交一次。

预期产出： 可运行的代码 + 测试

第五步：审查代码 ​

bash
/spec:review

26 个专业评审代理从安全性、性能、可维护性等维度审查你的代码变更。

预期产出： 评审报告（包含 P0-P3 严重度分级的问题）

第六步：沉淀经验 ​

bash
/spec:compound

将这次开发中积累的经验记录到知识库。

预期产出： docs/solutions/<category>/ 下的可复用方案文档

恭喜！ ​

你已经完成了一次完整的五阶段闭环工作流：

Brainstorm → Plan → Work → Review → Compound
   (1 分钟)   (1 分钟)  (3 分钟)  (2 分钟)  (1 分钟)

接下来可以尝试 ​

场景命令
不确定要做什么，想找改进方向/spec:ideate
需求明确，想全自动交付/lfg "功能描述"
查看所有可用技能Skills 生态
深入了解工作流原理工作流概览
遇到问题？常见问题