docs: clarify governance reference authority
This commit is contained in:
Code Queue Review
@@ -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) 的指挥作风边界。 |
|
||||
|
||||
## 参考索引
|
||||
|
||||
| 主题 | 参考文档 |
|
||||
|
||||
@@ -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 说明、长期参考文档和用户可见说明必须中文优先，不能由英文主导。
|
||||
|
||||
## 适用范围
|
||||
|
||||
|
||||
@@ -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 规则
|
||||
|
||||
|
||||
@@ -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) 的醒目位置。
|
||||
|
||||
## 默认判定
|
||||
|
||||
|
||||
Reference in New Issue
Block a user