OPC/dev_harness
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

增加轻量治理模式并缩减低风险项目门禁 #30

New Issue
Closed
opened 2026-09-02 10:07:23 +08:00 by ila · 3 comments
ila commented 2026-09-02 10:07:23 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 阶段：已完成
  • 原始需求来源：当前对话，2026-09-02
  • 关键需求摘要：使用 DevHarness 的其他项目主要是内部低风险项目，应尽量减少不必要的门禁和限制；保留真正必要的安全底线。
  • 前置工单：无
  • 是否允许并行：是；与待验收 #28 无内容依赖。
  • 设计证据：无 UI；采用已确认的三档治理规则。

目标

  • 增加轻量、标准、高风险三档项目治理模式。
  • 新建的内部、单人、低风险项目优先选择轻量模式。
  • 轻量模式允许小 Bug、小范围样式/布局、局部低风险行为调整直接实施，不强制工单或原型。
  • 完整独立需求、跨模块变化及中高风险修改继续建工单。
  • 测试和文档只做与真实影响相称的最小闭环。
  • 明确虚构测试数据无需形式化脱敏，真实个人数据仍不得进入代码、日志、工单、Wiki 和文档。

非目标

  • 不取消完整需求的确认与人工验收。
  • 不放宽密码、令牌、私钥、真实个人数据、生产数据和不可逆操作的安全底线。
  • 不强制低风险内部项目采用标准或高风险流程。
  • 不新增审批系统、配置解析器或自动策略引擎。
  • 不创建任务归档。

已确认方案

  1. 在项目档案记录治理模式和选择理由；内部、单人、低风险项目默认建议“轻量”。
  2. 共享 Agent 规则区分不可裁剪底线和按治理模式裁剪的工单、原型、测试、Wiki 门禁。
  3. 轻量模式：
    • 文案、注释、格式、局部样式、明确的小 Bug、单文件低风险调整可直接做；
    • 只执行受影响范围的最小测试；
    • 只有长期事实变化时更新 Wiki；
    • 只有完整独立需求、跨模块/API/数据结构/权限/安全/迁移或不确定变化才建工单；
    • 只有复杂新页面、重大交互或用户明确要求时才制作完整原型。
  4. 标准模式保留当前单元任务、设计证据和验收流程。
  5. 高风险模式按权限、安全、个人/生产数据、支付、迁移、并发、删除和不可逆操作增加人工确认与验证。
  6. 治理模式不得覆盖仓库上级安全规则；任务风险高于项目默认模式时按更高等级处理。
  7. 更新 Project-Profile、Development-Workflow、New-Project-Documentation-Setup Wiki，回读后增量同步镜像。
  8. 更新严格检查和测试，防止轻量模式退化为“无安全底线”。

影响范围

  • AGENTS.md
  • Gitea Wiki：Project-Profile、Development-Workflow、New-Project-Documentation-Setup
  • 对应本地核心镜像
  • dev_scripts/harness.py
  • tests/test_harness_docs.py
  • 按需调整任务模板的说明，不增加新的必填负担

风险与回退

  • 风险：轻量模式被误用于高风险任务；通过不可裁剪底线、任务风险升级规则控制。
  • 风险：治理模式描述过多反而增加阅读成本；共享规则只保留选择与执行摘要，细节放 Wiki。
  • 回退：恢复统一标准门禁；不涉及产品数据迁移或不可逆操作。

验证

  • python dev_scripts/harness.py check --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/harness.py sync --check
  • 场景核对：内部小 Bug、局部样式调整、完整独立需求、真实手机号、虚构手机号、权限/迁移任务。

文档影响

  • 更新上述三个长期 Wiki 页面并同步核心镜像。
  • AGENTS.md 作为共享 Agent 执行摘要。
  • CLAUDE.md 继续导入 AGENTS.md，不重复规则。
  • 默认不创建任务快照。

验收标准

  • 项目档案可明确选择轻量/标准/高风险模式及理由。
  • 内部低风险项目不再默认要求所有行为变化都建工单。
  • 轻量模式的小 Bug、局部 UI 和低风险单文件调整无需完整原型。
  • 完整独立需求和中高风险变化仍有清晰门禁。
  • 虚构数据与真实个人数据边界明确。
  • 只要求与风险相称的最小测试和长期文档更新。
  • Codex 与 Claude Code 通过共享规则得到一致行为。
  • 严格检查、单元测试和 Wiki 镜像检查通过。
  • 提交推送并回写证据，工单保持待验收。
