12 Commits

Author SHA1 Message Date
lili
a207cb8d65 docs(agents): skill 规范化双层收口 + 席位context skill 新增 + W-NSTAR/W-TPL/W-GENLOG 设计波落档
Some checks failed
contract-gates / contract-gates (push) Has been cancelled
docs-gate / docs-gate (push) Has been cancelled
- .agents/skills 25 件全量 frontmatter 规范化与评审修入(含 prompt-governance 大修);.claude/skills 7 件薄壳按双层方案①落位
- 新增 skill:agentic-seat-context-design(agentic 席位与 context 工程设计基线,2026-07-05 探索蒸馏)
- 设计波三件落档:复杂游戏北极星件(W-NSTAR 终审稿待拍)/黄金模板规格件(W-TPL 定稿待批)/生成侧过程蒸馏回路(W-GENLOG 骨架)
- protocol/在飞板/作战清单/数据飞轮 SoT/契约 prompts 索引同步;breakout 九门证据刷新
- .gitignore 补 /localagents.md 真实忽略行(该文件自声明绝不提交,此前声明未被机器执行)
- 刻意不入库:nacos-data/ 与 _tier2-gen、c2v-*、amgen-* 生成产物(可重生成,忽略行格式待拍)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 05:32:56 -07:00
zizi
d97e194383 docs(治理): SoT注册表+docs-gate六检门,清缩历史档126→69
- 注册表:docs/architecture/README.md §2,37 份 canonical(frontmatter topic+canonical:true)与表双向机器对账
- 门:.agents/tools/docs-gate.py 六检(品牌根/canonical唯一/死链/入口卫生/留痕隔离/设计档申报),挂 .githooks/pre-commit(本仓已激活)+ .gitea/workflows/docs-gate.yml(待runner)+ wave-close 第8步;旧 check-deadlinks.sh 退役并入 G3
- 清缩:删 54 项历史档(plans 16/agent-specs 设计与spike 20/brainstorms 5/memorys 3/goals+作战清单完成史归档/王蓝莓design/SAA现状html/add-game-template);channel-spike 564K 代码资产迁仓级 spikes/;六件删前蒸馏已迁(代码评审16条open项→进度总账§5、prefix-cache字段表→cheap-model skill、意图基线29条→需求清单附录、九门降级rationale→验收门、A11 TODO→tech-decisions、3layer边界→littlejs-game-dev 指针)
- 修口径约90处:六处SAA『现行主线』旧标、Nacos/RocketMQ『未部署』旧述(07-01反转)、gameDefinition残留、全部死链改 git show 定位;AGENTS.md 249→136行(决策史归tech-decisions);_index 改纯在飞板;对外演示版 md→html
- 依据:docs/agent-specs/2026-07-02-文档治理-{全量普查与裁决-report,SoT注册表与治理门-设计}.md(四路普查191份md+Codex/Opus双评审必修项已折入);恢复基线 8ea97234(单档 git checkout 8ea97234 -- <路径>)
2026-07-02 14:24:12 +08:00
lili
4e801d5e8a docs(reframe收口): 生成引擎 reframe 全层 doc-sync + 统一执行 plan + 上线主计划 SoT + §6.8 双评审
双查一致性(Codex+Opus)→ 修问题 → 出 plan 全链收口。

修问题(reframe 全活层 doc-sync · 框架统一 AgentScope / 三档按 AI 深度 / 去超休闲 /
A-model 写真 src/ / tier2 spike accept · n=5 收敛环 / 预算闸 <¥10·<¥50):
knowledge 三件套 + 顶层图说 00/01/02/05 + 6 域 README + 5 mvp 账本 + skill·workflow +
agent-specs(_index / 演进路线降留痕);系统性死链 自治富游戏引擎.md → 运行时 SoT repoint(7 档)。

AGENTS.md:§2 收敛上线主计划 SoT、§3.1 入口自审 reframe 对齐。

出 plan:① 生成引擎统一执行计划(新建 · 统一三档 · 吸收退役 06-18-001/06-19-001/003);
② 4 份重复 plan 退役/并入/去两线 banner;③ 可行性方案16周 就地升格为项目上线主计划 SoT(canonical)。

§6.8 双评审(Codex+Opus)6 必修已修:WU-A 真实拓扑+JS留+迁移契约 / A11 孤儿接缝(①WU-B↔③阶段三)
/ 三档拆清 / ③ 过度表述 / 人办清单 n≥30→n=5 / 死链。

tier2/HANDOFF.md:n≥30→n=5 + agentscope-runtime→2.0.2 Workspace doc-sync banner。

