spec-plan

把需求或明确目标转成结构化实施计划，定义 HOW。

ASCII 链路图

Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
                      |
                      v
                      spec-plan
                      entry: spec-plan
                      type: workflow command

基本信息

字段	内容
Skill	spec-plan
类型	workflow command
研发链路位置	Plan
当前入口	spec-plan
兼容别名	/spec:plan、$spec-plan
Source	skills/spec-plan/SKILL.md
Governance	src/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述

Create or deepen evidence-grounded plans for multi-step software and non-software work, including plans derived from requirements and answer-seeking research plans. Use when the outcome is clear enough to plan but HOW is unsettled. Prefer spec-brainstorm for unresolved WHAT, spec-debug for active failures, spec-work for implementation or tests, spec-doc-review for independent document critique, and runtime-maintenance for generated runtime mirrors.

Source 契约摘要

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用

• WHAT 基本清楚但 HOW 未定。
• 需要文件边界、技术路线、风险、测试场景和 sequencing。
• 已有 requirements 文档需要进入实施设计。

工作步骤

• 读取 requirements、project guidance、provider evidence、相邻代码和测试模式。
• 确定 HOW：技术路线、文件边界、依赖顺序、风险和验证面。
• 把未知项分类为 planning blocker 或 implementation-time unknown。
• 输出可执行但不写代码的实施计划。

输出

• implementation plan、requirements trace、file list、test scenarios 和 verification plan。
• 需要 task pack 时，交给 spec-write-tasks；可直接实现时，交给 spec-work。

Agent / Persona 列表

• 需要额外 grounding 时使用 repo research、git history、framework docs 或 best-practices agents。
• 计划质量可交给 doc-review personas 复核。

本 skill 在 source 中挂载了 16 个 skill-local 专家资产（agent 16 · persona 0），路径为 skills/spec-plan/references/{agents,personas}/。跨 skill 复用时，详情页按文件名去重。

名称	类型	摘要
spec-agent-native-planning-strategist	agent	You are an agent-native planning strategist.
spec-architecture-strategist	agent	You are a System Architecture Expert specializing in analyzing code changes and system design decisions.
spec-best-practices-researcher	agent	You are an expert technology researcher specializing in discovering, analyzing, and synthesizing best practices from authoritative sources.
spec-data-integrity-guardian	agent	You are a Data Integrity Guardian, an expert in database design, data migration safety, and data governance.
spec-data-migration-reviewer	agent	You are a data migration and schema-change reviewer.
spec-deployment-verification-agent	agent	You are a Deployment Verification Agent.
spec-framework-docs-researcher	agent	You are a meticulous Framework Documentation Researcher specializing in gathering comprehensive technical documentation and best practices for software libra...
spec-git-history-analyzer	agent	You are a Git History Analyzer, an expert in archaeological analysis of code repositories.
spec-learnings-researcher	agent	You are a domain-agnostic institutional knowledge researcher.
spec-pattern-recognition-specialist	agent	You are a Code Pattern Analysis Expert specializing in identifying design patterns, anti-patterns, and code quality issues across codebases.
spec-performance-oracle	agent	You are the Performance Oracle, an elite performance optimization expert specializing in identifying and resolving performance bottlenecks in software systems.
spec-repo-research-analyst	agent	You are an expert repository research analyst specializing in understanding codebases, documentation structures, and project conventions.
spec-security-sentinel	agent	You are an elite Application Security Specialist with deep expertise in identifying and mitigating security vulnerabilities.
spec-slack-researcher	agent	You are an expert organizational knowledge researcher specializing in extracting actionable context from Slack conversations.
spec-flow-analyzer	agent	Analyze specifications, plans, and feature descriptions from the end user's perspective.
spec-web-researcher	agent	You are an expert web researcher specializing in turning open-ended search queries into a focused, structured external grounding digest.

agent 详情页入口仍在 /reference/agents/*；完整按 skill 归属索引见 Agents 参考。persona 目前以 skill-local prompt 形式挂在所属 skill 下，不单独生成全局详情页。

边界

• 不执行代码。
• 产品 blocker 未解决时应回到 brainstorm 或明确假设。

源码校准

• 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
• 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
• 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。