## 基本信息 - 类型：单元任务 - 阶段：已完成 - 原始需求来源：当前对话，2026-09-02 - 关键需求摘要：使用 DevHarness 的其他项目主要是内部低风险项目，应尽量减少不必要的门禁和限制；保留真正必要的安全底线。 - 前置工单：无 - 是否允许并行：是；与待验收 #28 无内容依赖。 - 设计证据：无 UI；采用已确认的三档治理规则。 ## 目标 - 增加轻量、标准、高风险三档项目治理模式。 - 新建的内部、单人、低风险项目优先选择轻量模式。 - 轻量模式允许小 Bug、小范围样式/布局、局部低风险行为调整直接实施，不强制工单或原型。 - 完整独立需求、跨模块变化及中高风险修改继续建工单。 - 测试和文档只做与真实影响相称的最小闭环。 - 明确虚构测试数据无需形式化脱敏，真实个人数据仍不得进入代码、日志、工单、Wiki 和文档。 ## 非目标 - 不取消完整需求的确认与人工验收。 - 不放宽密码、令牌、私钥、真实个人数据、生产数据和不可逆操作的安全底线。 - 不强制低风险内部项目采用标准或高风险流程。 - 不新增审批系统、配置解析器或自动策略引擎。 - 不创建任务归档。 ## 已确认方案 1. 在项目档案记录治理模式和选择理由；内部、单人、低风险项目默认建议“轻量”。 2. 共享 Agent 规则区分不可裁剪底线和按治理模式裁剪的工单、原型、测试、Wiki 门禁。 3. 轻量模式： - 文案、注释、格式、局部样式、明确的小 Bug、单文件低风险调整可直接做； - 只执行受影响范围的最小测试； - 只有长期事实变化时更新 Wiki； - 只有完整独立需求、跨模块/API/数据结构/权限/安全/迁移或不确定变化才建工单； - 只有复杂新页面、重大交互或用户明确要求时才制作完整原型。 4. 标准模式保留当前单元任务、设计证据和验收流程。 5. 高风险模式按权限、安全、个人/生产数据、支付、迁移、并发、删除和不可逆操作增加人工确认与验证。 6. 治理模式不得覆盖仓库上级安全规则；任务风险高于项目默认模式时按更高等级处理。 7. 更新 Project-Profile、Development-Workflow、New-Project-Documentation-Setup Wiki，回读后增量同步镜像。 8. 更新严格检查和测试，防止轻量模式退化为“无安全底线”。 ## 影响范围 - `AGENTS.md` - Gitea Wiki：Project-Profile、Development-Workflow、New-Project-Documentation-Setup - 对应本地核心镜像 - `dev_scripts/harness.py` - `tests/test_harness_docs.py` - 按需调整任务模板的说明，不增加新的必填负担 ## 风险与回退 - 风险：轻量模式被误用于高风险任务；通过不可裁剪底线、任务风险升级规则控制。 - 风险：治理模式描述过多反而增加阅读成本；共享规则只保留选择与执行摘要，细节放 Wiki。 - 回退：恢复统一标准门禁；不涉及产品数据迁移或不可逆操作。 ## 验证 - `python dev_scripts/harness.py check --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/harness.py sync --check` - 场景核对：内部小 Bug、局部样式调整、完整独立需求、真实手机号、虚构手机号、权限/迁移任务。 ## 文档影响 - 更新上述三个长期 Wiki 页面并同步核心镜像。 - AGENTS.md 作为共享 Agent 执行摘要。 - CLAUDE.md 继续导入 AGENTS.md，不重复规则。 - 默认不创建任务快照。 ## 验收标准 - [ ] 项目档案可明确选择轻量/标准/高风险模式及理由。 - [ ] 内部低风险项目不再默认要求所有行为变化都建工单。 - [ ] 轻量模式的小 Bug、局部 UI 和低风险单文件调整无需完整原型。 - [ ] 完整独立需求和中高风险变化仍有清晰门禁。 - [ ] 虚构数据与真实个人数据边界明确。 - [ ] 只要求与风险相称的最小测试和长期文档更新。 - [ ] Codex 与 Claude Code 通过共享规则得到一致行为。 - [ ] 严格检查、单元测试和 Wiki 镜像检查通过。 - [ ] 提交推送并回写证据，工单保持待验收。
ila commented 2026-09-02 10:10:07 +08:00
Author
Owner
Copy Link
Copy Source

实施中发现现有 Business-Rules-and-Glossary、Product-Requirements-Overview 和 README 仍写有“单元任务是唯一正式实施单位”“所有行为变化必须建单”等旧规则，会直接抵消轻量模式。为保持已确认目标一致，文档影响范围补充这两个 Wiki 页面及 README；只删除冲突门禁，不增加新流程。