①③ status=草稿·双评审已过·待创始人确认 F1(WU-A 迁移归属)后转正式。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 12:14:25 -07:00
lili
e4cd505086 docs(架构): broader 档 tier2 状态 doc-sync — 清「待 spike/未落代码」(13模块/系统总览/产品图说/前端)
4 份架构档把 tier2 写成「待 0 号 spike、未落代码、远期·待建」,已过时。按 tier2/HANDOFF.md
+ SoT① 统一改成现状真相(核心已落 + 0号 spike feie-005 accept,n=1 机制验证、n≥30 统计待跑;
阶段1 Agent Team/控制面/feed 第二装载留 Phase B),未过度纠成「已完成」:
- 13模块:生成轨现状段 + 修 自治富游戏引擎/agentic集成架构 两 tombstone 链→SoT①
- 00-系统总览:图3/图8 散文 5 处(svg 虚线为 spike 前视角不动,散文点明现状以 SoT 为准)
- 01-产品图说:6 处状态口径;§188 内外口径精确改「已过 spike n=1、n≥30 完成确认可对外
  背书后再同步」(非「已可对外背书」);MVP 55 P0/不单列 P-id/Cocos 决策全保留
- 前端README:tier2 承载前提 + 修 引擎与运行时/tier2实现详设 tombstone 链;L229 SLO 链→
  SoT①(装载)+验收门(首局≤2s)

opus 代理执行、逐处核验(无过度纠偏/§188/MVP P0/死链 0/品牌净)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 00:20:11 -07:00
zizi
14c3ce4896 docs(recall): 清理历史回收过程留痕(删 12 清单+README,保判定记录)
回收→判定→落档闭环已闭合,捡回项已写进现行设计档(带来源标记)。删 12 份回收
清单(第一轮 6 + 第二轮 6)+ README 总索引,git history 永久保留可随时翻;保留
创始人判定.md 作判定追溯权威。同步修 5 处指向被删清单的断链(前端 README 2 +
观测体系 3,改为文字引用 + 判定记录指针)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-22 18:28:21 +00:00
zizi
1b3e375a68 docs(arch): 历史回收判定落档——约 60 条捡回项写进 21 份现行设计档
按 _recall/创始人判定.md(创始人 2026-06-22 逐条判定),6 域并行 additive 落档,
每处标来源、人读散文、涉契约者给 contract-first 待落地清单:
- 产品:商业定位补竞品现任者/IP 关键人风险/增长冷启动/验收北极星;护城河话术补
  腰尾部 IP/真资产 reframe/自有吉祥物红线;Doc A 就地改格(P-PUB-01→P1、
  P-OPS-01→P0-lite,ACC 进 P0↔PUB 出 P0 保住 55 锚)+ P-CRT-02 注记每类 workflow
  生成/rig 留 premium 远期/补 P-id
- 前端:README §9 前端域承载(admin 审核台四页+观测三入口/C 端收益页溯源条 AIGC
  标识/43 口径引用/移动端适配/Debug 插件)
- 后端:数据模型 §7 待落地缺口(026 game_id/029 留存/030 锁风 JSON/031 信用台账/
  绘豆)、鉴权与权限 032 封号级联+018 短信防护、契约总览 Pact/Registry 远期
- 生成引擎:029 硬门 A-E 回填验收门+OpenGame对照/031 Phase 路线/033 创作期回灌/
  035 反锁死/036 harness 护城河/037 整图串行/001 对话式/002 透传/007 绘豆预算
- 运维:观测体系 §3.7 网关健康巡检、README §5/6/7 job 调度面/flag 纪律/数据可靠性
- 运营:渠道发行广告运行时红线/审核台事中召回/变现端到端资金切换护栏/变现与单位经济
  月增速+eCPM 口径统一+成本漏算+成本假设待测

contract-first 待落地项均标"勿当已建"。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-22 18:08:05 +00:00
zizi
15b707fd2a docs(arch): 回填创始人 4 拍板(k8s收窄缓做 / P-FED-12升P0 / 同款不分成 / 审核台信用降权放第一期)
创始人 2026-06-22 拍板,逐条落档:
- k8s:收窄(单节点 k3s + 数据库不进集群 + 推迟多节点/高可用/prod)+ 缓做(排 W-G1 之后)
  → k8s迁移 §7/§9/§6 收口、运维 README §4 修正
- P-FED-12 同款创作升 P0:Doc A 需求清单 P1→P0(P0 总数 55→56 待全局同步)、
  数据飞轮开放问题#6 + 正文收口、前端 README §7.3 口径校准
- 同款创作首期不分成、纯展示溯源:数据飞轮开放问题#1 + 正文收口
- 审核台 feed 自动降权 + 创作者信用模型放第一期(覆盖原"建议降 P1"):审核台
  §4 第一期/§3.5/§5.3 收口为放第一期、单独做(均待 contract-first 补新 -api/新表)

