chengma/cmsp
2
0
Fork 0
Code Issues 18 Pull Requests Actions Packages Projects Releases Wiki Activity

升级 DevHarness 基线到 40b9938（语言规范 + PowerShell 命令约束） #1

New Issue
Closed
opened 2026-09-02 15:24:05 +08:00 by ila · 2 comments
ila commented 2026-09-02 15:24:05 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：重构（DevHarness 上游升级）
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：实施

依赖与并行

  • 前置工单：无
  • 是否允许与前置工单并行：是
  • 原因：本项目尚无其他进行中的工单，且本次只改流程规则与结构检查，不触碰产品代码。

子项目影响

  • 仅影响的子项目 / 交付单元：cmsp 桌面应用（单一交付单元）
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否
  • 各子项目需要执行的验证：python dev_scripts/harness.py check --strict、python -m unittest discover -s tests -v

原始需求

  • 来源：用户对话
  • 提出时间：2026-09-02
  • 关键原话或脱敏摘要：「"D:\OPC\dev_harness"更新了内容，你检查下是否适合本项目，如果适合也更新到当前项目」

要解决什么

本项目于 2026-09-02 以 DevHarness c13f6adb76c2ffbcae080dabf1df869a241e8f63 为基线接入。上游此后新增两个提交，均为通用 Agent 工作规则：

