Files
Agent-System/.doc/ops/short-term/2026-09-24-governance-catalog.md
T

2.8 KiB
Raw Blame History

title, task_id, status, created, updated, head_sha, owner, task_type, task_tier, policy_revision, branch, worktree, base_dev_sha, write_scope, allowed_environments, mutex, review_state, integration_state, deployment, cleanup, cleanup_owner, cleanup_trigger, remote_sync
title task_id status created updated head_sha owner task_type task_tier policy_revision branch worktree base_dev_sha write_scope allowed_environments mutex review_state integration_state deployment cleanup cleanup_owner cleanup_trigger remote_sync
治理目录库与跨对话需求重叠检测 governance-catalog-2026-09-24 done 2026-09-24 2026-09-24 e1796cc858 Cursor implementation multi_stage agent-governance-2026-09-21-r1 @ cfc80b34a4 feature/governance-catalog-2026-09-24 .worktrees/governance-catalog-2026-09-24 cfc80b34a4
scripts
configs
.doc
.cursor
agent-workflow-governance+catalog approved merged not_required pending Cursor validate pass + queue enqueue + closeout not_requested

治理目录库与跨对话需求重叠检测

用户目标与授权

  • 用户目标:跨对话需求/功能重叠与冲突可机器检测;认领、缺陷、测试、发布版本进入与业务库隔离的治理目录。
  • 授权来源:用户确认计划「治理目录库与需求重叠检测」并要求按 to-do 全量实施。
  • 交付终点:Catalog schema + FTS5 中文召回 + 两级门禁 + 回填 + 可降级向量层 + MCP/技能 + 工程回归报告;受控合入 local dev。
  • 禁止:不连业务 PostgreSQL;不新建第二库文件/容器;不自动升 MATRIX;不 push;不强制产品 PI 全链路(工程工具变更,NOT REQUIRED)。

范围与非目标

  • 允许写入:scripts/agentctl*.py、scripts/catalog_backfill.py、scripts/mcp/agentctl-mcp.mjs、scripts/tests/、configs/agent-governance.json、.doc/(方案/任务/报告/模板漂移修复)、.cursor/skills 与 mandatory 规则补充。
  • 非目标:跨机权威认领、产品业务功能、自动删除 worktree。

相关问题与经验

  • 检索词:overlap / requirement / catalog / docs drift / FTS5
  • 命中:路径级 overlaps() 已 enforced;需求语义重叠无机制;embedding 401 运维债 → 向量层 fail-open。
  • 采纳:可选策略键扩展;CJK 逐字切分禁用 trigram;测试夹具同步复制新模块。

步骤与验收

  • W0 方案主文档 + policy-registry proposed
  • W1–W4 catalog 模块 + task register 联动
  • W5 回填 + drift
  • W6 向量降级三态
  • W7 MCP + 技能
  • W8 unittest 全绿 + 报告
  • W9 validate → queue → closeout

验证与证据

范围 / 被测 SHA 命令与环境 预期 实际 / 判定 证据
工程工具 python3 -B -m unittest discover -s scripts/tests -p 'test_*.py' -v 全绿 (待填) test-report

收口与交接

  • 五态见 frontmatter;合入后更新。
  • 相关:方案