该技能是一个面向“按规范实现”的流程编排工具,目标是在给定基线范围内实现已经写清楚的规范行为,并通过绿色测试、收敛的审查和一致的规范证据来证明实现正确。
主要用途 它不负责从零发现需求或编写规范,而是接收一份规范(canonical spec)或测试用例集作为基线,把其中的行为落实到代码与测试中,同时防止实现范围扩张。
启动与跟踪方式 使用时通过工作流入口激活($start-workflow workflow-implement-spec),并结合注册表 workflows.workflow-implement-spec 解析所选模式、前置动作和指纹。流程要求先建立待办清单:在分诊、分析或步骤执行之前,按所选模式的每个阶段各建一条待办,按顺序登记每个阶段的全部出现项(包括条件或可选步骤),保留出现编号、角色和屏障组;随后将第一条标为进行中,逐步以“执行或跳过”的证据关闭条目,只有全部条目关闭且退出条件满足时才完成该阶段待办。进度在上下文压缩后需要重新读取报告和任务列表。
分诊 第一项实质动作是对目标做规模与类型分诊,并把结果记入运行报告。规模为参考值:XS 为 1–3 个文件或不超过 100 行改动,S 不超过 15 个文件,M 不超过 60,L 不超过 300,XL 超过 300。类型包括行为变更、公开契约/API、数据/模式/迁移、安全敏感(认证、密钥、资金、PII)、UI 界面、基础设施/CI、跨模块/跨服务、仅测试、工具/配置。风险维度包括不可逆、数据、安全、跨模块;深度应随风险和歧义提升,而不只看文件数量。XS/S 走简短调查与简短计划并内联执行;M 或涉及公开契约、数据/模式、安全类型时执行完整调查和精简计划;L/XL 则需要把构建、集成测试和审查按模块或测试用例组切分为有界批次。
流程阶段 默认模式依次为:调查($investigate,核心)、规范缺口核对($spec [mode=clarify],核心)、计划($plan,核心)、按计划执行($plan --mode=execute,核心)、种子测试数据($seed-test-data,可选条件)、集成测试($integration-test,可选条件)、规范同步($spec [mode=sync],可选条件)、变更审查($workflow-review-changes --tests=defer,门禁)、集成测试验证($integration-test --mode=verify,门禁)、端到端测试($workflow-e2e --source=context,可选条件)、运行其余测试层级($test --proven=@verify,门禁)、收尾($workflow-end,门禁)、会话报告($watzup,可选条件)。阶段待办对应为:发现、规范、计划、构建、审查、验证、收尾。
greenfield-slice 模式用于绿地项目首个切片:计划步骤在交接的已批准计划仍覆盖该切片及其规范时可跳过,产品持久化状态时需要种子数据,端到端测试由可选变为门禁,其余结构与默认模式一致。
质量门禁 测试通过:本轮在静态审查之后运行一次集成测试验证(含变异检查)且全绿,并用 $test --proven=@verify 运行验证报告未覆盖的所有层级;每个已实现的测试用例都有测试点明其业务意图/守护不变式,且该意图被破坏时测试会失败。审查收敛:内联运行变更审查并收敛,阻塞性问题修复后重新审查。规范同步:行为或规范的用例与测试证据映射发生变化时,在测试编写后、审查前完成同步;审查修复导致不一致时只重做该范围的同步。运行关闭:收尾步骤检查所有门禁。不得猜测行为;范围保持在记录的 spec_baseline 内。
限制与注意事项 规范模糊、矛盾或请求的行为不在规范中时,流程会在计划前停止,请用户澄清规范或转入先更新规范的工作流,不会静默遗漏。缺少的能力会导致步骤停止并询问用户后再做适配。工作流调用需遵循注册表中的角色与条件,可选步骤跳过时须写明跳过理由。项目若使用可移植跟踪器,需要在捕获、开始、保存工作、验证、交接和收尾等检查点读取集成指南并使用实际关联项。
适用场景 已有规范或测试用例集的迭代开发、需要严格控制范围的实现任务、绿地项目首个切片的落地,以及要求代码与测试同步完成并留下可核查证据的工程流程。具体安装方式与调用细节暂未提供。