验证:待拍板残留 grep 全 0;Doc A 已 P0;审核台"放第一期"7 处。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-22 01:12:11 +00:00
zizi
f4ee23109e docs(recall): 创始人逐条判定 5 条横跨多域优先项落地(2 对齐进档 + 3 立待补设计骨架)
- ① 对话式创作:定调完整产品形态=对话创作+差量修改+改素材,一句话+选玩法模板=
  启动点位之一 → 前端 README §7.3 产品形态定调(对话式创作不再算 descope、前端 UI
  列待补;未擅改 P1/P0 验收契约)
- ④ 平台吞并风险:应对=深化引擎使用+创作能力 → 商业定位 §3「平台方下场风险与应对」
- ②数据飞轮 / ③审核台 / ⑤观测体系:创始人判"需补设计" → 生成引擎README §10 /
  合规闸门 §9 / 运维README §4 立待补设计骨架+范围建议,待创始人定 MVP 边界后出正式稿
- 回收 README 补判定纪要表(5 条结论+落点;其余约 194 条待逐条过)

均就地扩现行域活档、未新建一次性文件;全为人读散文。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 18:38:06 +00:00
zizi
5cadf5042c docs: ③ 五决策落地(1B trace 改'待立新类' · 2A 源项目契约另立独立 schema/防撞在产线 · 3A 前端 tier2 承载归属桩 · 4B 护城河对外暂不改+内部备注 · 5B 渠道竞标加 tier2 祛魅交叉引用)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 17:13:29 +00:00
lili
7bd9cd05e6 docs(governance): Phase7 收口——治理门反转 + 源档归档 + 入口对账 + 死链门
设计文档域化重构总收口:
- §10 治理门反转(engineering-conventions §10.5/10.6/10.7):canonical 根从 agent-specs 改为 docs/architecture 6 域树;品牌门白名单加 architecture/_archive。
- 归档 11 settled 源档(7 根 architecture + 4 非生成 agent-specs canonical)→ 各自 _archive(git mv 保 history + tombstone redirect)。生成域设计链过渡期保留(架构演进中)。
- rewire 17 个活层文件(.agents/knowledge|rules|skills + docs/mvp + AGENTS.md + 新树)指向新树路径;活层零残留旧 canonical 路径。
- AGENTS.md §4 必读表/§3.2 目录树/§3.3-3.4 指针 → 新树;_index.md 瘦身为 trace/spike + 生成域演进链 + 修 line22↔40 自相矛盾。
- 新增死链门 .agents/tools/check-deadlinks.sh(§10.7 死链项的可执行脚本)。
- 全门齐跑:死链 0 / 新树无旧品牌 / 无超 2000 行 / 活层无残留。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 20:48:38 -07:00
lili
c6b9569033 docs(architecture): 修复审查发现的过时/错误内容(57 项 · 18 档)
25 档 opus 审查(对照代码/契约/git)→ 9C+23M+26m 真过时/错误 → 18 档 opus 修复(各自先按 commit/file:line 复核再改,1 项审查误判经复核拒绝)。主要簇:① gameDefinition 终态对齐——固定架构/SAA编排把'真结构化已成立'降级为'通往 src/ 的中间脚手架 + behavior.code 内嵌串=已知债',跨档对齐 README §3.2/设计裁决(06-20 创始人定调);② WG1 门面缺口按 06-14 scale-20 实测修订(预判几乎全推翻);③ 开闸接线改完成时(generic 桥接 7534bdf9 + 5 品类模板回填 046c061d 已落地);④ Flyway 数字 V17/V18→V25;⑤ 会员订阅(V21 ca53a0db)/community(U3 3f35acb4)/资产渲染(U1 73d33916)状态更新;⑥ prompt治理(classpath 加载)/引擎(Phaser gz)/前端(token 名·prefers-color-scheme)/运维(mini-infra=PostgreSQL·push=阿里云Gitea)细节订正。全 26 档过门(≤2000/有图/品牌绘境AI)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 20:21:03 -07:00
lili
fc0c164678 docs(architecture): fan-out 重写架构/前端/运营/后端/运维 5 域(20 档 · 全 opus)
Workflow 每目标档一个 opus agent,以产品域 README 为风格样板:架构 L2 主档 + 13模块 + 生成引擎旗舰子树(11 档:README/固定游戏架构/SAA编排/引擎与运行时/验收门-W-G1/prompt治理/设计合理性裁决/OpenGame对照/WG1基准/SAA能力API-dossier/开闸接线)+ 前端 + 运营(README/变现与单位经济/渠道发行/合规闸门)+ 后端瘦主档 + 运维瘦主档。全部:人读散文 + 多图(Mermaid)+ 少黑话(专名首现解释)+ 单档 ≤2000(最大 452)+ 品牌绘境AI + 硬事实保留(门ID/数字/契约/裁决)。源档归档、§10 治理反转、~17 连带引用、L1 总索引、_index/AGENTS 对账、死链门统一留 Phase7。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 19:43:41 -07:00