Skills 生态

当前产品源码内置 47 个 skills。但这些 skills 不会原样、等量地落到每个宿主上，而是经过 dual-host governance 过滤后再分发：

• Claude 运行时：12 个 command-backed workflow + 35 个 skills
• Codex 运行时：34 个 skills

这也是为什么官网不能再简单写成“两个平台都有同样的 /spec:* 命令面”。

---

两类 skills

1. workflow skills

这些 skills 构成 Spec-First 的主流程与前置层。

Skill	Claude Code	Codex	作用
spec-mcp-setup	/spec:mcp-setup	$spec-mcp-setup	宿主准备
spec-graph-bootstrap	/spec:graph-bootstrap	$spec-graph-bootstrap	Stage-0 事实与路由构建
spec-ideate	/spec:ideate	$spec-ideate	发现改进方向
spec-brainstorm	/spec:brainstorm	$spec-brainstorm	澄清需求
spec-plan	/spec:plan	$spec-plan	生成实施计划
spec-work	/spec:work	$spec-work	执行实现
spec-review	/spec:review	$spec-review	结构化评审
spec-compound	/spec:compound	$spec-compound	沉淀知识
spec-debug	/spec:debug	$spec-debug	复现和诊断 bug
spec-sessions	/spec:sessions	$spec-sessions	搜索历史 session
spec-update	/spec:update	$spec-update	刷新运行时资产
setup	/spec:setup	$spec-setup	host / environment setup 入口

---

2. standalone skills

这些 skills 不一定以 workflow command 的形式暴露，但它们是当前源码中真实存在的能力层。

常见类别包括：

• Git 与交付：git-commit、git-commit-push-pr、git-worktree、git-clean-gone-branches
• 文档与知识：document-review、onboarding、changelog、deploy-docs
• 浏览器与验证：agent-browser、test-browser、test-xcode、feature-video
• 工作流增强：lfg、spec-work-beta、spec-compound-refresh
• 调研与诊断：reproduce-bug、report-bug、resolve-pr-feedback
• Todo 与持久化追踪：todo-create、todo-triage、todo-resolve
• 技术栈 / 专项：frontend-design、dspy-ruby、andrew-kane-gem-writer、gemini-imagegen、rclone

---

当前主工作流 skill 链

spec-mcp-setup
→ spec-graph-bootstrap
→ spec-ideate
→ spec-brainstorm
→ spec-plan
→ spec-work
→ spec-review
→ spec-compound

其中：

• 前两步是前置层
• 后六步是主工作流

---

当前源码中的 47 个 skills

下面这份列表按当前 skills/ 目录整理，属于源码真源视角：

Workflow 与 Stage-0

• setup
• spec-mcp-setup
• spec-graph-bootstrap
• spec-ideate
• spec-brainstorm
• spec-plan
• spec-work
• spec-work-beta
• spec-review
• spec-compound
• spec-compound-refresh
• spec-debug
• spec-sessions
• spec-update

安装、治理与辅助

• using-spec-first
• lfg
• orchestrating-swarms
• document-review
• changelog
• onboarding
• deploy-docs
• report-bug
• reproduce-bug
• resolve-pr-feedback

Git 与工作区

• git-commit
• git-commit-push-pr
• git-worktree
• git-clean-gone-branches

验证与演示

• agent-browser
• test-browser
• test-xcode
• feature-video

Todo / 持久化跟踪

• todo-create
• todo-triage
• todo-resolve

设计、研究与专项能力

• frontend-design
• proof
• rclone
• gemini-imagegen
• dspy-ruby
• andrew-kane-gem-writer
• every-style-editor
• claude-permissions-optimizer
• agent-native-architecture
• agent-native-audit
• spec-slack-research

---

需要特别避免的旧说法

下面这些表述已经不适合作为官网当前口径：

• “Codex 和 Claude 都直接使用 /spec:*”
• “所有 skills 都会等量安装到两个宿主”
• “只有五阶段，没有宿主准备与 Stage-0”
• “当前 skills 总数还是 41 或 42”

---

如何理解 command-backed workflow 和 standalone skill

command-backed workflow

它们有明确的用户入口：

• Claude：/spec:*
• Codex：$spec-*

standalone skill

它们是能力层，不一定都表现为统一命令面，但会被 workflow 或用户显式调用。

比如：

• lfg
• git-worktree
• frontend-design
• todo-create

---

下一步

• Agents 体系
• 工作流与阶段
• LFG 自主执行