内容规范体系的组织方案与取舍
比较单文件、skill 自带规则、按职责分层和按读者分组的方案，说明采用依据、试用结果与仍未验证的效果。
核查于
本调研回答：在已有调研、专题、格式、发布和 Agent 协作流程的文档仓库中，研究方法、写作要求、质量标准、风格和专项怎样组织，才能明确执行范围与维护归属？比较结果支持采用按职责分层、通过共同入口组合专项的方案。这个结论针对 doc-test 的既有结构与任务需要，尚无数据证明它必然提高所有仓库的生产速度或读者理解效果。
研究范围与当前状态
研究于 2026-10-04 完成，以 Git HEAD 3c75cac9d5017a313862905d7e67744c462a4a69 及当时工作树为基线，读取五份指定材料，追溯原始或官方来源，并用代表性短案例作案头试用。检索针对问题展开，没有覆盖完整学术数据库，也没有执行正式系统综述。
2026-10-05，用户采用了统一入口、研究、通用写作、质量、单文件风格及两个专项；现行要求在 apps/site/docs/standards/ 维护，流程在 apps/site/docs/production.md，采用决定见 docs/adr/0011-content-production.md。规范采用和研究正文公开分别决定。
本次整理将成熟方法讲解归入专题研究、写作与知识表达，本文集中保留组织方案的比较、证据与局限。完整候选条款与已经完成的接入步骤不再另存正文；试用证据保留与本研究结论有关的案例条件、发现和历史检查范围。下文原研究执行均指 2026-10-04 的工作，整理没有重新实施那些实验或读者测试。
既有机制对选择的约束
研究时仓库已经具有生产流程、草稿发布边界、内容格式接口、项目 skills 和工程检查。主 Agent 负责研究、整合和交付，子 Agent 可以承担资料查找、比较和审阅。待补的内容集中在执行判断：证据怎样匹配主张，解释缺少什么，风格能调整到哪里，以及重要缺口怎样影响交付。
| 已有机制 | 组织方案需要保留的条件 |
|---|---|
| 生产、格式与授权分别维护 | 新规范接入现有入口，不复制另一套流程和授权 |
| 调研与专题独立成立，站内外材料平等引用 | 规范文件可以引用共同定义，文章仍承担完整解释 |
| skills 负责进入对应任务 | 方法条款有共同维护位置，避免各 skill 分别写一套规则 |
| 工程检查只约束技术格式与接口 | 证据充分、推理和理解判断由内容生产承担，不新增评分、字数或图数门禁 |
| 源文件派生导航、搜索和引用，过程材料按用途保留 | 通过源文件与 Git 管理修订，不建立永久加载或交接台账 |
这些是本仓库的设计约束。它们说明本次选择为何偏向分层，没有据此否定集中式手册在其他项目中的用途。
五份输入材料怎样参与判断
| 材料 | 可用信息及取得范围 | 对本次选择的作用 |
|---|---|---|
| 跨领域研究与写作指南的适用边界 | 原研究比较研究、写作与质量指南，并做搜索、过滤与规则适用性试用 | 提供共同要求的依据及跨领域限制；不直接继承统一阈值或完整草案 |
archive/foundations-to-project-documentation-2026-10-04.md | 未生效的项目讲解提案，无外部方法或读者效果数据 | 借用已有基础与机制联系；固定全局路径、每概念六步、每章例题等不作为通用要求 |
archive/architecture-documentation-plan-2026-10-03.md | 未生效的架构生产提案，工具方案未作实际对照验证 | 借用视图、实例、可编辑源和变更维护；工具、图数、首批产物与证据目录按具体需要选择 |
| 架构文档方法的比较与小型系统试用 | 方法来源、代码案例和历史技术检查 | 支持架构专项的对象、映射与维护职责；不能据检查宣称线上运行或真实读者理解 |
| 技术讲解方法的适用条件与证据 | 方法来源取得深度不一，含 Python/SQLite 历史运行与 HTTP 推导 | 支持机制、模型与知识依赖的专项职责；没有将“会编程”设为所有读者基础，也没有扩大摘要或推导范围 |
两份归档方案作为“曾提出什么”的材料使用，保持原位。独立研究、官方指南、规范文本、代码和实验各自支持不同性质的判断；材料的站内外归属不改变评价标准。
方法来源支持到哪里
原研究核对下列来源，用它们评价组织要求及跨领域边界。此处保留其在选择中的作用，具体研究、写作和专项的教学解释集中在专题中。
| 原始或官方资料 | 原研究核对的内容 | 能支持的取舍及限制 |
|---|---|---|
| ACM SIGSOFT Empirical Standards | General Standard、Systematic Reviews 的主张和方法要求 | 方法强度需要匹配所声称结果；普通调研不自动承担正式系统综述全部程序 |
| Cochrane Handbook 第 4 章 | 2025-03 版，重点 §4.4.11 的迭代与停止检索讨论 | 重复资料只能辅助判断停止，不能替代处理决定性材料；医疗干预证据的方法不整体移植 |
| PRISMA 2020 | 方法定位和适用说明 | 报告完整性与研究方法质量分开，不据报告清单固定本站正文栏目 |
| ODNI ICD 203 | 来源质量、假设、不确定性及替代解释 | 借用证据和判断的边界；不移植情报机构的管理、保密及概率用语体系 |
| Google Audience、长文组织 | 主题知识差距、任务、提纲与分层表达 | 读者基础应具体，解释顺序可调整；指南不能证明本站中文读者效果 |
| Google tone、Microsoft voice | 自然、清楚、与读者相适应的表达选择 | 风格可集中管理可变参数，品牌英语要求不成为中文固定口吻或句长规则 |
| AHRQ PEMAT | 工具导言及质量边界 | 可理解性、可行动性不能替代准确性或充分性，质量需分别判断 |
| W3C 复杂图片指南 | 图表重要信息的文字说明 | 文字表达与载体正确性属于共同要求；实际无障碍效果需要实际验证 |
| ISO/IEC/IEEE 42010:2022 官方摘要 | 版本与架构描述范围，未取得全文 | 支持区分架构描述与实现；不据摘要或旧问卷宣称全面符合 2022 标准 |
| C4 diagrams、arc42 building blocks、裁剪说明 | 视图、对象与关系、按需要使用方法 | 架构专项应覆盖特有关系；不把全套图或整个模板规定为本站必交内容 |
| SEI 架构文档审阅方法 | 2009 报告 §4 的目的与关注者问题 | 用于形成审阅问题；年代和标准版本限制其合规用途 |
原研究还核对了 Martínez、Mollica 与 Gibson 的英语合同表达实验及 CIAO 架构文档生成论文 §IV、§V-D、§VI。前者比较内容对应的英语合同表述，发现复杂表达影响理解与回忆；语言、材料和实验设计限制其推广到中文文档，探索性的单项语言特征分析也不能导出通用因果规则。后者 22 位熟悉自己仓库的开发者反馈及便利样本，不能证明新手真实任务表现或全部内容准确。这两项材料强化了效果主张需要相应证据的判断，没有导出固定文风或免核查的 Agent 流程。
比较四种组织方式
比较依据为本仓库实际需要：入口可发现、规则有明确维护位置、任务能组合、变化能定位。未进行生产耗时或长期维护成本的对照测量。
| 方案 | 在什么条件下有用 | 本仓库的主要负担 | 本次取舍 |
|---|---|---|---|
| 单一生产大文档 | 规则少，参与者经常需要整体阅读 | 流程、格式、方法和专项混排，局部变化难定位，所有任务读全部专项 | 已有生产与格式分层，继续拆清方法职责更合适 |
| 每个 skill 自带完整规则 | 任务相互独立，共同要求很少 | 同一研究和质量要求在多个入口复制，跨阶段容易分叉 | skill 保留任务操作，共同要求从统一入口引用 |
| 按职责维护共同规则，按需加载专项 | 多种任务共享依据和表达要求，同时有特有对象 | 需要说明职责、适用条件与引用，存在文件切换成本 | 推荐，与现有分层相接；同一次核查可用于多个判断 |
| 按初学者、专家或风格建立完整规则目录 | 读者和文体长期稳定，任务明确分众 | 角色不能充分描述知识差距，多读者任务与共同规则容易重复 | 风格集中单文件，读者基础按主题说明，专项按问题加载 |
因此采用研究、写作、质量、风格四份共同文件和按需专项。这里的优势来自维护关系分析，尚未测得 Agent 读取更快、遗漏更少或文章效果更好。
分层中的关键取舍
研究负责依据与充分性，写作负责连续解释，质量负责缺陷和交付判断。它们互相使用结果，完整要求只有一个维护位置。例如原文不可取得时，研究说明缺少什么及影响，质量据原任务承诺判断当前是否可交付，不再重复取得材料。
风格独立维护可变表达参数。术语准确、必要支撑和图表关系属于写作要求，不能随密度偏好删掉。本次定稿压缩了风格与写作的重复提醒，也让技术专项引用共同解释要求，聚焦状态、作用规则与保证边界。
检查失败另作性质判断：当前内容或实现导致的可修正错误继续处理；环境、权限或外部依赖阻断时，完成仍可执行的工作并准确说明可靠范围。受限交付不自动解除公开发布的技术检查与授权要求。
专项怎样裁剪和组合
技术讲解针对知识缺口、机制与模型，架构文档针对对象、边界、位置和跨视图映射。研究中的静态搜索案例需要同时说明系统参与者和查询位置，两个专项因此共用同一场景与代码核查。只讲架构职责时，无需把每个节点扩成完整机制教程。
专项默认补充共同要求。确需覆盖时，登记被覆盖条款、条件、替代要求和理由，经用户采用，同时保留真实性、证据匹配、主要解释完整和准确验证报告。本次两个专项没有登记覆盖项。该限制避免目录层级被误用为自动优先级。
试用结果与采用边界
原研究用方案比较、HTTP 幂等、静态搜索架构、双读者草稿过滤解释和资料不足的取消保证五类场景，检查能否定位缺陷、按条件组合及避免重复劳动。试用证据保存输入问题、发现、修改与限制，没有把构造短稿和 Agent 审阅写成真实读者测试。
案例促成了未知不等同较差、密度不能删除条件、视图不能混同运行与目录、受限交付要保留未完成目标等修订。原独立审阅进一步细化原文缺失的影响和技术条款的范围。采用时又精简重复、明确外部检查阻断及专项覆盖边界。
| 尚未解决的事项 | 对当前采用的影响 | 能改变判断的后续证据 |
|---|---|---|
| 中文读者理解、查找及误用 | 可以采用条件化方法，无法声称实际阅读效果已提高 | 经授权的代表读者与阅读任务结果 |
| 不同 Agent 的执行一致性和读取负担 | 统一入口与归属是设计选择，尚无客户端效果结果 | 经授权的实际客户端任务、遗漏与重复实例 |
| 长期生产成本、规则漂移 | 无长期耗时和同步数据 | 后续真实任务中的改动范围与具体缺陷，不默认增加过程台账 |
| 未取得的标准全文或论文部分 | 不采用全文未支持的细则或全面合规声明 | 明确任务需要时取得相应全文、版本和运行依据 |
现有来源比较和案头试用足以支持这次有限的组织建议，必要规则已由用户采用。目录效果与读者效果仍是开放问题，不能将采用决定或工程检查通过当作它们的实证答案。
最后更新于