用途:作为规范工作流编排器,管理规范目录并跟踪用户在 Requirements(需求)、Solution(方案)、Decomposition(分解)各阶段的决策。Decomposition 阶段会根据 specify 分类器选定的层级生成三类产物:Direct(不生成产物)、Incremental(生成 plan/ 目录)、Factory(生成 manifest.md + units/ + scenarios/)。
主要能力:以 SpecStatus 结构描述规范,包含 id(三位补零,如 001)、name、directory(.start/specs/[NNN]-[name]/,旧路径 docs/specs/)、phase(Initialization、Requirements、Solution、Decomposition、Ready)、decomposition_tier(Direct、Incremental、Factory、None)以及 documents 列表(含 name、status、notes)。提供四个工作流步骤:脚手架(用 spec.py 创建新规范并从 template.md 生成 README.md)、读取状态(读取已有规范元数据并将 TOML 输出解析为 SpecStatus,按已有文档提示下一步)、阶段转换(更新目录与 README.md 状态、记录阶段转换,并交接给对应技能)、记录决策(在 README.md 决策日志表中追加行)。
使用方式:入口按参数匹配,传入新的 featureName 时执行脚手架步骤;传入已有 specId 时依次执行读取、转换与记录步骤。创建规范运行 Bash("spec.py "$featureName""),读取状态运行 Bash("spec.py "$specId" --read")。
约束:所有目录操作必须使用随 SKILL.md 同处的 spec.py,不得手动创建规范目录;新规范须由 template.md 生成 README.md;阶段转换前须与用户确认下一步;不得在未更新 README.md 的情况下转换阶段;用户做出工作流选择时须记录决策(日期、决策、理由)。分解阶段按层级路由:Direct 不调用技能,Incremental 调用 specify-incremental,Factory 调用 specify-factory。
适用场景与限制:适用于需要以结构化目录和阶段流转管理规范的项目。资料未提供该技能的收费、价格、平台要求和效果说明。