Appearance
什么是 Spec-First
核心理念
Spec-First 是一个 AI 开发工程框架，通过三层工程架构（Commands + Skills + Agents）将 AI 辅助开发从"一次性对话"收敛成一套稳定、可追踪、可复用的工程系统。
三层工程架构
Spec-First 采用三层工程边界设计：
| 层级 | 职责 | 数量 |
|---|---|---|
| Commands | 稳定入口 | /spec:* 命令入口 |
| Skills | 编排阶段流程 | 41 个技能 |
| Agents | 提供专业能力 | 47 个代理 |
受管资产模型
Spec-First 通过 spec-first init 将 CLI 发布包中的资产同步到项目中。支持多个 AI 编程工具：
bash
spec-first init --claude # 部署到 .claude/ 目录
spec-first init --codex # 部署到 .codex/ 目录以 Claude Code 为例，初始化后项目结构如下：
.claude/
├── commands/spec/ # 工作流命令入口
│ ├── brainstorm.md
│ ├── plan.md
│ ├── work.md
│ ├── review.md
│ └── compound.md
├── skills/ # 流程编排技能（41 个）
├── agents/ # 专业任务代理（47 个）
└── spec-first/
└── state.json # 受管资产清单资产管理特性
- 统一发布清单：所有资产在
.claude-plugin/plugin.json中注册 - 支持重建：
spec-first init --claude --force可重新同步 - 支持清理：
spec-first clean --claude移除受管资产，保留自定义内容
五阶段工作流
Spec-First 提供从需求到交付的五阶段闭环工作流：
Brainstorm → Plan → Work → Review → Compound
(定义) (规划) (实现) (审查) (沉淀)每个阶段都有明确的输入、输出和转换条件，形成完整的质量闭环。Compound 阶段沉淀的知识会被后续阶段自动发现和引用，形成知识复利。
你是否遇到过这些问题？
问题 1：工程边界不稳定
大多数 AI 开发流的问题不在模型，而在工程边界不稳定：
- ❌ 需求没有被明确记录
- ❌ 计划和实现容易脱节
- ❌ 评审没有结构化结论
- ❌ 好的经验无法沉淀为下一轮输入
Spec-First 的解决方案
Spec-First 把 AI 辅助开发从一次性对话，收敛成一套稳定、可追踪、可复用的工程系统：
- ✅ 稳定的
/spec:*命令入口 - ✅ 五阶段闭环工作流
- ✅ 47 个专业代理审查
- ✅ 知识沉淀与自动发现
与传统 AI 辅助开发的对比
| 维度 | 传统 AI 辅助 | Spec-First |
|---|---|---|
| 入口 | 自然语言对话 | 稳定的 /spec:* 命令 |
| 流程 | 即兴发挥 | 五阶段闭环工作流 |
| 审查 | 人工检查 | 47 个专业代理自动审查 |
| 知识 | 聊天记录 | 结构化文档 + 自动发现 |
术语表
| 术语 | 定义 |
|---|---|
| 受管资产模型 | CLI 发布包中的 commands/skills/agents 通过 init 同步到项目 .claude/ 目录的机制 |
| 三层工程架构 | Commands（稳定入口）+ Skills（流程编排）+ Agents（专业能力）的分层设计 |
| 五阶段工作流 | Brainstorm → Plan → Work → Review → Compound 的闭环流程 |
| 项目级资产管理 | spec-first init --claude 将工程框架资产部署到具体项目的能力 |