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

统一 Gitea MCP 优先与工单增量读取规则 #26

New Issue
Closed
opened 2026-08-25 10:10:02 +08:00 by ila · 2 comments
ila commented 2026-08-25 10:10:02 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 阶段：已完成
  • 原始需求来源：当前对话，2026-08-25
  • 关键需求摘要：用户确认按建议补充“所有 Gitea 操作统一 MCP 优先”和“工单条件式增量读取”。
  • 前置工单：无
  • 是否允许并行：是；本任务不依赖仍待验收的 #25 结果，且只补充独立的交互优先级和读取边界。
  • 设计证据：无 UI；采用已确认的流程文字方案。

目标

  • 将 Gitea MCP 优先、API 回退的规则从 Wiki 初始化扩展到日常工单和 Wiki 操作。
  • 规定首次接手、同会话继续、会话或远端状态变化时的最小读取边界，减少重复分析。
  • 保持连接器能力诚实：不承诺当前 MCP 不支持的评论分页或增量传输。

非目标

  • 不新增本地工单、缓存、索引、包装脚本或 Gitea 客户端。
  • 不修改 Gitea MCP、API 或现有 archive/export 行为。
  • 不改变工单、原型、安全、测试、验收和 Wiki 主源门禁。
  • 不回溯改写历史工单或历史归档。

已确认方案

  1. 在 Agent 全局规则和开发工作流中统一规定：所有 Gitea 工单和 Wiki 查询、创建、更新、评论、状态变更及关闭操作优先使用项目配置的 Gitea MCP；MCP 不可用或不支持所需操作时才回退 API，并在当前工单记录原因。
  2. 首次接手任务读取确认基线和必要评论；同一任务、同一会话复用仍有效事实，优先关注最新状态、最新评论和首个未完成步骤。
  3. 会话、代码、配置、依赖、凭据、远端状态或关键前提变化，基线不清楚，或评论声明历史需求变化时，重新读取必要历史或完整工单。
  4. 连接器不支持增量读取时允许读取全文，但不得重复分析仍有效内容。
  5. 同步更新 Wiki 开发工作流和必要入口；本地 docs 仅由 Wiki 导出。
  6. 用严格结构检查固定关键规则，不新增运行时代码。

影响范围

  • 仓库规则：AGENTS.md
  • 长期文档：Development-Workflow，按需更新 Home/Project-Profile
  • 本地镜像：对应 docs/
  • Harness 严格检查和测试：仅增加必要规则断言

风险与回退

  • 风险：把“优先读取最新内容”误解为跳过任务基线或重要历史。
  • 控制：明确触发完整回读的条件，并以正确性、安全和已确认范围优先。
  • 回退：恢复原有读取措辞；不涉及数据迁移、接口或历史删除。

验证

  • python dev_scripts/harness.py check --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/harness.py sync --check
  • 文字场景检查：首次接手、同会话继续、会话变化、MCP 不支持增量读取、MCP 不可用回退 API。

文档影响

  • 更新 Development-Workflow。
  • 更新必要的 Home 或项目档案入口（仅在长期事实确需补充时）。
  • 不创建任务快照。

验收标准

  • 日常工单和 Wiki 的全部 Gitea 操作均明确 MCP 优先、API 有条件回退。
  • API 回退原因要求记录在当前工单。
  • 首次读取、复用、重新完整读取和连接器不支持增量读取的边界明确。
  • 不新增本地缓存、包装脚本或第二事实来源。
  • Codex 与 Claude Code 通过共享规则获得一致行为。
  • 严格检查、单元测试和 Wiki 镜像一致性检查通过。
  • 提交推送并回写最终证据，工单保持待验收。
