Commit Graph

2 Commits

Author SHA1 Message Date
iomgaa 855d9c376a docs(guides): 写发布指南,guides/ 的第一份
CLAUDE.md §1.10 一直指着一份「还没写」的文档,现在它在了。九个步骤逐条写清为什么是这一步、
为什么在这个位置,末节按「哪一步防哪个坑」把 PolyGateway 踩过的十来个坑映射回步骤,读者
不用自己对应。

素材来自对 PolyGateway 的调研并逐条核实过:registry 是 owner 级、工具只能是 twine
(tea 0.15.0 没有 packages 子命令)、token 在 tea 的配置里不在 .pypirc、这台机器的代理
到不了外面所以上传与验证都要绕开、同版本重传会被 409 拒绝、缺 readme 会让包页面空白而
twine check 只警告不拦。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-11 00:14:22 -04:00
iomgaa a2e94318b9 chore(repo): 建仓,落成协作规范与文档骨架
协作方式以 CHSAnalyzer 为蓝本,按「库」这个身份改写:

- CLAUDE.md §0 的权威表换成公共 API 契约、公共类型、下游迁移三条主线,
  数据库 schema / HTTP 契约 / alembic 迁移在本项目不存在,整体删去。
- §1 新增四条库特有的硬约束:字段只增不删不改名、持久化 schema 走显式版本、
  不反向 import 下游、发布必须走完整流程(PolyGateway 有两个版本只 bump
  没上传,registry 长期停在旧版且无人发现)。
- §3 的四类 Codex 对抗审查按同一判据重定:公共签名、停止判定与预算结算、
  取消传播与 Session 隔离、schema 演进。共同点是错了不会当场炸。
- research-wiki 在常青层加第四类 migrations/,因为本项目的核心验收标准就是
  能否搬回 dissect、能否替代 GovDoc-SaaS 的 docagent-core/,塞进 guides/
  会让它看起来像可选工序。

reference/ 不入库:五个仓库各带一个 .git、合计约 96MB,提交进来会变成一堆
不可用的嵌套仓库。它也不是任何事实的权威,agent-core.md 同理。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 07:02:09 -04:00