weichen/Agent-System-Dev
1
0
Fork 0
Code Issues 1 Pull Requests 9 Actions 2 Packages Projects Releases Wiki Activity

Record regulations initiative results on the task card

Browse Source 
Why: All plan units U1-U9 are merged in their component repositories; the card must reflect delivery, verification and remaining NOT_RUN items before the final window.
Evidence: Component main CI statuses (GATE) and local make test / make test-regulations-kb receipts (SELF) on the card.
Impact: Task card only; initiative stops accepting requirements.
Refs: docs/superpowers/plans/2026-10-18-regulations-knowledge-base-plan.md
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
weichen
2026-10-18 12:40:22 +00:00
co-authored by Cursor
parent 9dd9f1a854
commit d5134671ab
1 changed files with 44 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.task/feature-regulations-kb.md
+44 -33
View File
@@ -1,12 +1,12 @@
# feature/regulations-kb 任务卡
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
任务主记录：[Dev #614](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/614)；状态：进行中；owner：weichen
## 基线与授权
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= b5e23daed2f0ea46261979de1d62e4de0cfa88f9
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-regulations-kb（worktree）；分支：feature/regulations-kb
- 分支类型：initiative；initiative_id：feature-regulations-kb；root_target：main；immediate_target：main；accepting_requirements：true
- 分支类型：initiative；initiative_id：feature-regulations-kb；root_target：main；immediate_target：main；accepting_requirements：false
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=fa6ff4c75a01064e0aa767dc91455b8e5bcd0f5f29f59958962543c633bf2ba2；triage_receipt=/tmp/regkb-triage-20261018.json；receipt_sha256=907151e982da280292647462e8342fbbd1453a87565c887ef4cb2269f29eae03
- 授权与交付终点：用户 2026-10-18 指示“按照方案一步一步实现所有内容，并在完成后进行清理”（/goal）。授权范围 = 计划 U1–U9 的实施、验证、Review、各仓 PR 合入与安全收口，含新建 `Agent-System-KB-Regulations` 仓。未授权：生产部署、生产全量语料导入、发布受保护标准原文、法律适用性裁定、新增外部付费调用（真实搜索/MinerU 实网调用前须用户确认提供方与凭据）、高后果双钥匙操作。
@@ -14,7 +14,7 @@
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
- 当前阶段：需求拆解；当前增量：I1（待定义）
- 当前阶段：合入核验与收口；当前增量：U1–U9 全部合入组件仓，Dev 承载 U1/U7 规格与 U8 组合
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
## 目标与非目标
@@ -35,7 +35,7 @@
| 子任务分支 | 必需 | 状态 | PR |
|---|---|---|---|
| 待登记 | 否 | — | — |
| 无（各单元在组件仓独立分支交付，见「跨仓交付登记」） | — | — | — |
## Agent 实施收据
@@ -43,19 +43,27 @@
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|---|---|---|---|---|---|---|---|---|---|---|
| 待定义 | — | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | — |
| dev-u8-regulations-composition | modules/{backend,documents,frontend,ui}、tests/integration/regulations-kb、tests/test_regulations_kb_pin.py、Makefile、PROJECT.md | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session，session not-observable） | success | 05a60f7 | never | /tmp/regkb-u8dev-receipt.json（收口后清理） |
| dev-u8-regulations-scan-default | run.sh、README、pin 测试（扫描默认目录去掉服务端 bin/） | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session） | success | 4764cb4 | never | /tmp/regkb-u8dev-fix-receipt.json（收口后清理） |
| dev-u8-merge-prep-frontend-pin | modules/frontend 还原到分支基线 92864db 以干净合并 main #617 | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session） | success | c1181d4 | never | /tmp/regkb-u8dev-prep-receipt.json（收口后清理） |
| dev-u8-readd-frontend-pin | modules/frontend → 50ec836（426d104 后代） | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session） | success | 9dd9f1a | never | /tmp/regkb-u8dev-readd-receipt.json（收口后清理） |
| 组件仓单元 | U2–U7、提供方、组合与 KB/RDM U8 | 各仓 AGENT-EXECUTION.md | implementation | cursor→agy→pi | 各 1 | cursor | success | 见各仓 PR 与任务卡 | never | 各仓任务卡 |
## 关联方向与规划
- 适用状态：待核对（无适用规划时说明原因）
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
- 对应里程碑：待核对
- 适用状态：适用
- 主记录路径/版本：docs/superpowers/plans/2026-10-18-regulations-knowledge-base-plan.md（本 PR 合入版本）
- 对应里程碑：法规知识库 U1–U9
## 需求分析
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|---|---|---|---|---|---|---|
| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 |
| R1 | 受控法规语料：来源/许可盘点、解析切片、检索与版本发布（U1–U5） | 符合计划，KB 仓独立 | P0 | 计划 U1–U5 测试场景 | — | 已交付 |
| R2 | RDM 双源核验：缺任一通道报降级，不得显示已核验；审计批次防篡改（U6） | 符合 | P0 | U6 场景 | R1、R5 | 已交付 |
| R3 | 结构化引用：对话/文档/审计中定位到版本、条款与片段（U7） | 符合 | P0 | 引用合同 + U7 场景 | R2 | 已交付 |
| R4 | 组合、恢复、隐私与发布就绪（U8） | 符合 | P0 | 组合门禁 PASS | R1–R3 | 已交付（部署/发布另行门禁） |
| R5 | EXT-20 公开扩展契约与提供方（U9） | 符合 | P0 | Backend/Documents 合入 | — | 已交付 |
## 方案与计划
@@ -78,29 +86,32 @@
| EXT-20 提供方 | KB-Regulations `feature/kbreg-provider` | [KB #5](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-KB-Regulations/pulls/5) | 已合入 d6d7056 |
| U7 前端 | Frontend `feature/regulations-kb-citations` | [Frontend #109](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Frontend/pulls/109) | 已合入 2d65a81 |
| U7 契约 | Dev `docs/superpowers/specs/2026-10-18-regulations-citation-contract.md` | [Dev #614](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/614) | 已提交 06dd79c |
| U7 RDM | RDM `feature/regulations-kb-citations` | 待建 | 实施中 |
| 组合注册 | RDM `feature/regulations-kb-composition`（KB pin、kbreg 垫片、Frontend pin） | 待建 | 实施中 |
| U7 RDM | RDM `feature/regulations-kb-citations` | [RDM #437](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-RDM/pulls/437) | 已合入 3cc91de |
| 组合注册 + RDM U8 测试 | RDM `feature/regulations-kb-composition`（KB gitlink、kbreg 插件、组合测试） | [RDM #438](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-RDM/pulls/438) | 已合入 ece91da |
| U8 KB 运维与恢复测试 | KB-Regulations `feature/u8-operations` | [KB #6](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-KB-Regulations/pulls/6) | 已合入 5dddad2 |
| U7 前端卡状态修正 | Frontend `fix/close-regulations-kb-citations-card` | [Frontend #110](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Frontend/pulls/110) | 已合入 50ec836 |
| U8 Dev 组合 | Dev `feature/regulations-kb`（四个 gitlink + `make test-regulations-kb`） | [Dev #614](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/614) | 随本 PR 合入 |
## 阶段记录
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|---|---|---|---|---|---|
| 需求拆解 | 待定 | 待执行 | — | — | — |
| 需求评估 | 待定 | 待执行 | — | — | — |
| 需求表确认 | 待定 | 待执行 | — | — | — |
| 方案设计 | 待定 | 待执行 | — | — | — |
| 实施计划 | 待定 | 待执行 | — | — | — |
| 实施与自检 | 待定 | 待执行 | — | — | — |
| 正式测试与验收 | 待定 | 待执行 | — | — | — |
| 代码 Review | 待定 | 待执行 | — | — | — |
| 合入 | 待定 | 待执行 | — | — | — |
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
| 需求拆解 | 计划 f61737b | 完成 | 用户 /goal + host | 2026-10-18 | 计划 U1–U9 |
| 需求评估 | 计划 f61737b | 完成 | host | 2026-10-18 | 需求表 R1–R5 |
| 需求表确认 | 计划 f61737b | 完成 | 用户（/goal 一次确认 + AskQuestion 三项决策） | 2026-10-18 | 基线与授权 |
| 方案设计 | 计划 + 引用合同 06dd79c | 完成 | host | 2026-10-18 | docs/superpowers |
| 实施计划 | 计划 U1–U9 | 完成 | host | 2026-10-18 | 跨仓交付登记 |
| 实施与自检 | 各仓 PR head | 完成 | cursor worker（新进程/隔离工作区） | 2026-10-18 | Agent 实施收据 |
| 正式测试与验收 | Dev 4764cb4 + RDM ece91da + KB 5dddad2 | 完成（SELF 本地；GATE 见各仓 CI） | host | 2026-10-18 | 证据表 |
| 代码 Review | 各单元 diff | 完成 | host 主模型（未复用实施会话） | 2026-10-18 | 合入与清理 |
| 合入 | Dev #614 | 进行中 | host | 2026-10-18 | 当前 HEAD CI 通过后合入 |
| 合入核验与收口 | — | 待执行 | host | — | 清理记录 |
## 探索试验与迭代
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|---|---|---|---|---|---|---|---|
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
| 无 | — | — | — | — | — | — | — |
## 同步记录
@@ -124,24 +135,24 @@
## 结果与验证（完成后填写）
- 结果：
- 验证：<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项；逐条证据由 make evidence 写入上方证据表>
- 影响与剩余项：
- 结果：U1 盘点规格与 U7 引用合同（本 PR）；KB-Regulations #1–#6（基础契约、解析切片/MinerU 适配、网络搜索与 SSRF 安全抓取、检索/发布门禁、EXT-20 提供方、运维与恢复测试）；Backend #212、Documents #113（EXT-20）；RDM #434（双源核验与封印审计批次）、#437（结构化引用）、#438（kbreg 组合与组合测试）；Frontend #109/#110（引用渲染）；本 PR 固定 backend 56a7f9f、documents 5bb4877、frontend 50ec836、ui 5c2b103，并新增 `make test-regulations-kb`（固定 RDM ece91da、KB 5dddad2）。
- 验证：GATE——KB main 5dddad2（test、test-pg、governance）、d6d7056；RDM main 3cc91de、ece91da（build-and-test 首跑因既有不稳定测试 TestSlowLedgerPersistsLifecycle 失败，重跑 job 6149 通过；governance）；Frontend 2d65a81、50ec836（governance）；Dev 本 PR 当前 HEAD CI 见合入记录。SELF——Dev `make test` exit 0（umask 022；此前两次失败分别因嵌套子模块未物化与本机 umask 077 使 Backend TestDSNFileMode 误报，均已如实记录）；`make test-regulations-kb` PASS（一次性 pgvector pg16，三阶段 kb-test-pg / rdm-kbreg 12 个目标测试 / 客户端制品凭据扫描）。NOT_RUN——真实智谱搜索、MinerU 实网调用与真实嵌入（待用户确认提供方与凭据）。
- 影响与剩余项：新仓 Agent-System-KB-Regulations 分支保护待用户设置；RDM 需求文档同步为非阻塞后续；部署、版本发布、生产语料导入与业务/法务验收为后续独立门禁。非阻塞记录：RDM TestSlowLedgerPersistsLifecycle 存在内存终态先于台账回写的竞态（waitDone 只等内存状态）。
## 规划进展与下一步
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
- 推荐依据：待填写
- 前置条件/待确认：待核对
- 预期产物/验收条件：待定义
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
- 本次推进/剩余：计划 U1–U9 全部交付；剩余为实网联调与部署类后续门禁
- 首选下一任务：真实搜索/MinerU/嵌入实网联调（需用户确认提供方、凭据与费用）
- 推荐依据：计划 Verification Contract 中唯一 NOT_RUN 的能力验证
- 前置条件/待确认：用户批准外部付费调用并经环境注入凭据
- 预期产物/验收条件：KB `KBREG_*` 实网冒烟记录，不入库任何凭据
- 重复任务核对：无在途同类任务
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
## 合入与清理
- Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据）
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
- Review 记录：host 主模型逐个审阅各单元 diff（Dev 05a60f7/4764cb4/c1181d4/9dd9f1a，组件仓见各 PR），实施均由独立 cursor worker 新进程完成，审阅未复用实施会话；Dev U8 审阅发现扫描默认目录含服务端 bin/ 必然误报，已由 dev-u8-regulations-scan-default 修复；其余无阻塞项。
- 冲突记录：main #617 将 modules/frontend 改钉 426d104，与本分支 50ec836 冲突；准备单元还原到基线后干净合并（d5d6f70），再由单元钉回 50ec836（426d104 的后代，仅加卡状态修正）；modules/ui 两侧同为 5c2b103。
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）