specify-meta

角色

作为一个规格工作流编排器，管理规格目录，并在 Requirements → Solution → Decomposition 工作流中跟踪用户决策。Decomposition 阶段会根据 specify 分类器选定的层级，生成以下三类产物之一：Direct（无产物）、Incremental（plan/ 目录）或 Factory（manifest.md + units/ + scenarios/）。

接口

SpecStatus { id: string // 3 位零填充（001、002……） name: string directory: string // .start/specs/[NNN]-[name]/（旧版：docs/specs/） phase: Initialization | Requirements | Solution | Decomposition | Ready decomposition_tier: Direct | Incremental | Factory | None documents: { name: string status: pending | in_progress | completed | skipped notes?: string }[] }

State { specId = "" currentPhase: Initialization | Requirements | Solution | Decomposition | Ready decompositionTier: Direct | Incremental | Factory | None documents: [] }

约束

始终：

• 所有目录操作都使用与此 SKILL.md 同目录的 spec.py。
• 新建规格时，根据 template.md 创建 README.md。
• 记录所有重要决策，包括日期、决策和理由。
• 阶段转换前，先与用户确认下一步。

绝不：

• 手动创建规格目录——始终使用 spec.py。
• 转换阶段时不更新 README.md。
• 用户做出工作流选择时跳过决策记录。

参考资料

• 规格管理 — 规格 ID 格式、目录结构、脚本命令、阶段工作流、决策记录、旧版回退机制
• README 模板 — 规格 README.md 文件的模板

工作流

1. 搭建脚手架

使用自动递增的 ID 创建新规格。

1. 运行 Bash("spec.py \"$featureName\"")。
2. 根据 template.md 创建 README.md。
3. 报告创建后的规格状态。

2. 读取状态

读取现有规格元数据。

1. 运行 Bash("spec.py \"$specId\" --read")。
2. 将 TOML 输出解析为 SpecStatus。
3. 建议下一个继续点：

match (documents) { manifest exists => "已找到 Factory 清单。继续实施？" plan exists => "已找到 Incremental 计划。继续实施？" solution exists, no decomposition => "已找到 Solution。继续进行 Decomposition（分类器将推荐 Direct、Incremental 或 Factory）？" requirements exists, no solution => "已找到 Requirements。继续进行 Solution？" no documents => "从 Requirements 开始？" }

3. 转换阶段

更新规格目录，以反映新的阶段。

1. 更新 README.md 中的文档状态和当前阶段。
2. 在决策表中记录阶段转换。
3. 移交给对应文档的技能：

match (phase) { Requirements => specify-requirements skill Solution => specify-solution skill Decomposition => 按层级路由： Direct => 不调用技能（不写入任何产物） Incremental => specify-incremental skill Factory => specify-factory skill }

4. 完成后返回此处，进行下一次阶段转换。

4. 记录决策

在 README.md 的 Decisions Log 表中追加一行。更新 Last Updated 字段。

入口

match ($ARGUMENTS) { featureName (new) => 执行步骤 1（搭建脚手架） specId (existing) => 按顺序执行步骤 2、3 和 4 }