Files
Agent-System/configs/overlays/_shared/doc-structure.md
T
weichenandCursor b550911667 feat(squad): load rdev overlays and enforce document gates
Each rdev step now gets a role-filtered overlay so writing discipline stays out of the template. User needs, system requirements, review minutes, and upload indexes fail the quality gate when IDs, decisions, or attachment indexes are incomplete.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-19 10:12:10 +00:00

34 lines
1.9 KiB
Markdown

## 章节四段式(所有撰写与整合岗必读)
模板 `##` 章节是骨架,不是篇幅上限。每一节按以下顺序写满:
1. **结论句** — 本节对本项目的一句话含义。
2. **表格或列表** — 结构化事实;图表须标题;表格至少填已知行,确实无数据时写一行说明「为何为空」及待确认项。
3. **解读段落** — 解释表格/列表对本项目的含义,不要通篇只有列表。
4. **支撑明细或出处** — 数字写清口径、假设、来源与日期;能标出处的标〔…〕;无直接条文依据的分析保留并标「(分析判断,无直接条文依据)」。
禁止把模板括号提示原样留在终稿。
### 正文与附录顺序
1. 文首元数据(项目/时间/快照)与 `## 结论`
2. **正文**:只写文档主题章节(市场、场景、方案、风险等),内容充实详尽,**禁止**「不做展开」「从略」「不赘述」「篇幅有限」等省略套话
3. `## 待确认清单`
4. **文末附录**(可有可无):`阻塞信息` / `非阻塞信息` / `输入摘要` / `本阶段材料` / `说明` — 字段快照与材料清单放这里,不得挤占正文前部,也不得用字段表代替正文叙述
### role:writer
合并专员产出时,每个模板正文章节都要四段式写满;冲突事实并列列出;文末汇总全部「待确认」;字段表与材料清单仅作附录。
### role:leader
终稿审核:逐章检查四段式是否齐全;结论与后文是否打架;表格是否空壳;待确认是否已汇总。
### role:organizer
交给撰写岗的黑board/产出须含:事实清单、依据来源、待确认项、对本项目含义 — 让 writer 无需回看对话即可写稿。
### role:engineer
技术/工程输入须含:约束与假设、方案要点、风险与失效条件、对模板各章的建议映射。