## 基本信息 - 类型：单元任务 - 阶段：已完成 - 原始需求来源：当前对话，2026-08-25 - 关键需求摘要：用户确认按建议补充“所有 Gitea 操作统一 MCP 优先”和“工单条件式增量读取”。 - 前置工单：无 - 是否允许并行：是；本任务不依赖仍待验收的 #25 结果，且只补充独立的交互优先级和读取边界。 - 设计证据：无 UI；采用已确认的流程文字方案。 ## 目标 - 将 Gitea MCP 优先、API 回退的规则从 Wiki 初始化扩展到日常工单和 Wiki 操作。 - 规定首次接手、同会话继续、会话或远端状态变化时的最小读取边界，减少重复分析。 - 保持连接器能力诚实：不承诺当前 MCP 不支持的评论分页或增量传输。 ## 非目标 - 不新增本地工单、缓存、索引、包装脚本或 Gitea 客户端。 - 不修改 Gitea MCP、API 或现有 archive/export 行为。 - 不改变工单、原型、安全、测试、验收和 Wiki 主源门禁。 - 不回溯改写历史工单或历史归档。 ## 已确认方案 1. 在 Agent 全局规则和开发工作流中统一规定：所有 Gitea 工单和 Wiki 查询、创建、更新、评论、状态变更及关闭操作优先使用项目配置的 Gitea MCP；MCP 不可用或不支持所需操作时才回退 API，并在当前工单记录原因。 2. 首次接手任务读取确认基线和必要评论；同一任务、同一会话复用仍有效事实，优先关注最新状态、最新评论和首个未完成步骤。 3. 会话、代码、配置、依赖、凭据、远端状态或关键前提变化，基线不清楚，或评论声明历史需求变化时，重新读取必要历史或完整工单。 4. 连接器不支持增量读取时允许读取全文，但不得重复分析仍有效内容。 5. 同步更新 Wiki 开发工作流和必要入口；本地 docs 仅由 Wiki 导出。 6. 用严格结构检查固定关键规则，不新增运行时代码。 ## 影响范围 - 仓库规则：`AGENTS.md` - 长期文档：Development-Workflow，按需更新 Home/Project-Profile - 本地镜像：对应 `docs/` - Harness 严格检查和测试：仅增加必要规则断言 ## 风险与回退 - 风险：把“优先读取最新内容”误解为跳过任务基线或重要历史。 - 控制：明确触发完整回读的条件，并以正确性、安全和已确认范围优先。 - 回退：恢复原有读取措辞；不涉及数据迁移、接口或历史删除。 ## 验证 - `python dev_scripts/harness.py check --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/harness.py sync --check` - 文字场景检查：首次接手、同会话继续、会话变化、MCP 不支持增量读取、MCP 不可用回退 API。 ## 文档影响 - 更新 Development-Workflow。 - 更新必要的 Home 或项目档案入口（仅在长期事实确需补充时）。 - 不创建任务快照。 ## 验收标准 - [ ] 日常工单和 Wiki 的全部 Gitea 操作均明确 MCP 优先、API 有条件回退。 - [ ] API 回退原因要求记录在当前工单。 - [ ] 首次读取、复用、重新完整读取和连接器不支持增量读取的边界明确。 - [ ] 不新增本地缓存、包装脚本或第二事实来源。 - [ ] Codex 与 Claude Code 通过共享规则获得一致行为。 - [ ] 严格检查、单元测试和 Wiki 镜像一致性检查通过。 - [ ] 提交推送并回写最终证据，工单保持待验收。
ila commented 2026-08-25 10:16:41 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据（待验收）

完成内容

  • 所有 Gitea 工单和 Wiki 的查询、创建、更新、评论、状态变更及关闭操作，统一为项目已配置的 Gitea MCP 优先。
  • MCP 不可用或不支持所需操作时才回退 Gitea API，并要求在当前工单记录原因；没有正式工单的初始化阶段先写草稿，建单后补回。
  • 首次接手读取确认基线和必要评论；同一任务、同一会话优先关注当前状态、最新评论和首个未完成步骤。
  • 明确会话、代码、配置、依赖、凭据、远端状态、关键前提或任务基线变化时重新读取必要历史；无法判断影响范围时读取完整工单。
  • 连接器不支持分页或增量读取时允许读取全文，但不重复分析有效历史，也不新增本地工单、缓存、包装脚本或第二事实来源。
  • Codex 通过 AGENTS.md、Claude Code 通过共享规则入口获得相同行为。
  • 更新 Development-Workflow，并在 Product-Requirements-Overview 登记 #26；本地 docs/ 已由 Wiki 单向同步。

提交

  • 384bf01 — 统一 Gitea MCP 与工单读取规则，增加严格检查和测试。
  • c0b8013 — 登记 Gitea 交互优化工单到需求总览。

均已推送到 origin/main。

