cc-web/.planning/2026-08-24-gitea-webhook-docs/task_plan.md

Gitea Webhook Agent 文档与回归计划

目标

补齐 Gitea Workflow 的部署运维和测试设计文档，并新增不依赖业务实现的 Webhook 协议回归脚本与 fixtures，覆盖验签、事件过滤、队列恢复、回执重试 兜底、MCP 线程配置和安全边界；不修改 server.js 主逻辑，也不覆盖其他代理 正在进行的 Gitea 文档或实现改动。

步骤

1. 盘点并复核 docs/gitea-workflow/PRD.md、ARCHITECTURE.md，确认需求覆盖和 与其他代理的修改边界
2. 补齐/校验 PRD 与架构交付基线，并设计部署运维文档固定安全与恢复契约
3. 设计测试文档并建立需求到回归场景覆盖矩阵
4. 新增独立 webhook 回归脚本与 JSON fixtures，固定直接验收入口
5. 运行定向回归、脚本语法检查和差异范围审查
6. 完成文档一致性复核并清理临时清单

约束

• 现有 PRD.md、ARCHITECTURE.md 属于其他代理的工作区：先做只读一致性复核； 只有发现本需求明确缺口且确认不覆盖其改动时才做最小追加，否则在新增文档中 记录已覆盖项和缺口。
• 本轮新增/修改目标为 docs/gitea-workflow/DEPLOYMENT.md、TESTING.md、 scripts/gitea-webhook-regression.js 及 fixtures/gitea-workflow/*.json， 并在新增文档中明确引用 PRD/架构路径。
• 独立验收入口固定为：timeout 60s node scripts/gitea-webhook-regression.js； 脚本输出每个场景的 PASS/FAIL 与最终汇总，不依赖服务启动或网络。
• 不修改 server.js 主逻辑、lib/、public/、依赖和其他代理的目标文档。