用途:procedure-builder 是一个技能,用于从结构化 spec 文件构建完整的 ICM(Interpreted Context Methodology)流程,或将已有的单体式 runner 技能转换为分阶段工作流。适用于构建多阶段工作流(如 speckit、deps-check、review pipeline)、转换单体技能、为团队仓库创建领域专用流程。不适用于单步操作或每步都需要人工对话的交互式工作流。
主要能力:技能按六个阶段顺序运行。Stage 00 引导 _core/ 目录,检查仓库根目录是否存在 _core/,缺失则从技能模板复制并校验,输出 bootstrap-result.md。Stage 01 发现:读取 spec 文件,提取流程名称、用途、目标目录、参数、各阶段输入输出、共享上下文、用户变量、可选阶段、工具前置条件和相关技能,输出 workflow-map.md。Stage 02 映射:为每个阶段编写正式的 Inputs/Process/Outputs 契约,绘制依赖图,验证单向引用,输出 stage-contracts.md。Stage 03 脚手架:创建流程文件夹结构(SKILL.md、CONTEXT.md、setup/、stages/、shared/),写入各阶段 CONTEXT.md 和 SKILL.md,输出完整流程文件夹。Stage 04 问卷设计:扫描占位符,区分系统级与每次运行变量,生成 setup/questionnaire.md。Stage 05 验证:执行 13 项检查,输出 validation-report.md。
使用方式:需提供符合 references/spec-format.md 格式的 spec 文件,且至少包含 2 个阶段。运行前需阅读 references/icm-conventions.md。技能会生成 workflow-map.md、stage-contracts.md、流程文件夹、questionnaire.md、validation-report.md 五个产物。
限制:spec 少于 2 个阶段则停止;CONTEXT.md 硬上限 80 行,参考文件上限 200 行;发现循环依赖需重构 spec;验证失败不得交付。描述中不得包含阶段数量或并行说明。