Skills 参考
上游 spec-first 当前公开快照有 35 个 source skill definitions：17 个 command-backed workflow skills、14 个 standalone/meta skills、4 个 internal-only skills。Codex runtime 当前生成 31 个 .agents/skills 目录，internal-only skills 按宿主投递规则随需生成。
这些 skills 是 workflow 入口和 handoff 契约，不是让用户一次性展开的命令菜单。
Skill Routing
当前主轴是 Codebase → Spec → Plan → Tasks → Code → Review → Knowledge；provider 输出只是候选证据。
CodebaseRuntime Setupruntime-setup 准备 required MCP、helper tools 和 CodeGraph / Graphify readiness。
SpecIdeate / Brainstorm / PRD把候选方向、模糊需求或存量增量收敛成 requirements。
PlanPlan / Tasks把方案变成可执行、可验证、可交接的边界。
ReviewWork / Review / Knowledge执行、调试、评审，再沉淀到 solutions 与 sessions。
公开 Workflow
Standalone / Meta
spec-explain | spec-handoff | spec-lfg |
spec-pov | spec-product-pulse | spec-promote |
spec-riffrec-feedback-analysis | spec-rule-miner | spec-simplify-code |
spec-strategy | spec-sweep | using-spec-first |
Internal-only
spec-commit | spec-commit-push-pr | spec-resolve-pr-feedback |
spec-test-browser | spec-test-xcode | spec-worktree |
资产边界
| 层级 | 位置 | 当前事实 |
|---|---|---|
| Source skills | 上游 skills/*/SKILL.md | source skill definitions（数量以 source-capabilities.json 为准） |
| Claude commands | .claude/commands/spec、.claude/commands/spec-*.md | 17 个 spec-* workflow command 入口 |
| Claude skill copies | .claude/skills、.claude/spec-first/workflows | standalone/internal skills 与 workflow copies |
| Codex runtime skills | .agents/skills | runtime skill directories（数量以 init 投影为准） |
| Agents | 上游 skills/**/references/agents/*.md | 26 个唯一 agent（46 处 skill-local 调用） |
节点决策表
| 阶段 | 首选 skill | 何时进入 | 输出 |
|---|---|---|---|
| Codebase | spec-runtime-setup | required MCP、helper tools、runtime facts 或 provider pack 需要准备 | .spec-first/config/* setup facts |
| Spec | spec-ideate、spec-brainstorm、spec-prd | 需要想法候选、需求成型或 PRD-grade current-state delta | docs/ideation/*、docs/brainstorms/* |
| Plan | spec-plan | WHAT 清楚但 HOW、文件边界、验证面未定 | docs/plans/*-plan.md |
| Tasks | spec-write-tasks | settled plan 需要可交接 task pack | docs/tasks/*-tasks.md |
| Code | spec-work、spec-debug、spec-optimize、spec-polish、spec-dogfood | 需要执行、修 bug、优化指标、浏览器打磨或自主 dogfood | diff、验证结果、运行证据 |
| Review | spec-code-review、spec-doc-review、spec-app-consistency-audit | diff、文档或 App 一致性需要审查 | findings、audit artifacts、residual risks |
| Knowledge | spec-compound、spec-compound-refresh | 需要沉淀、刷新或检索团队知识 | solution docs、refresh report |
事实来源与审计
- 数量事实来自上游
skills-governance.json、skills/*/SKILL.md和生成的spec-first-facts.json。 spec-rule-miner是 standalone handoff skill，不是 workflow command。spec-first update是 package CLI 的升级与 runtime 刷新命令，不是宿主 workflow。- Provider 输出只能作为候选证据；verified claims 仍需要当前源码、diff、测试、日志或用户证据。
阅读下一步
- Workflow 命令总览：17 个 workflow 的入口和边界
- Agents 参考：按 skill 归属查看 26 个 agent；各 skill 详情页含 Agent / Persona 列表
- 工作流总览：Codebase → Knowledge 完整研发链路