Skip to content

docs(agents): 收敛长期规则并统一文档与决策入口 - #152

Merged
fxbin merged 3 commits into
mainfrom
issue-151-historical-docs-consolidation
Oct 24, 2026
Merged

fxbin merged 3 commits into
mainfrom
issue-151-historical-docs-consolidation

Conversation

@fxbin

@fxbin fxbin commented Oct 24, 2026 •

Copy link
Copy Markdown
Owner

What & why

过去功能参数与历史记录逐渐堆入 AGENTS,部分长期理由和运行合同又只存在本地文档。现在 AGENTS 保留权限、安全、分层、验证与交付约定,长期理由和同主题合同收敛到 owning notes,退役八份 docs 入口并修正所有现用引用。

Fixes #150
Fixes #151

Area

  • docs
  • backend(套餐来源元数据及其回归)
  • config / infra(精简文档白名单)

Verification

  • 两个已授权文档提交 738ac61、6de866e;独立复核发现测试空行格式后追加 4720513,未改写历史。
  • TEST_PG_PORT=5543 bash backend/scripts/test_full_local.sh -k 'plan_catalog or check_agent_docs':一次性 PostgreSQL,12 项通过,0 失败/错误/跳过,退出 0;开发和生产库未连接。
  • make lint:ruff 检查及 559 个 Python 文件格式、layering、scoring-mirror、edition-naming、前端 tsc 全通过。
  • notes 契约 28 篇通过,149 条本地 Markdown 引用有效;docs 无 Markdown,41 个已跟踪媒体保持不变。
  • 事件合同完整正文保留,安全/分层/测试清库/4.1–4.3 审批条款逐字保持;原始文档备份已做隔离恢复核验,备份和机器输出仅留本地,不进 PR。
  • 运行 AST 唯一变化为 plan_catalog.source 改指商业假设 note;套餐、价格、权限值不变。其余 Python 修改仅文档注释或回归。
  • PR CI 40067546804 与 main push CI 40067672959 均 8 项全绿。合并提交 cd203a6;本地 main 已同步且工作区干净。CI 通过不等于生产验收。

Verifier verdict

PASS(独立源代码/合同/产物边界复核)。复核者 /root/event_candidate_verifier 绑定最终 head 4720513、base f89e2d9、30文件manifest SHA256 2877a52465acb6181184be7264842b59f0d1e803652f1075beedc9d9a26be0ba。独立检查确认事件原文和关键安全合同保留、唯一运行AST变化为套餐source、旧原稿/备份不进库;独立 notes/ruff format/check/agent-docs/layering 与哈希核验通过。12项PG结果由复核者检查原始XML,未冒称其独立重跑PG。24项长期notes/约束逐路径确认用途和维护责任,G4及最终Artifact Boundary通过;远端 PR 与 main CI 均已 8 项全绿。

Checklist

  • 三个提交各自单一意图,Conventional Commit 日常中文说明。
  • 分支 issue-151-historical-docs-consolidation,Fixes 同时关闭两项已完成文档工作。
  • 无环境文件、数据库、截图、原始敏感审查、.vidt 备份或过程报告。
  • 原 rejected 笔记只分类移动、内容不变;提案不冒充实现,当前状态仍归 GitHub。

Notes for reviewer

#140 的真实人工留出与有界生产试点继续跟踪,生产自动 write 门槛不变。本 PR 不部署、不迁移、不执行凭据轮换、生产清理、模型调用或对外通知。

候选 head 4720513,base f89e2d9。长期知识文件的逐路径 Artifact Boundary 复核与 promotion 证据在本地保留;不把过程输出提交为产品文档。

@fxbin
fxbin merged commit cd203a6 into main Oct 24, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

提炼历史文档决策并清理已备份的本地原稿 收敛 AGENTS 长期规则并补齐决策笔记

1 participant