Output Contract

当在本模板 bundle 内需持久化报告、并行子会话、或与多工作流产出对齐时使用。收录共用落盘 spec 与委派闭环;与 craft-authoring(/craft 撰写脚手架)无关。

haaaiawd 9b0ab3f 1.9 KB Updated

File contents

输出契约与协作闭环

各 Skill、Workflow 若重复本节条文,应改为一句引用本 Skill,仅保留角色或步骤专属增量。

何时加载

  • 撰写即将写入仓库的架构 / 审查 / 探索类 Markdown。
  • 父会话拆分并行子任务,或按路径切片协作修改。
  • 需要核对「是否可追溯、是否重复叙事、是否单写者」时。

Spec / 落盘契约

  • Precise:可核对陈述须带来源或 path:line / 章节锚点;禁止无源强结论。
  • Evidence-backed:发现 / 证据 / 建议须能指回具体输入或检索结果。
  • Non-repetitive:同一事实只写一次;禁止总述与正文两套复述。
  • No filler:禁止无主语的「需优化 / 应关注」类空话。

规范块(CRITICAL、严重度表、门禁、上下游契约)不得删;收紧仅针对执行旁白与重复叙事。

委派闭环(父子会话)

  1. 父会话TARGET_DIR、轮次、最终路径、合并顺序、对规范化报告路径的唯一写盘
  2. 子会话:有界切片;证据规则与父级相同。
  3. 交接:子代理返回可合并表结构 + 一行裁定;父代理去重、对照 spec、写 07_* / explore 报告,再跑工作流文末 completion

无委派时:单会话跑全文;父级仍负最终落盘与一致性。

并行与路径

  • 每个被管理路径(或 glob)每批最多一个写者;禁止在授权外全仓格式化。
  • 子任务目录或主题须 不相交;冲突由父代理裁决。
  • /genesis 协同时的检查清单与交接句式见 genesis.md「子代理编排与检查清单」(或 EN 树同名小节)。

haaaiawd/night-journal/tree/main/.opencode/skills/output-contract commit 9b0ab3fa0a

Frequently asked questions

npx skillmds@latest add haaaiawd/output-contract