weichenandCursor
7778559201
Accept DOCREV decision gates, archive design short-term, and mark FEATURE-MATRIX partial as implementation starts on feature branch. Co-authored-by: Cursor <cursoragent@cursor.com>
3.7 KiB
title, status, created, updated, owner, branch, worktree, mutex
| title | status | created | updated | owner | branch | worktree | mutex |
|---|---|---|---|---|---|---|---|
| 文档修改、版本差异与智能体变更说明设计 | done | 2026-09-13 | 2026-09-13 | Codex | feature/document-revision-management | - | docgov |
文档修改、版本差异与智能体变更说明设计
目标
基于当前 DocGov、任务、块编辑器与通知实现，形成一套可直接评审和拆分实施的文档修改管理方案，覆盖人工修改标记、智能体/小队修改归属、版本边界、任意版本比较、AI 变更说明及负责人通知。
范围
- 交叉核对现有文档数据模型、保存链路、Agent 产物落盘、前端块编辑器、权限和通知机制。
- 明确定义“智能体基线 + 后续人工修改”的工作副本与正式版本语义。
- 设计数据模型、事务边界、API、前端交互、通知、权限、迁移兼容及验收矩阵。
- 产出 audit、system-design、remediation 文档并同步文档索引与 FEATURE-MATRIX。
非目标
- 本任务不修改业务代码、数据库迁移或运行环境。
- 本任务不执行共享容器重建、真实 PI E2E 或合入
dev。 - 本任务不替用户决定版本保留周期、强监管电子签名策略等产品决策；方案给出推荐默认值和决策点。
步骤
- 完成当前实现与既有设计的证据核对。
- 形成领域模型、版本状态机与一致性边界设计。
- 形成前端展示、API、权限、通知与验收设计。
- 形成分波次整改方案和实施任务拆分。
- 更新文档索引、FEATURE-MATRIX、CURRENT 并执行文档质量检查。
验收标准
- 方案能逐条映射用户提出的版本边界与显示规则。
- 能区分用户、单智能体、智能体小队及系统迁移等修改主体。
- 并发、失败恢复、权限、审计、通知去重和大文档性能均有确定性方案。
- API、表结构、UI 状态、迁移顺序与测试用例足以供开发直接拆单。
- 仅产生方案文档变更，无业务代码和环境变更。
相关链接
- Audit:
../../audit/2026-09-13-document-revision-management-gap-analysis.md - System design:
../../system-design/document-revision-management.md - Remediation:
../../remediation/2026-09-13-document-revision-management-implementation-plan.md - Test report: 实施阶段补充
证据 / 备注
-
用户评审通过前保持
in_progress；本轮交付的是可评审方案，不代表能力已实现。 -
2026-09-13：
git diff --checkPASS；新增文档及新增链接均可解析。 -
索引文件中另有 3 个与本任务无关的既有失效链接（两个历史
.tmp目录、一个architecture-design.md相对路径），本任务未扩大范围修改。 -
2026-09-13：独立复审（Cline）通过，结论待用户最终拍板：①三项决策（智能体/模板开 Version、high/critical 强制编制负责人二次确认、首发只覆盖受控文档）均确认可行，理由与既有
document_change_proposals认领授权机制一致；②抽查 DOCREV-01~09 全部 9 项源码证据属实（含bizdev/service.go:499-502通用提案文案、:694-705忽略错误写哈希、handlers.go:1027客户端 holder 直通、BlockEditorModal.tsx:104硬编码“张工”、saveDocumentContent无调用者、Goose 基线 00027）；③补强 2 处设计缺口——根表指针列与既有freeform_documents.current_version_id同名冲突（改为ledger_*命名并明确旧列退役）、状态机把文档生命周期误并入版本状态（已拆为正交状态图）；同步修订 system-design §4/§6.7、remediation §3/§5.2/§5.7。 -
2026-09-13：用户确认 DOCREV 实施计划选项 1；设计任务归档，进入 Wave 0。