用途
Work Unit Protocol 用于管理一个“工作单元”——即一个范围受限、具有可衡量完成标准的成果。该技能定义了每个工作单元从启动到关闭报告所遵循的节奏，并强制执行 ULTRA §13 报告契约。
主要能力
该技能将工作单元划分为五个阶段：
-
启动（Kickoff）：用一句话陈述范围并给出可衡量的完成标准；扫描已有工具（已安装的插件、技能、命令、智能体、MCP），绝不重复构建；识别依赖与阻塞关系；若创建或修改库，确认不存在并行模块。
-
计划（Plan）：列出将要产出的工件及其路径；列出要编写的测试（成功路径 / 幂等 / WhatIf / 错误）；识别要扩展与要新建的库模块，默认选择扩展；记录必须保持同步的策略文件（policies/*.json）。
-
执行（Execute）：每个动作向 state/change-log.jsonl 写入一条记录；新代码需带基于注释的帮助和至少一个 Pester（或等价）测试；重构需保持行为不变，并用配对测试证明无回归；多仓库工作时按子仓库进行小步提交。
-
验证（Verify）：tools/run-all-tests.ps1（或项目等价物）全绿；对影响实际环境的脚本，针对真实目标重跑，必须为空操作（幂等性检查）；tools/validate-all-policies.ps1 报告无漂移（当策略适用时）。
-
关闭（Close）——报告：产出工作单元报告，包含以下部分：What was implemented（已实现内容，含路径与一行用途）、Test totals（测试总数，如
<suite>: N/N PASS）、Why（ULTRA §13 问答：变更会破坏什么、什么证明其有效、能否复用、能否简化、是否可观测、是否有文档、是否最佳长期设计）、What's COMPLETE（Section 20，含工件、状态、证据的表格）、What's INCOMPLETE（未完成项及时间估计）、Risks flagged（标记的风险）、Awaiting decision（等待用户决策的阻塞项）。
使用方式
该技能通过用户指令触发，常见调用模式包括：
- 用户说“Let's start a work unit for X”：运行阶段 1，产出一句话范围与标准，在进入阶段 2 前确认。
- 用户说“Close work unit”或“work unit report”：根据当前会话工件产出阶段 5 报告。
- 用户说“Ship it”或“merge it”：阻塞，直到阶段 4 和阶段 5 完成且全绿。
适用场景
适用于需要以可验证、可追溯方式推进的离散工作单元，尤其是涉及代码实现、测试编写、策略同步和实际环境影响的开发任务。
限制与不可协商项
- 没有证据（文件路径 + 测试结果）不得称“完成”。
- 受影响测试套件未全绿不得称“完整”。
- 涉及实际影响的代码未经幂等重跑不得称“已发布”。
- 不得有隐藏状态——报告中每个事实都必须可从仓库文件验证。
相关资源
- rules/ultra-mode.md —— 治理性章程。
- skills/harness-automation —— CI 流水线是验证的一部分。
- commands/wa-report —— 一次性报告生成器。