From feeff86829e854d0c32e5a05bb90f27643b4969e Mon Sep 17 00:00:00 2001 From: shunli Date: Sat, 16 May 2026 00:01:06 +0800 Subject: [PATCH] =?UTF-8?q?GOV8=20=E8=A1=A5=E5=85=85=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E5=A4=8D=E7=94=A8=E4=BC=98=E5=85=88=E7=BA=A6=E6=9D=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 3 ++- docs/开发交付与变更管理规约.md | 1 + docs/文档事实源状态矩阵.md | 2 +- docs/文档索引.md | 3 ++- 4 files changed, 6 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 995885f3..581b8803 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,7 @@ - **中文沟通**：默认使用中文回复；commit message 使用中文并引用 Issue ID。 - **项目 Skill 优先**：继续推进、试运行、视觉复核、报销/发票/OCR/附件、企业微信或部署类任务，优先使用 repo-scoped `.agents/skills/hyb-oa-delivery`。 - **设计事实源优先**：页面调整必须参考 `docs/产品设计规则.md`，并对齐公司主页 `www.hyinda.com` 的品牌风格。 +- **文档复用优先**：不轻易新建文档；优先更新现有事实源、模块规约、操作手册、证据文档或连续 Issue CSV。只有现有文档无法承载、需要独立审计证据或用户明确要求时，才新建文档，并同步登记 `docs/文档索引.md` 和 `docs/文档事实源状态矩阵.md`。 ## Tech & data - Backend: `server/`（Node.js + Fastify + Prisma + PostgreSQL）。 @@ -76,7 +77,7 @@ E2E loop = plan → issues(csv) → 方案批准 → implement → test → revi - 报销、发票、OCR、附件规则：`docs/报销发票附件规则.md` - 试运行与自动化验证：`docs/试运行与自动化验证手册.md` - 项目交付 Skill：`.agents/skills/hyb-oa-delivery/SKILL.md` -- DCL7 后文档中文优先；确认不用的历史文档从当前树删除，需要时通过 git 历史恢复，不维护 `docs/archive/`。 +- DCL7 后文档中文优先；优先复用已有文档，确认不用的历史文档从当前树删除，需要时通过 git 历史恢复，不维护 `docs/archive/`。 ## Safety - 不修复非当前 Issue 范围问题（可记录但不顺手改）。 diff --git a/docs/开发交付与变更管理规约.md b/docs/开发交付与变更管理规约.md index 4c55bdc3..0d84bcee 100644 --- a/docs/开发交付与变更管理规约.md +++ b/docs/开发交付与变更管理规约.md @@ -57,6 +57,7 @@ - 旧 Issue CSV 保留为历史审计证据，不删除、不批量回写、不移动到归档目录。 - 如果新治理流替代旧合同，只在新 CSV 的 `Notes` 或文档索引中说明 `supersedes`。 - 当前可执行合同只在 `docs/文档索引.md` 和 `docs/文档事实源状态矩阵.md` 中暴露，避免主入口被历史 Issue 淹没。 +- 文档类变更优先更新现有事实源、模块规约、操作手册、证据文档或当前连续 Issue CSV；只有现有文档无法承载、需要独立审计证据或用户明确要求时，才新建文档。 ### 2.2 需求冻结和变更请求 diff --git a/docs/文档事实源状态矩阵.md b/docs/文档事实源状态矩阵.md index 358b81fd..e90ea9d7 100644 --- a/docs/文档事实源状态矩阵.md +++ b/docs/文档事实源状态矩阵.md @@ -6,7 +6,7 @@ **关联 Issue**：`GOV8`。 **最近审计**：2026-05-13。 **不得误读**：本文登记文档权威性和状态，不替代具体 PRD、模块规约、测试规约或 Issue CSV。 -**治理口径**：中文优先，物理精简。历史资料不建 `docs/archive/`，已确认不用的文档从当前树移除，通过 git 历史恢复。 +**治理口径**：中文优先，物理精简，优先复用已有文档。历史资料不建 `docs/archive/`，已确认不用的文档从当前树移除，通过 git 历史恢复。 ## 冲突优先级 diff --git a/docs/文档索引.md b/docs/文档索引.md index 6c727d68..73e59dfd 100644 --- a/docs/文档索引.md +++ b/docs/文档索引.md @@ -6,7 +6,7 @@ **关联 Issue**：`GOV8`。 **最近审计**：2026-05-13。 **不得误读**：本文只指示当前事实源和读取顺序；历史 Issue CSV 只能用于追溯，不直接生成新开发任务。 -**治理口径**：中文优先，物理精简。已确认不用的历史文档不放 `docs/archive/`，直接从当前工作树移除；需要时从 git 历史恢复。 +**治理口径**：中文优先，物理精简，优先复用已有文档。已确认不用的历史文档不放 `docs/archive/`，直接从当前工作树移除；需要时从 git 历史恢复。 ## 读取规则 @@ -16,6 +16,7 @@ - 英文文件名只在技术生态或脚本强引用时保留，例如 `docs/mcp-tools.md`。 - 判断当前可执行任务：只读当前活跃治理流和对应连续型 Issue CSV；旧 Issue CSV 默认是历史审计证据。 - 新需求或试运行反馈：优先进入当前同类型连续治理流；只有跨业务域、跨风险等级或阶段收口后，才新建下一版 CSV。 +- 新增说明、方案、审计或证据：优先补充现有事实源、模块规约、操作手册、证据文档或当前连续 Issue CSV；只有现有文档无法承载、需要独立审计证据或用户明确要求时，才新建文档并登记本索引和事实源矩阵。 ## 最近事实源链