实施中发现现有 Business-Rules-and-Glossary、Product-Requirements-Overview 和 README 仍写有“单元任务是唯一正式实施单位”“所有行为变化必须建单”等旧规则，会直接抵消轻量模式。为保持已确认目标一致，文档影响范围补充这两个 Wiki 页面及 README；只删除冲突门禁，不增加新流程。
ila commented 2026-09-02 10:15:50 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据

  • 状态：待验收
  • 提交：
    • fe795c4：增加轻量/标准/高风险治理模式、共享 Agent 规则和初始化入口；
    • c13f6ad：清理与轻量模式冲突的旧门禁并补充防回退测试。
  • 两次提交均已推送到 origin/main，当前 HEAD/远端 main：c13f6adb76c2ffbcae080dabf1df869a241e8f63。
  • 核心结果：
    • 内部、单人、低风险项目优先选择轻量模式；
    • 明确小 Bug、局部 UI、单模块低风险调整可直接实施，不补建工单、不制作完整原型；
    • 完整独立需求、新页面、跨模块/API/数据/权限/安全/迁移或不确定变化仍必须建单；
    • 虚构手机号等测试数据无需形式化脱敏，真实或来源不明的个人数据仍受不可裁剪保护；
    • 测试和文档只做与真实影响相称的最小闭环；
    • Claude Code 继续通过 @AGENTS.md 与 Codex 共用相同规则。
  • 测试：python -m unittest discover -s tests -v，53 项全部通过。
  • 结构检查：python dev_scripts/harness.py check --strict，通过。
  • Wiki 镜像：python dev_scripts/harness.py sync --check，15 个核心页面一致。
  • 长期 Wiki revisions：
    • Project-Profile：5323a382fc19433c19441587120d5a0ee6447a24
    • Development-Workflow：b82dc79b2d74b83c4e255600beceb7c1e292c9a4
    • Business-Rules-and-Glossary：0f860d9e97c0cdc7d2253a3f013d24fd8bd02609
    • New-Project-Documentation-Setup：e35a6ef160d21ddfeb043860d85fc8074bcc26fa
    • Product-Requirements-Overview：60a169e4e8e3c396c4c4c35544be48a17548d19c
  • 工作区干净，未创建或导出任务归档。
  • 未验证：尚未在另一个实际业务仓库执行一次 DevHarness 升级；本仓库规则、镜像和自动检查已完成。

请按工单验收标准验收；工单保持开启，等待人工验收。

## 最终实施证据 - 状态：待验收 - 提交： - `fe795c4`：增加轻量/标准/高风险治理模式、共享 Agent 规则和初始化入口； - `c13f6ad`：清理与轻量模式冲突的旧门禁并补充防回退测试。 - 两次提交均已推送到 `origin/main`，当前 HEAD/远端 main：`c13f6adb76c2ffbcae080dabf1df869a241e8f63`。 - 核心结果： - 内部、单人、低风险项目优先选择轻量模式； - 明确小 Bug、局部 UI、单模块低风险调整可直接实施，不补建工单、不制作完整原型； - 完整独立需求、新页面、跨模块/API/数据/权限/安全/迁移或不确定变化仍必须建单； - 虚构手机号等测试数据无需形式化脱敏，真实或来源不明的个人数据仍受不可裁剪保护； - 测试和文档只做与真实影响相称的最小闭环； - Claude Code 继续通过 `@AGENTS.md` 与 Codex 共用相同规则。 - 测试：`python -m unittest discover -s tests -v`，53 项全部通过。 - 结构检查：`python dev_scripts/harness.py check --strict`，通过。 - Wiki 镜像：`python dev_scripts/harness.py sync --check`，15 个核心页面一致。 - 长期 Wiki revisions： - Project-Profile：`5323a382fc19433c19441587120d5a0ee6447a24` - Development-Workflow：`b82dc79b2d74b83c4e255600beceb7c1e292c9a4` - Business-Rules-and-Glossary：`0f860d9e97c0cdc7d2253a3f013d24fd8bd02609` - New-Project-Documentation-Setup：`e35a6ef160d21ddfeb043860d85fc8074bcc26fa` - Product-Requirements-Overview：`60a169e4e8e3c396c4c4c35544be48a17548d19c` - 工作区干净，未创建或导出任务归档。 - 未验证：尚未在另一个实际业务仓库执行一次 DevHarness 升级；本仓库规则、镜像和自动检查已完成。 请按工单验收标准验收；工单保持开启，等待人工验收。
ila commented 2026-09-04 14:51:10 +08:00
Author
Owner
Copy Link
Copy Source

验收结论

  • 验收时间：2026-09-04（Asia/Shanghai）
  • 结论：用户明确表示所有已完成实施并处于待验收的工单通过验收，本工单包含在该范围内。
  • 最终实施、提交、测试和文档影响证据已记录在上一条最终证据评论中。
  • 本次验收没有新的长期事实变化，因此不重复更新或同步 Wiki。
  • 父工单：无。
  • 任务快照：未创建、未导出。

验收闭环完成，关闭工单。

## 验收结论 - 验收时间：2026-09-04（Asia/Shanghai） - 结论：用户明确表示所有已完成实施并处于待验收的工单通过验收，本工单包含在该范围内。 - 最终实施、提交、测试和文档影响证据已记录在上一条最终证据评论中。 - 本次验收没有新的长期事实变化，因此不重复更新或同步 Wiki。 - 父工单：无。 - 任务快照：未创建、未导出。 验收闭环完成，关闭工单。
ila closed this issue 2026-09-04 14:51:11 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/dev_harness#30