验证

  • python dev_scripts/harness.py check --strict：通过。
  • python -m unittest discover -s tests -v：45/45 通过。
  • python dev_scripts/harness.py sync --check：15 个核心镜像一致。
  • 场景文字检查：首次接手、同会话继续、关键前提变化、MCP 不支持增量读取、MCP 回退 API 均有明确边界。
  • 未验证：未修改 Gitea MCP/API 实现，不承诺连接器层面的分页或传输 Token 减少。

Wiki 证据

  • Development-Workflow：a734572c091a1210c03a41925c21f90980439973
  • Product-Requirements-Overview：f14a309835d7608cf684ae76a92136ba558635c1

文档和快照

  • 长期文档影响：已更新上述两个 Wiki 页面并同步核心镜像。
  • 按默认规则未创建或导出任务快照。

当前阶段：待验收。工单保持开启，等待用户明确验收。

## 最终实施证据（待验收） ### 完成内容 - 所有 Gitea 工单和 Wiki 的查询、创建、更新、评论、状态变更及关闭操作，统一为项目已配置的 Gitea MCP 优先。 - MCP 不可用或不支持所需操作时才回退 Gitea API，并要求在当前工单记录原因；没有正式工单的初始化阶段先写草稿，建单后补回。 - 首次接手读取确认基线和必要评论；同一任务、同一会话优先关注当前状态、最新评论和首个未完成步骤。 - 明确会话、代码、配置、依赖、凭据、远端状态、关键前提或任务基线变化时重新读取必要历史；无法判断影响范围时读取完整工单。 - 连接器不支持分页或增量读取时允许读取全文，但不重复分析有效历史，也不新增本地工单、缓存、包装脚本或第二事实来源。 - Codex 通过 `AGENTS.md`、Claude Code 通过共享规则入口获得相同行为。 - 更新 Development-Workflow，并在 Product-Requirements-Overview 登记 #26；本地 `docs/` 已由 Wiki 单向同步。 ### 提交 - `384bf01` — 统一 Gitea MCP 与工单读取规则，增加严格检查和测试。 - `c0b8013` — 登记 Gitea 交互优化工单到需求总览。 均已推送到 `origin/main`。 ### 验证 - `python dev_scripts/harness.py check --strict`：通过。 - `python -m unittest discover -s tests -v`：45/45 通过。 - `python dev_scripts/harness.py sync --check`：15 个核心镜像一致。 - 场景文字检查：首次接手、同会话继续、关键前提变化、MCP 不支持增量读取、MCP 回退 API 均有明确边界。 - 未验证：未修改 Gitea MCP/API 实现，不承诺连接器层面的分页或传输 Token 减少。 ### Wiki 证据 - Development-Workflow：`a734572c091a1210c03a41925c21f90980439973` - Product-Requirements-Overview：`f14a309835d7608cf684ae76a92136ba558635c1` ### 文档和快照 - 长期文档影响：已更新上述两个 Wiki 页面并同步核心镜像。 - 按默认规则未创建或导出任务快照。 当前阶段：**待验收**。工单保持开启，等待用户明确验收。
ila commented 2026-08-25 10:24:36 +08:00
Author
Owner
Copy Link
Copy Source

验收结论

  • 验收时间：2026-08-25（Asia/Shanghai）
  • 结论：用户明确表示 #26 验收通过。
  • 长期需求状态：已在 Product-Requirements-Overview 更新为“已交付”，revision e9e0ebafd9189ae911094e615595a5e464e5e59b。
  • 镜像提交：19fb64b，已推送到 origin/main。
  • Wiki 镜像检查：15 个核心页面一致。
  • 父工单：无。
  • 任务快照：未新建、未导出；已有历史快照继续作为兼容证据，单次任务事实以本工单为准。

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

## 验收结论 - 验收时间：2026-08-25（Asia/Shanghai） - 结论：用户明确表示 #26 验收通过。 - 长期需求状态：已在 Product-Requirements-Overview 更新为“已交付”，revision `e9e0ebafd9189ae911094e615595a5e464e5e59b`。 - 镜像提交：`19fb64b`，已推送到 `origin/main`。 - Wiki 镜像检查：15 个核心页面一致。 - 父工单：无。 - 任务快照：未新建、未导出；已有历史快照继续作为兼容证据，单次任务事实以本工单为准。 验收闭环完成，关闭工单。
ila closed this issue 2026-08-25 10:24:37 +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#26