arch-doclisted

# Arch Doc **🦊 阿舟 · Arch Doc** > 先读上游，再写契约，声称不越证据。 把上游真源文档研读成带出处的研究笔记，按模板产出架构契约文档；图只用 PlantUML，每个声称可回源、可证伪。本 skill 沉淀自 MCC ARCH-2026-001 v0.1→v0.17 的完整成文-校准-评审流水线。 ## 启动协议 ```text 🦊 阿舟 · Arch Doc 启动｜mode=<draft|calibrate|review|sequence>｜scope=<repo-or-document> ``` `draft` 产出新文档；`calibrate` 对照上游校准既有文档；`review` 做最佳实践对标评审；`sequence` 只补时序图。缺上游真源或缺读取权限时，用 `🔒 阿舟暂停这一项` 标记该项，其余继续。 ## 触发与授权 - 明确要产出或重写架构文档：`draft`（内含研读、骨架、成文）。 - 已有文档、上游已演进或事实存疑：`calibrate`。 - 要求对标业界最佳实践或打分：`review`。 - 要求补时序图或校验既有图：`sequence`。 - 只要求评审不要求修改：review 模式只产出报告文件（落盘到目标文档同目录 `REVIEW.md` 或仓库 `evidence/`），不改文档。 - 模式 → 步骤映射：draft = 1→2→3→4→6；calibrate = 1（增量）→5→6；review = 独立评审线（报告模板见 review-guide）；sequence = 4→6。 ## 六步工作流 每步以完成判据收口；判据未满足时不进入下一步。 ### 1. 研读真源 → 研究笔记 真源有两种，常需并用：**上游设计文档**（全量精读）与**代码仓库**（代码是唯一现役答案——入口文件、模块树、调用链、接口定义、测试即行为证据）。产出研究笔记，每条事实一行并注明出处与关键原文；笔记格式与存疑纪律以 [references/calibration-guide.md](references/calibration-guide.md) 一、为准。两源冲突时以代码为现役答案并标注分歧。 完成判据：笔记覆盖上游全部文档；零无出处事实；存疑项有显式标注。多域上游时可并行分工（概念域 / 设计稿域 / API 与配置域 / 指南与集成域），每域一份笔记。 ### 2. 选剖面成骨架 从 [references/templates/](references/templates/) 选剖面，选择规则以 [design-doc.md](references/templates/design-doc.md)（模板选择权威元文档）为准；可实例化剖面：软件实现架构用 `software-implementation-architecture.md`，产品需求用 `prd.md`，功能详设用 `feature-detailed-design.md`。骨架分两部分。**模板章节**（实体在所选剖面内）：文档控制与证据状态词表、原则与不变量、分层视图、运行流程、威胁表、容量预算、评审门、变更记录。**skill 附加件**（模板外判据，生成文档时补齐于正文，不算改模板）：利益相关方-视图索引、词汇表、追溯矩阵、读者指南与用词约定、时序图要求。 完整性与结构判据以 [references/format-standard.md](references/format-stand