提交 标题 分类
90938be docs: 统一 Agent 中英文交流规范 (#31) 规则新增
40b9938 docs: 补充 Windows PowerShell 命令约束 (#28) 规则新增

两者都适用于 cmsp：本项目全程中文协作、大量涉及不可翻译的 API 字段名与错误码；运行环境为 Windows 10 + PowerShell。

升级不可拆分：dev_scripts/harness.py 的 CORE_DOCUMENT_REQUIREMENTS、check_agent_efficiency_rules 与 tests/test_harness_docs.py 的断言同步增加，工具、测试与文档必须一起升级，否则 check --strict 或单元测试必然失败。

做什么 / 不做什么

  • 做：升级 DevHarness 基线到 40b99387adc184274c43fda5f7efb3746642e27a；同步 AGENTS.md、dev_scripts/harness.py、tests/；在 Wiki 增补「语言与术语」和「PowerShell 语法与外部命令」两节，并补齐项目档案的运行环境版本；导出核心镜像。
  • 不做：不修改本项目已定制的项目专用规则（AGENTS.md 第 10 节）；不修改治理模式；不触碰任何产品代码或原型。

已确认方案

  1. AGENTS.md：以上游新版为基础重建，逐字保留本项目第 10 节「项目专用规则」。
  2. dev_scripts/harness.py、tests/test_harness_docs.py、tests/test_wiki_docs.py：整体替换为上游版本（本项目未定制这些文件）。
  3. Gitea Wiki 按事实来源顺序修改，再导出镜像：
    • Development-Workflow：整页替换为上游新版（本项目未定制该页）。
    • Local-Development-and-Verification：在「Windows PowerShell 与 UTF-8」下新增「PowerShell 语法与外部命令」子节，保留本项目已有的其余内容。
    • Project-Profile：运行环境补充 Windows 10、PowerShell 7 pwsh；更新 DevHarness 基线提交与升级日期。
  4. 顺序固定为：修改 Wiki → 在线回读确认 → harness.py sync 导出镜像 → 校验差异 → 提交。

预计修改文件：

  • AGENTS.md
  • dev_scripts/harness.py
  • tests/test_harness_docs.py
  • docs/01-workflow.md（镜像）
  • docs/04-local-development-and-verification.md（镜像）
  • docs/00-project-profile.md（镜像）

需求变化记录

日期 变化内容 原因 用户确认
无 是

设计与原型门禁

  • 修改类型：非 UI
  • 所需设计证据：无
  • 可编辑设计源、线上原型链接和访问检查：不适用
  • 审核版本、revision、复制版本或确认日期及识别方式：不适用
  • 本地 HTML 导出：未要求
  • 本地 HTML 路径、版本和资源检查：不适用
  • 状态：无
  • 确认人、确认时间和覆盖范围：不适用
  • 无需 UI 原型或无需任何原型的原因：本任务只改流程规则文档、结构检查工具与其单元测试，不产生任何用户可见界面变化。

文档影响

  • 更新项目档案或本地开发与验证
  • 更新其他 Wiki 页面：Development-Workflow

交付文档影响

  • 无交付文档影响，原因：本项目为内部工具，尚未确定外部交付对象，本次也不改变任何用户可见行为。

任务记录与可选快照

  • 单次任务事实来源：当前 Gitea 工单正文与评论
  • 默认不创建任务快照

验收标准

  • AGENTS.md 含「语言与术语」节，且第 10 节项目专用规则逐字保留
  • Wiki Development-Workflow 含「## 语言与术语」
  • Wiki Local-Development-and-Verification 含「### PowerShell 语法与外部命令」
  • Wiki Project-Profile 运行环境含 Windows 10 与 PowerShell 7 `pwsh` ，基线提交更新为 40b9938
  • python dev_scripts/harness.py check --strict 通过
  • python -m unittest discover -s tests -v 全部通过
  • 三个镜像页面的 revision 与线上一致

验证方式

python dev_scripts/harness.py check --strict
python -m unittest discover -s tests -v
python dev_scripts/harness.py sync --check

风险和回退

  • 风险：低。不涉及产品代码、凭据、数据迁移和不可逆操作。
  • 回退：git revert 本次两个提交，并把 Wiki 三页恢复到升级前 revision（记录在最终证据评论中）。
## 基本信息 - 类型：重构（DevHarness 上游升级） - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：实施 ## 依赖与并行 - 前置工单：无 - 是否允许与前置工单并行：是 - 原因：本项目尚无其他进行中的工单，且本次只改流程规则与结构检查，不触碰产品代码。 ## 子项目影响 - 仅影响的子项目 / 交付单元：cmsp 桌面应用（单一交付单元） - 是否跨子项目：否 - 是否修改共享接口或契约：否 - 各子项目需要执行的验证：`python dev_scripts/harness.py check --strict`、`python -m unittest discover -s tests -v` ## 原始需求 - 来源：用户对话 - 提出时间：2026-09-02 - 关键原话或脱敏摘要：「"D:\OPC\dev_harness"更新了内容，你检查下是否适合本项目，如果适合也更新到当前项目」 ## 要解决什么 本项目于 2026-09-02 以 DevHarness `c13f6adb76c2ffbcae080dabf1df869a241e8f63` 为基线接入。上游此后新增两个提交，均为通用 Agent 工作规则： | 提交 | 标题 | 分类 | |---|---|---| | `90938be` | docs: 统一 Agent 中英文交流规范 (#31) | 规则新增 | | `40b9938` | docs: 补充 Windows PowerShell 命令约束 (#28) | 规则新增 | 两者都适用于 cmsp：本项目全程中文协作、大量涉及不可翻译的 API 字段名与错误码；运行环境为 Windows 10 + PowerShell。 升级不可拆分：`dev_scripts/harness.py` 的 `CORE_DOCUMENT_REQUIREMENTS`、`check_agent_efficiency_rules` 与 `tests/test_harness_docs.py` 的断言同步增加，工具、测试与文档必须一起升级，否则 `check --strict` 或单元测试必然失败。 ## 做什么 / 不做什么 - 做：升级 DevHarness 基线到 `40b99387adc184274c43fda5f7efb3746642e27a`；同步 `AGENTS.md`、`dev_scripts/harness.py`、`tests/`；在 Wiki 增补「语言与术语」和「PowerShell 语法与外部命令」两节，并补齐项目档案的运行环境版本；导出核心镜像。 - 不做：不修改本项目已定制的项目专用规则（`AGENTS.md` 第 10 节）；不修改治理模式；不触碰任何产品代码或原型。 ## 已确认方案 1. `AGENTS.md`：以上游新版为基础重建，逐字保留本项目第 10 节「项目专用规则」。 2. `dev_scripts/harness.py`、`tests/test_harness_docs.py`、`tests/test_wiki_docs.py`：整体替换为上游版本（本项目未定制这些文件）。 3. Gitea Wiki 按事实来源顺序修改，再导出镜像： - `Development-Workflow`：整页替换为上游新版（本项目未定制该页）。 - `Local-Development-and-Verification`：在「Windows PowerShell 与 UTF-8」下新增「PowerShell 语法与外部命令」子节，保留本项目已有的其余内容。 - `Project-Profile`：运行环境补充 `Windows 10`、`PowerShell 7 pwsh`；更新 DevHarness 基线提交与升级日期。 4. 顺序固定为：修改 Wiki → 在线回读确认 → `harness.py sync` 导出镜像 → 校验差异 → 提交。 预计修改文件： - `AGENTS.md` - `dev_scripts/harness.py` - `tests/test_harness_docs.py` - `docs/01-workflow.md`（镜像） - `docs/04-local-development-and-verification.md`（镜像） - `docs/00-project-profile.md`（镜像） ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | | 无 | | 是 | ## 设计与原型门禁 - 修改类型：非 UI - 所需设计证据：无 - 可编辑设计源、线上原型链接和访问检查：不适用 - 审核版本、revision、复制版本或确认日期及识别方式：不适用 - 本地 HTML 导出：未要求 - 本地 HTML 路径、版本和资源检查：不适用 - 状态：无 - 确认人、确认时间和覆盖范围：不适用 - 无需 UI 原型或无需任何原型的原因：本任务只改流程规则文档、结构检查工具与其单元测试，不产生任何用户可见界面变化。 ## 文档影响 - [x] 更新项目档案或本地开发与验证 - [x] 更新其他 Wiki 页面：Development-Workflow ## 交付文档影响 - [x] 无交付文档影响，原因：本项目为内部工具，尚未确定外部交付对象，本次也不改变任何用户可见行为。 ## 任务记录与可选快照 - 单次任务事实来源：当前 Gitea 工单正文与评论 - [x] 默认不创建任务快照 ## 验收标准 - [ ] `AGENTS.md` 含「语言与术语」节，且第 10 节项目专用规则逐字保留 - [ ] Wiki `Development-Workflow` 含「## 语言与术语」 - [ ] Wiki `Local-Development-and-Verification` 含「### PowerShell 语法与外部命令」 - [ ] Wiki `Project-Profile` 运行环境含 `Windows 10` 与 ``PowerShell 7 `pwsh` ``，基线提交更新为 `40b9938` - [ ] `python dev_scripts/harness.py check --strict` 通过 - [ ] `python -m unittest discover -s tests -v` 全部通过 - [ ] 三个镜像页面的 revision 与线上一致 ## 验证方式 ```powershell python dev_scripts/harness.py check --strict python -m unittest discover -s tests -v python dev_scripts/harness.py sync --check ``` ## 风险和回退 - 风险：低。不涉及产品代码、凭据、数据迁移和不可逆操作。 - 回退：`git revert` 本次两个提交，并把 Wiki 三页恢复到升级前 revision（记录在最终证据评论中）。
ila commented 2026-09-02 15:26:59 +08:00
Author
Owner
Copy Link
Copy Source

最终证据

差异分类

上游提交 标题 分类 是否适用 cmsp
90938be docs: 统一 Agent 中英文交流规范 (#31) 规则新增 是。本项目全程中文协作，且涉及大量不可翻译的 API 字段名与错误码
40b9938 docs: 补充 Windows PowerShell 命令约束 (#28) 规则新增 是。运行环境为 Windows 10 + PowerShell

无删除、无重命名、无破坏性变更。上游未改动 wiki_docs.py 与 test_wiki_docs.py（复制后内容一致）。

基线

  • 旧：c13f6adb76c2ffbcae080dabf1df869a241e8f63
  • 新：40b99387adc184274c43fda5f7efb3746642e27a

最终差异

文件 处理方式
AGENTS.md 以上游新版重建，逐字保留本项目第 10 节「项目专用规则」
dev_scripts/harness.py 整体替换（本项目未定制）
tests/test_harness_docs.py 整体替换（本项目未定制）
docs/01-workflow.md Wiki 整页取上游后导出镜像
docs/04-local-development-and-verification.md Wiki 插入新子节，原有内容保留后导出镜像
docs/00-project-profile.md Wiki 更新运行环境与基线后导出镜像

Wiki revision

页面 升级前 升级后
Development-Workflow bbc3e4fa2319 bdde4b3aa643
Local-Development-and-Verification 62df45bceed4 c539cdacdad8
Project-Profile 31121357f505 851951b8efc7

测试结果（真实执行）

python dev_scripts/harness.py check --strict   -> DevHarness 检查通过
python -m unittest discover -s tests           -> Ran 55 tests, OK
python dev_scripts/harness.py sync             -> Wiki 镜像同步完成

测试数量从 53 增至 55，新增的两项正是上游 test_agents_and_workflow_share_language_policy
与 test_windows_shell_rules_avoid_bash_and_ripgrep_traps。

提交

  • 0e5a17f chore: 升级 DevHarness 基线到 40b9938 (#1)
  • c5c47f9 docs: 同步语言规范与 PowerShell 约束的 Wiki 镜像 (#1)

已推送到 origin/main。

未验证部分

  • 新增规则为 Agent 行为约束，无自动化手段验证其在后续任务中的实际遵守情况，只能在后续工单中观察。
  • 未验证 pwsh 7.3.12 之外的 PowerShell 版本；本项目档案只声明使用 PowerShell 7。

长期文档影响

已更新并同步上表三个 Wiki 页面。其余核心页面 sync 报告「无变化」。

状态置为待验收。

## 最终证据 ### 差异分类 | 上游提交 | 标题 | 分类 | 是否适用 cmsp | |---|---|---|---| | `90938be` | docs: 统一 Agent 中英文交流规范 (#31) | 规则新增 | 是。本项目全程中文协作，且涉及大量不可翻译的 API 字段名与错误码 | | `40b9938` | docs: 补充 Windows PowerShell 命令约束 (#28) | 规则新增 | 是。运行环境为 Windows 10 + PowerShell | 无删除、无重命名、无破坏性变更。上游未改动 `wiki_docs.py` 与 `test_wiki_docs.py`（复制后内容一致）。 ### 基线 - 旧：`c13f6adb76c2ffbcae080dabf1df869a241e8f63` - 新：`40b99387adc184274c43fda5f7efb3746642e27a` ### 最终差异 | 文件 | 处理方式 | |---|---| | `AGENTS.md` | 以上游新版重建，逐字保留本项目第 10 节「项目专用规则」 | | `dev_scripts/harness.py` | 整体替换（本项目未定制） | | `tests/test_harness_docs.py` | 整体替换（本项目未定制） | | `docs/01-workflow.md` | Wiki 整页取上游后导出镜像 | | `docs/04-local-development-and-verification.md` | Wiki 插入新子节，原有内容保留后导出镜像 | | `docs/00-project-profile.md` | Wiki 更新运行环境与基线后导出镜像 | ### Wiki revision | 页面 | 升级前 | 升级后 | |---|---|---| | Development-Workflow | `bbc3e4fa2319` | `bdde4b3aa643` | | Local-Development-and-Verification | `62df45bceed4` | `c539cdacdad8` | | Project-Profile | `31121357f505` | `851951b8efc7` | ### 测试结果（真实执行） ``` python dev_scripts/harness.py check --strict -> DevHarness 检查通过 python -m unittest discover -s tests -> Ran 55 tests, OK python dev_scripts/harness.py sync -> Wiki 镜像同步完成 ``` 测试数量从 53 增至 55，新增的两项正是上游 `test_agents_and_workflow_share_language_policy` 与 `test_windows_shell_rules_avoid_bash_and_ripgrep_traps`。 ### 提交 - `0e5a17f` chore: 升级 DevHarness 基线到 40b9938 (#1) - `c5c47f9` docs: 同步语言规范与 PowerShell 约束的 Wiki 镜像 (#1) 已推送到 `origin/main`。 ### 未验证部分 - 新增规则为 Agent 行为约束，无自动化手段验证其在后续任务中的实际遵守情况，只能在后续工单中观察。 - 未验证 `pwsh` 7.3.12 之外的 PowerShell 版本；本项目档案只声明使用 PowerShell 7。 ### 长期文档影响 已更新并同步上表三个 Wiki 页面。其余核心页面 `sync` 报告「无变化」。 状态置为**待验收**。
ila commented 2026-09-02 15:29:24 +08:00
Author
Owner
Copy Link
Copy Source

验收结论

  • 验收时间：2026-09-02
  • 验收人：项目负责人
  • 结论：通过

用户在对话中明确表示「#1 验收通过」。测试与提交证据见上一条评论，不重复抄写。

长期文档已在实施阶段同步，无新增 Wiki 变化。按默认规则不创建任务归档。

## 验收结论 - 验收时间：2026-09-02 - 验收人：项目负责人 - 结论：**通过** 用户在对话中明确表示「#1 验收通过」。测试与提交证据见上一条评论，不重复抄写。 长期文档已在实施阶段同步，无新增 Wiki 变化。按默认规则不创建任务归档。
ila closed this issue 2026-09-02 15:29:27 +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: chengma/cmsp#1