KRT Light Compound Master 是一个实验性技能,旨在以紧凑的方式完成一个范围有限的软件工作包,从理解上下文到实现、验证、基于风险的评审以及发布交接。它遵循与 krt-compound-master 类似的大致阶段:澄清、计划、实现、验证、评审和发布交接,但它是后者的实验性兄弟版本,不替代完整技能中的制品契约。在没有明确的迁移决策时,不应在同一个活跃工作包上同时运行两个 Master。
用途与模式
该技能接受模式参数:plan、execute、full、resume、status,以及可选的工作包或评审单元路径、运行 ID、状态路径、编排器(standalone 或 seneschal)、倡议契约和交互模式(直接或代理)。
- plan:生成或刷新简洁的执行简报,并在编写代码之前停止。
- execute:实现已准备好的简报或已评审的现有工作包。
- full:当请求已授权两者时,同时进行计划和执行。
- resume:在继续之前检查实时事实和状态记录。
- status:报告当前证据和下一步行动,不做任何变更。
当请求需要项目路线图、独立的已评审头脑风暴和计划制品、正式的工作包模式或其自主制品流水线时,应使用完整的 Compound Master。一个清晰的单一任务不需要任何 Master,除非其交付能从额外的协调中获益。
上下文与单一状态记录
该技能会检查仓库、当前更改、用户请求和相关现有需求,并保留不相关的工作。它复用已批准的倡议契约和分配到的路线图条目,不创建竞争的路线图。如果范围、验收标准、依赖关系、生产姿态或重要决策不明确,它会调查仓库能够解决的部分,并升级剩余决策。它不会虚构产品行为、认证或数据规则、兼容性或发布策略。
对于短暂的独立运行,对话本身可作为状态。当需要恢复、嵌套操作或审计追踪时,持久化一个 Markdown 文件。嵌套父级提供唯一的状态路径;独立持久运行默认使用 docs/orchestration/light-compound-master/<run-id>.md。状态记录应保持最新,包含以下内容:运行 / 所有者 / 源基础 / 分配单元 / 当前阶段;范围、非目标、验收、依赖、未决决策;拥有的路径和实现方法;检查:确切命令、结果、候选修订、差距;评审:风险、需要时的独立参与者、修订、发现;状态:ready、needs-fix、blocked 或 release-ready;下一步行动;发布:范围/基础、已知 CI 差距、授权或交接状态。
已评审的现有工作包可以提供范围和验收事实;应链接而不是复制其内容。对于新的限定任务,记录的范围和方法即为执行简报。仅当存在未解决的决策或重大风险需要时,才与用户或相关专家评审简报。不要仅仅因为此技能处于活动状态就创建路线图、头脑风暴、计划、工作包和评审文档。
执行与验证
使用一个主要的实现者。仅在具有明确收益的独特专家、长时间限定单元或真正独立的工作流时才进行委派。给工作者确切的归属、验收标准、重点检查和停止条件。工作者不负责发布或更改 Jira。隔离并发的可变工作者,并保持重叠的认证、数据、迁移、公共契约、生成文件和依赖关系串行。
检查实际差异并运行重点检查。当变更涉及消费者、生成输出、迁移以及构建或类型检查时,检查这些方面。在最终候选上运行一次聚合或 CI 等效检查;仅当命令、基础和相关内容未变时复用通过的证据。记录任何仅 CI 的差距,而不预测通过。
评审深度取决于后果:
- 常规可逆工作:主代理最终差异评审。
- 重大行为或兼容性:一名独立评审员对变更差异和一个命名问题进行评审。
- 认证、隐私、密码学、数据完整性、迁移、公共契约、生产或研究证据完整性:专家评审加上对命名不变量的独立验证。在可用时,对安全敏感变更使用 krt-security-sentinel。
- 破坏性、不可逆、法律/合规或发布关键工作:协调针对不同风险的独立评审,并满足适用的批准门槛。
修复重大发现,运行其重点检查,并重新检查受影响的代码。仅在修复使先前证据失效或改变已评审的风险边界时,才重复聚合检查或评审。不要将失败或缺失的检查标记为通过。在有界尝试后报告阻塞,而不是在没有新信息的情况下循环。
嵌套在 Light Seneschal 下
接受 orchestrator:seneschal、稳定的运行 ID、唯一的状态路径、interaction:brokered、继承的倡议契约(如果存在)以及一个分配的路线图条目、工作包或评审单元。将工作限制在该目标上;不要启动同级运行或发布。将子状态视为其单元的规范状态,父级的运行记录视为投影。
在代理模式下,将有重大影响的决策请求返回给父级,包括问题、受影响的单元、证据、建议和安全回退。仅暂停受影响的工作,继续独立的本地工作。从倡议契约或其他规范制品中记录的决策恢复。返回状态路径、状态、更改的路径、候选修订、检查、评审结果、阻塞、同级影响和发布准备情况。父级检查差异、协调同级单元,并负责发布交接。
发布与权限
独立的发布就绪工作交给 krt-release-marshal;嵌套运行将其返回给 Light Seneschal。发布所有者处理提交、推送、PR、Jira 转换、评审者和合并。现有用户授权在其声明的范围内适用;对于缺乏授权的操作,需获得批准。本地实现权限不授予外部、破坏性或生产权限。对于无人值守的外部变更,使用规范的 Compound Master 自主账本和验证器;否则将操作记录为阻塞。