diff --git a/docs/reference/README.md b/docs/reference/README.md index 34366c50..216488e3 100644 --- a/docs/reference/README.md +++ b/docs/reference/README.md @@ -2,6 +2,15 @@ `docs/reference/` 是 HWLAB agent、指挥官和 runner 的长期参考目录，只记录长期稳定、可复用的规则、边界、入口、命令和验收标准。issue、日报、简报、一次性报告和执行流水账只能作为来源，不混入长期参考文档。 +## 权威分工 + +| 规则 | 唯一权威出处 | 边界 | +| --- | --- | --- | +| `docs-spec` 使用、长期参考入库和过程文档蒸馏 | [documentation-governance.md](documentation-governance.md) | 其他 reference 只交叉引用，不另写一套文档治理规则。 | +| 中文优先的 issue、PR 和文档规则 | [chinese-first-documentation.md](chinese-first-documentation.md) | 英文标识可保真，解释、约束和验收口径必须中文化。 | +| 用户和参谋反馈默认高优先级分流 | [user-feedback-triage.md](user-feedback-triage.md) | `blocked`、等待上游或环境限制只描述状态，不能替代反馈优先级。 | +| 指挥官一手事实、真实推进和 PR 协作边界 | [commander-collaboration.md](commander-collaboration.md) | 本目录的文档治理规则不覆盖 [pikasTech/HWLAB#131](https://github.com/pikasTech/HWLAB/issues/131) 的指挥作风边界。 | + ## 参考索引 | 主题 | 参考文档 | diff --git a/docs/reference/chinese-first-documentation.md b/docs/reference/chinese-first-documentation.md index f4916fca..480dbcb7 100644 --- a/docs/reference/chinese-first-documentation.md +++ b/docs/reference/chinese-first-documentation.md @@ -1,6 +1,6 @@ # HWLAB 中文优先文档规则 -本规则固化 [pikasTech/HWLAB#121](https://github.com/pikasTech/HWLAB/issues/121) 的要求：HWLAB issue、PR 说明、长期参考文档和用户可见说明必须中文优先，不能由英文主导。 +本规则固化 [pikasTech/HWLAB#121](https://github.com/pikasTech/HWLAB/issues/121) 的要求，是 HWLAB 中文优先规则的唯一维护处：HWLAB issue、PR 说明、长期参考文档和用户可见说明必须中文优先，不能由英文主导。 ## 适用范围 diff --git a/docs/reference/documentation-governance.md b/docs/reference/documentation-governance.md index 6d1a7136..e74de27d 100644 --- a/docs/reference/documentation-governance.md +++ b/docs/reference/documentation-governance.md @@ -1,6 +1,8 @@ # HWLAB 文档治理与 docs-spec 入库规则 -本文是 HWLAB 仓库内固化的 `docs-spec` 规则副本和可执行摘要。编辑 `AGENTS.md`、`docs/reference/*.md` 或把过程记录蒸馏为长期参考时，必须先按本文执行；如果 runner 能读取外部 `docs-spec` skill，也要以本文作为 HWLAB 本地权威落点。 +本文是 HWLAB 仓库内固化的 `docs-spec` 规则副本和可执行摘要，也是本仓库唯一维护 `docs-spec` 使用规则的长期参考。编辑 `AGENTS.md`、`docs/reference/*.md` 或把过程记录蒸馏为长期参考时，必须先按本文执行；如果 runner 能读取外部 `docs-spec` skill，也要以本文作为 HWLAB 本地权威落点。 + +中文优先规则只在 [chinese-first-documentation.md](chinese-first-documentation.md) 维护，用户和参谋反馈分流规则只在 [user-feedback-triage.md](user-feedback-triage.md) 维护。本文只交叉引用这些规则，不替代 [commander-collaboration.md](commander-collaboration.md) 中由 [pikasTech/HWLAB#131](https://github.com/pikasTech/HWLAB/issues/131) 固化的一手事实和真实推进边界。 ## AGENTS.md 规则 diff --git a/docs/reference/user-feedback-triage.md b/docs/reference/user-feedback-triage.md index 9ed6b362..46acc04e 100644 --- a/docs/reference/user-feedback-triage.md +++ b/docs/reference/user-feedback-triage.md @@ -1,6 +1,6 @@ # HWLAB 用户反馈分流规则 -本规则固化 [pikasTech/HWLAB#122](https://github.com/pikasTech/HWLAB/issues/122)：用户和参谋提出的问题默认按高优先级用户反馈处理，并必须挂到 [pikasTech/HWLAB#7](https://github.com/pikasTech/HWLAB/issues/7) 的醒目位置。 +本规则固化 [pikasTech/HWLAB#122](https://github.com/pikasTech/HWLAB/issues/122)，是 HWLAB 用户反馈分流规则的唯一维护处：用户和参谋提出的问题默认按高优先级用户反馈处理，并必须挂到 [pikasTech/HWLAB#7](https://github.com/pikasTech/HWLAB/issues/7) 的醒目位置。 ## 默认判定