Skills 参考

上游 spec-first 源码内置 42 个 source skill definitions。其中 21 个 是 command-backed workflow skills，2 个 是 standalone/meta skills，19 个 是 internal-only source skills。运行时交付会按宿主治理过滤：Claude Code 生成 /spec:* commands；Codex 生成 .agents/skills 下的 $spec-* workflow skills。

本页按研发链路解释这些 skills 如何服务：

Codebase -> Graph -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge

Skill 详情页索引

每个 source skill 都有独立详情页，含入口类型、研发链路位置、何时使用、工作步骤、输出、agent 调度和边界。

公开 workflow

spec-app-consistency-audit	spec-brainstorm	spec-code-review
spec-compound	spec-compound-refresh	spec-debug
spec-doc-review	spec-graph-bootstrap	spec-ideate
spec-mcp-setup	spec-optimize	spec-plan
spec-polish-beta	spec-release-notes	spec-sessions
spec-skill-audit	spec-slack-research	spec-standards
spec-update	spec-work	spec-work-beta

Standalone / Meta

spec-write-tasks	using-spec-first

Internal-only

agent-native-architecture	agent-native-audit	changelog
feature-video	frontend-design	gemini-imagegen
git-clean-gone-branches	git-commit	git-commit-push-pr
git-worktree	lfg	proof
report-bug	resolve-pr-feedback	spec-dhh-rails-style
spec-session-extract	spec-session-inventory	test-browser
test-xcode

资产边界

层级	位置	说明
Source skills	上游 skills/	编辑真源，本轮核验为 42 个，含 using-spec-first meta skill
Claude commands	.claude/commands/spec	21 个 /spec:* command 入口
Claude skill copies	.claude/skills、.claude/spec-first/workflows	standalone/internal skills 与 command-backed workflow copies
Codex runtime skills	.agents/skills	25 个 runtime skill directories，其中 21 个 workflow skills、2 个 standalone/meta、2 个 agent-facing internal

研发主链路

Codebase
  |-- spec-mcp-setup
  |-- spec-standards
  `-- spec-sessions
       |
       v
Graph
  `-- spec-graph-bootstrap
       |
       v
Spec
  |-- spec-ideate
  |-- spec-brainstorm
  `-- spec-doc-review
       |
       v
Plan
  |-- spec-plan
  `-- spec-doc-review
       |
       v
Tasks
  `-- spec-write-tasks
       |
       v
Code
  |-- spec-work
  |-- spec-work-beta
  |-- spec-debug
  |-- spec-optimize
  `-- spec-polish-beta
       |
       v
Review
  |-- spec-code-review
  |-- spec-doc-review
  |-- spec-app-consistency-audit
  `-- spec-skill-audit
       |
       v
Knowledge
  |-- spec-compound
  |-- spec-compound-refresh
  |-- spec-release-notes
  |-- spec-slack-research
  `-- spec-sessions

节点决策表

