Workflow 命令执行逻辑总览 ​

下表列出 spec-first 全部 command-backed workflow skills。当前产品面统一使用 spec-* 入口；不同宿主只在 runtime 投递形态上不同。Claude Code 的 /spec:* 和 Codex 的 $spec-* 是兼容别名，不再作为官网主入口表达。

spec-first update 是 package CLI 命令，用于升级 npm CLI 并尝试刷新 runtime，不是宿主 workflow。

总体入口治理 ​

text
用户提出任务
  |
  v
using-spec-first 判断是否需要进入公开 workflow
  |
  +-- 环境 / MCP / helper / runtime readiness -> spec-runtime-setup
  +-- 想法和 WHAT 不清楚 ---------------------> spec-ideate / spec-brainstorm / spec-prd
  +-- HOW 不清楚 -----------------------------> spec-plan
  +-- 计划需要执行 ---------------------------> spec-work / spec-debug / spec-optimize / spec-polish / spec-dogfood
  +-- 已有 diff 或文档要评审 -----------------> spec-code-review / spec-doc-review
  +-- 已解决问题需要沉淀 ---------------------> spec-compound / spec-compound-refresh

命令索引 ​

Skill当前入口兼容别名主要用途
spec-runtime-setupspec-runtime-setup/spec:runtime-setup、$spec-runtime-setup验证 required MCP、helper tools、runtime setup facts 和 CodeGraph / Graphify provider readiness
spec-ideatespec-ideate/spec:ideate、$spec-ideate生成、批判和排序方向候选
spec-brainstormspec-brainstorm/spec:brainstorm、$spec-brainstorm收敛需求、边界和验收样例
spec-prdspec-prd/spec:prd、$spec-prd存量系统增量需求的 PRD 级文档
spec-planspec-plan/spec:plan、$spec-plan形成实施计划或深化已有计划
spec-workspec-work/spec:work、$spec-work执行计划、task pack 或清晰实现任务
spec-debugspec-debug/spec:debug、$spec-debug复现、定位并修复 bug
spec-code-reviewspec-code-review/spec:code-review、$spec-code-review代码 diff / PR 评审
spec-doc-reviewspec-doc-review/spec:doc-review、$spec-doc-review需求、计划、task pack 或文档评审
spec-compoundspec-compound/spec:compound、$spec-compound沉淀已解决问题
spec-compound-refreshspec-compound-refresh/spec:compound-refresh、$spec-compound-refresh刷新过期 learning docs
spec-app-consistency-auditspec-app-consistency-audit/spec:app-consistency-audit、$spec-app-consistency-audit移动 App 静态一致性审查
spec-dogfoodspec-dogfood/spec:dogfood、$spec-dogfood活动分支/PR 的自主浏览器 dogfood QA
spec-optimizespec-optimize/spec:optimize、$spec-optimize围绕指标做迭代优化
spec-polishspec-polish/spec:polish、$spec-polish浏览器可见 UI 打磨
spec-write-tasksspec-write-tasks/spec:write-tasks、$spec-write-tasks把已定稿 plan 编译成可选 derived task pack 或校验已有 task pack
spec-write-skillspec-write-skill/spec:write-skill、$spec-write-skill编写、改写、迁移或按 audit findings 修复 source skill

执行边界 ​

阶段Workflow关键输入关键输出
Codebasespec-runtime-setuphost、repo target、MCP/helper/provider registry、project instructions.spec-first/config/* setup facts、blocked/degraded next actions
Specspec-ideate主题、约束、代码库背景、外部证据docs/ideation/*-ideation.md 或候选方向摘要
Specspec-brainstorm用户想法、已有 ideation、当前系统背景docs/brainstorms/*-requirements.md
Specspec-prd存量系统增量、现有 PRD、current-state evidenceartifact_kind: prd-requirements 的 requirements 文档
Planspec-planrequirements、项目说明、源码证据、测试面docs/plans/*-plan.md
Codespec-workplan/task pack/明确实现目标、源码模式、验证命令scoped diff、验证结果、closeout evidence
Codespec-debug失败现象、复现路径、日志、相关源码root cause、fix diff、回归验证
Codespec-optimize可度量目标、measurement scaffold、hard gates实验记录、保留方案、指标证据
Codespec-polish可运行页面、dev server、视觉目标UI polish diff、截图/浏览器证据
Reviewspec-dogfood活动分支/PR、受影响用户流、agent-browserdogfood 报告、小故障修复、人工决策阻塞
Reviewspec-code-reviewdiff、PR、plan、测试结果、项目规则structured findings、safe_auto fixes、residual risks
Reviewspec-doc-reviewrequirements/plan/task pack/Markdown 文档文档 findings、open questions、可继续条件
Reviewspec-app-consistency-auditPRD、Figma context、source、route、architecture facts.spec-first/app-audit/runs/<run-id>/
Knowledgespec-compound已解决问题、diff、验证、历史上下文docs/solutions/**/*
Knowledgespec-compound-refresh旧 solution docs、当前源码、漂移证据更新、合并、替换或删除 learning docs

Standalone 与 CLI ​

能力入口说明
升级 CLI 与刷新 runtimespec-first updatepackage CLI，升级 npm 包并尝试重新运行 init
Task pack 确定性校验`spec-first tasks hashvalidate`

阅读下一步 ​