# Output Contract

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

- Skill: `haaaiawd/output-contract` (Agent Skill)
- Install (CLI): `npx skillmds@latest add haaaiawd/output-contract`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haaaiawd/output-contract/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: haaaiawd (https://skillmd.com/u/haaaiawd)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/haaaiawd/output-contract

---


# 输出契约与协作闭环

> 各 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 树同名小节）。