研发阶段	首选 skill	何时进入	读什么	写什么	Agent 决策
Codebase	spec-mcp-setup	host runtime、MCP、graph provider、helper CLI 或项目 setup facts 未就绪	host、developer profile、AGENTS/CLAUDE、provider 配置	.spec-first/config/*	不默认调 persona agents；以脚本和状态文件为准
Codebase	spec-standards	brownfield 项目需要项目规范、shared standards 或 glue capability baseline	repo facts、graph facts、shared standards、现有 standards	.spec-first/standards/*	输出候选规范；后续由 doc/code review 复核
Graph	spec-graph-bootstrap	setup facts 已准备好，需要编译 graph readiness 和 impact facts	runtime capabilities、provider artifacts	.spec-first/graph/*、.spec-first/impact/*	调 graph providers，不把 agent 回答当 graph fact
Spec	spec-ideate	用户要想法、改进方向、惊喜建议或外部启发	repo、diff、graph、standards、外部资料	ideation artifact 或候选方向摘要	可用 web、issue、repo、best-practices research agents
Spec	spec-brainstorm	WHAT 未定、需求边界不清或存在多个合理产品方向	用户意图、代码库上下文、相关历史	docs/brainstorms/*-requirements.md	可引入 spec-spec-flow-analyzer、product、design、research 视角
Spec / Plan / Tasks	spec-doc-review	requirements、plan 或 task pack 需要语义审查	被审文档、source plan、决策上下文	findings、safe_auto edits、open questions	always-on coherence / feasibility；按信号启用 product、design、security、scope、adversarial
Plan	spec-plan	WHAT 基本清楚，需要 HOW、文件边界、风险和测试方案	requirements、standards、graph、代码模式、历史学习	docs/plans/*-plan.md	需要研究时使用 repo/history/framework/best-practices agents；不执行代码
Tasks	spec-write-tasks	plan 足够大，直接 work 会同时消耗理解和拆分成本	source plan、frontmatter、hash、文件边界	docs/tasks/*-tasks.md 或 skip/return-to-plan 决策	不新增 scope；用依赖、文件重叠和验证面决定 waves
Code	spec-work	有计划、task pack 或清晰实现目标	work doc、repo patterns、tests、standards、diff	code diff、测试结果、总结	按规模选择 inline、serial 或 parallel subagents；文件重叠时串行
Code	spec-work-beta	用户明确要 beta delegation / external delegate	与 spec-work 相同，加 delegate 上下文	code diff、delegate 结果、验证	更适合大任务上下文节省；orchestrator 仍负责集成
Code	spec-debug	有 bug、失败、异常行为、测试失败或 stack trace	复现路径、错误输出、相关代码、历史尝试	fix diff、复现/验证证据	可用 testing、correctness、repo/history agents 辅助，但以复现收口
Code	spec-optimize	目标可度量，适合多实验比较	metric、hard gates、judge 标准、测试命令	measurement scaffold、实验记录、保留方案	可并行候选实验，按指标保留最优
Code	spec-polish-beta	浏览器可见 UI 需要启动、截图和迭代打磨	dev server、页面、desktop/mobile 截图	UI polish diff、截图证据	可用 design iterator / Figma sync / visual review 能力
Review	spec-code-review	已有 diff、PR 或合并前质量检查	diff、plan、tests、standards、graph evidence	findings、safe_auto fixes、residual risks	always-on 6 类 reviewer；按 diff 触发 security、performance、API、migration、reliability、stack reviewers
Review	spec-app-consistency-audit	移动 App 需要 PRD、Figma、本地 source、路由、架构和 i18n 一致性审查	PRD、Figma、本地 source、rule packs	.spec-first/app-audit/runs/<run-id>/	专项审查，不替代 runtime validation
Review	spec-skill-audit	审查 skills、agents、dual-host governance、runtime drift 或 workflow 质量	source skills、runtime copies、governance contracts	.spec-first/audits/skill-audit/*	使用 skill/prompt/workflow 审计视角
Knowledge	spec-compound	最近解决的问题值得沉淀	conversation、diff、docs/solutions、可选 session history	docs/solutions/*	Full 模式并行 Context Analyzer、Solution Extractor、Related Docs Finder、可选 Session Historian
Knowledge	spec-compound-refresh	learning docs 过期、重复、冲突或漂移	docs/solutions、当前代码、相关证据	更新、合并、替换或删除 learning docs	可用 repo/history/research 视角验证漂移
Knowledge	spec-sessions	需要找过去 agent 会话和尝试记录	Claude Code / Codex session files	session digest	通过 internal inventory/extract 能力完成
Knowledge	spec-slack-research	用户明确要 Slack 组织上下文	Slack discussions	research digest	调 Slack researcher，必须标注 workspace 和证据限制
Knowledge	spec-release-notes	需要版本变化、skill 变化或近期 release 摘要	changelog、release artifacts	版本依据摘要	不调 reviewer；按版本事实回答

21 个公开 workflow skills

Source skill	Claude Code	Codex	所属阶段	执行逻辑
spec-mcp-setup	/spec:mcp-setup	$spec-mcp-setup	Codebase	安装并验证 host runtime、MCP servers、graph providers、helper CLIs 和项目 setup facts；失败时输出 blocked/degraded 修复动作
spec-graph-bootstrap	/spec:graph-bootstrap	$spec-graph-bootstrap	Graph	读取 setup facts，运行 provider bootstrap/status/query probe，写 canonical graph facts 和 impact capability envelope
spec-standards	/spec:standards	$spec-standards	Codebase	从 project shape、graph、shared standards 和 observed conventions 生成候选规范；confirmed 才能成为硬约束
spec-update	/spec:update	$spec-update	Codebase	检查 spec-first 版本、runtime assets、managed blocks 和 manifest drift；必要时执行受控 repair
spec-ideate	/spec:ideate	$spec-ideate	Spec	基于 repo、graph、standards、外部证据生成候选想法，并按价值、风险、复杂度排序
spec-brainstorm	/spec:brainstorm	$spec-brainstorm	Spec	通过对话收敛问题框架、actors、key flows、requirements、acceptance examples、scope boundaries 和 open questions
spec-plan	/spec:plan	$spec-plan	Plan	把需求或明确目标转成实施计划，明确文件、依赖、风险、测试场景和执行姿势；不写代码
spec-work	/spec:work	$spec-work	Code	执行计划、task pack 或清晰任务；建立 task tracker，读模式，改文件，跑验证，汇总完成证据
spec-work-beta	/spec:work-beta	$spec-work-beta	Code	在 spec-work 规则上增加外部 delegate / Codex delegation 支持，适合明确要求 beta delegation 的执行
spec-debug	/spec:debug	$spec-debug	Code	复现失败、定位根因、最小修复、验证回归；适用于 bug、stack trace、测试失败和异常行为
spec-code-review	/spec:code-review	$spec-code-review	Review	对 diff / PR 做多 persona 代码审查，合并去重 findings，自动应用 safe_auto 修复并输出 residual risks
spec-doc-review	/spec:doc-review	$spec-doc-review	Spec / Plan / Tasks / Review	对 requirements、plan 或 task pack 做文档语义审查，按文档信号调 persona reviewers
spec-compound	/spec:compound	$spec-compound	Knowledge	在问题解决后沉淀 docs/solutions/*，Full 模式会并行研究、抽取解法和查重
spec-compound-refresh	/spec:compound-refresh	$spec-compound-refresh	Knowledge	审查已有 learning docs 是否与当前代码漂移，按证据更新、合并、替换或删除
spec-app-consistency-audit	/spec:app-consistency-audit	$spec-app-consistency-audit	Review	面向移动 App 的静态一致性审查，覆盖 PRD、Figma、source、routes、架构、analytics、i18n
spec-sessions	/spec:sessions	$spec-sessions	Knowledge	检索 Claude Code / Codex 历史会话，提取相关尝试、失败路径、关键决策和上下文
spec-skill-audit	/spec:skill-audit	$spec-skill-audit	Review	审计 skills、agents、runtime governance、trigger 精度、输出契约、安全和可维护性
spec-slack-research	/spec:slack-research	$spec-slack-research	Knowledge	搜索 Slack 组织讨论，输出解释型 research digest，而不是原始消息列表
spec-release-notes	/spec:release-notes	$spec-release-notes	Knowledge	汇总近期 spec-first release 或回答指定版本 / skill 的变化问题
spec-optimize	/spec:optimize	$spec-optimize	Code	设定可度量目标、构建 measurement scaffold、运行实验、按 gates 和 judge 保留最优方案
spec-polish-beta	/spec:polish-beta	$spec-polish-beta	Code	启动或连接 dev server，用浏览器证据迭代 UI/UX polish

Standalone 与 meta skills

Skill	类型	能力边界
using-spec-first	meta	substantial work 前做入口治理，推荐或进入最匹配的公开 workflow；不是 command-backed workflow
spec-write-tasks	standalone handoff	把 settled plan 编译成可验证 task pack，或验证已有 task pack；保持 plan 为单一真源

Internal-only skills

Internal-only skills 是 workflow 或维护场景的内部能力，不应作为普通用户菜单暴露。

Skill	能力说明
agent-native-architecture	设计 agent-first 应用、MCP tools、自主循环和 agent-native product surfaces
agent-native-audit	对 agent-native architecture 做原则化评分审查
changelog	从近期 merge 生成 changelog 文案
feature-video	为 UI / CLI / 可观察行为捕获 GIF、终端录制、截图或 PR proof
frontend-design	支持前端 UI 设计和视觉质量实现，并通过截图验证
gemini-imagegen	通过 Gemini API 生成或编辑图片资产
git-clean-gone-branches	清理远端已删除 tracking branch 对应的本地分支和 worktree
git-commit	生成清晰 commit message 并提交改动
git-commit-push-pr	commit、push、创建 PR 或仅生成 / 更新 PR 描述
git-worktree	为并行工作或 PR review 创建隔离 worktree
lfg	legacy internal autonomous workflow shim，不作为公开入口推荐
proof	与 Proof editor 协作进行 human-in-the-loop Markdown 评审
report-bug	向 spec-first plugin 报告 bug
resolve-pr-feedback	评估并解决 PR review threads，输出回复和修复摘要
spec-dhh-rails-style	写 Ruby / Rails 时遵循 DHH / 37signals 风格
spec-session-extract	internal：从单个会话文件提取 skeleton 或错误信号
spec-session-inventory	internal：发现 Claude Code / Codex 会话并抽取元数据
test-browser	针对当前 PR 或分支受影响页面运行浏览器测试
test-xcode	使用 XcodeBuildMCP 在 simulator 上构建和测试 iOS app

不再使用的旧口径

• 不再把 source skill definitions 写成 40、41 或 47 个；如果排除 using-spec-first meta skill，必须显式说明统计口径。
• 不再把 review 写成单一 /spec:review / $spec-review。
• 不再把 graph bootstrap 描述成旧 Stage-0 facts 注入链路。
• 不再把 spec-write-tasks 写成 /spec:write-tasks 或 $spec-write-tasks；它是 standalone handoff skill。

阅读下一步

• Workflow 命令总览：21 个命令的执行流程图
• Agents 参考：51 个 agent 的能力分布
• 工作流总览：Codebase → Knowledge 完整研发链路
• 运行模型：source skills / generated runtime 的资产边界