zizi 7f24a344d0 docs(agent-specs): B2 归档——64 个闭线工作记录移入 _archive/,热目录顶层 90→26
承接目录治理:上轮只压缩内容未减文件数,闭线工作记录仍平铺致目录看着仍一堆(创始人指出)。本次执行 B2 归档。

64 个 ≤06-15 闭线档(25 压缩桩 + 闭线 review/report/纪要/edit-plan)git mv 入 docs/agent-specs/_archive/(文件名不变、仍 git 跟踪可查)。热目录 ≤06-15 仅留 13 活档(决策/纲领/SoT/活spike)+13 个 06-16 在飞。

活资产 20 处旧路径引用(.agents/docs/memory/_index)同步改 _archive/,引用断裂复测=0;_index 活地图 + 治理档状态收口。约束:0 个 06-16 被移、orchestrator 等未跟踪在飞档零误纳。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 13:26:19 +00:00

6.1 KiB
Raw Blame History

agent-specs 活地图(_index)

用途:本目录的"哪些是活的、哪些已死、哪些被谁推翻"的单一导航入口(类比 MEMORY.md 之于记忆)。新 agent 接手前先读本档再决定信哪份 spec,避免照建到已被推翻的废弃选型。 维护:波次收口时按 .agents/skills/wave-close-checklist.md 第 8 步更新(活档增删 / supersede 链 / 归档指针)。 命名/状态/分层规范:见 .agents/rules/engineering-conventions.md §10。 本档由来 + 全量逐文件分类:见 2026-06-16-agent-specs目录治理-review.md(治理审计评审版,附录 A 有 80+ 行全表)。


1. 活档清单(ACTIVE / SoT — 仍管当前或未来工作)

生成主线(HJ-GEN-001)

  • 2026-06-12-游戏生成系统总体架构-review.md — 生成系统总体架构纲领(三级生成 / W-G0~G4 路线 / 13 意图矩阵)
  • 2026-06-13-WG1-20经典轻游戏基准-review.md — W-G1 靶集 + 4 类缺口诊断(在飞)
  • prompt治理体系-execution.md — Prompt 第 8 契约执行版(Registry / 门禁 / HITL,现行)
  • 2026-06-09-generation-spike/ — C1 生成 spike 证据底座(可复现,被 MEMORY 引)

agentic 基建(当前主线 HJ-AGI-002 = SAA-only)

  • 2026-06-15-SAA-AgentScope-agent平台-目标架构-review.md — 当前 agentic 编排目标架构(决策口径)
  • 2026-06-15-SAA-能力API接入-dossier.md — SAA API / 坑 源码权威档(落地照此)

引擎 / Runner v2(线已收口,留 SoT + 全弧顶层)

  • 2026-06-11-T1引擎终裁包.md — Tier1=LittleJS 选型 SoT(含复议权 §4.5)
  • 2026-06-15-T1b-β收口报告.md — 引擎接管线正式收口报告(commit/file:line 账本)
  • 2026-06-13-runner-v2-arc-review.md — Runner v2 全弧顶层主梁(P3=W-G1 在飞依赖)
  • 2026-06-12-W-T1b-Runner与双层模板-review.md — 模板哲学宪法(模板=插件非游戏)

渠道线(HJ-CH-001,竞标在飞)

  • 2026-06-12-渠道适配判定-小游戏双渠道.md — 渠道分工判定(一壳多游 / L1-only / 备案锁)
  • 2026-06-12-W-CH-α渠道引擎对比spike-execution.md — 渠道引擎竞标 spike(P1 待创始人三件套)
  • 2026-06-12-channel-spike/ — 渠道竞标代码资产(adapter / cocos 双 lane)

战略 / 变现

  • 2026-06-10-架构文档三向审计-review.md — 四颗雷 R1-R4 战略活账(B 端现金线 / 合规 / 经济模型)
  • 2026-06-11-newapi计费平面集成-review.md — 生成侧 new-api / 收益侧 trade 硬边界(分期范围现行)
  • 2026-06-11-W4单位经济埋点-review.md — 单位经济埋点(含 §五未拍口径)

活工具箱(非 doc,但活,保留)

  • 2026-06-09-agent-loop-v1/orchestrator/ — QA 生成编排器 + 计费 newapi_cost.py + CDP harness player_cdp.py(被 11 处活资产引用;建议长期迁 tools/)

06-16 今日在飞(本轮治理不动)

W-G1开闸验收门-review + -组A-execution、生成引擎主线-传承与演进-review、生成引擎-任务清单普查、M4变现真实化-review、studio-vs-demo-UI差距-review、产品开发路线图-review、视觉增强repair-review、studio视觉体系-i18n-组件库-review(HJ-FE-DS-001·设计体系/通用组件/双语方案+mockup,待创始人拍板)


2. supersede 链(已死 — 勿信,照建即落废栈)

废弃档 被推翻为
agentic基建框架选型-review(HJ-AGI-001 AgentScope) + OpenGame蓝图补缺-review SAA-only(HJ-AGI-002, 06-15 五份) + OpenGame C2 降级从不部署
核心功能技术实现方案.md + -总体设计-review + 技术实现方案-sections/ 内"自研 Canvas Runtime<15KB / Dify / OpenGame / ComfyUI" 选型 LittleJS 终裁(06-12) / C2 降级 / SAA
Mc模板波全套(merge/idle/tycoon/clicker 玩法模板 + 自研 Runtime) W-CLEAN 废除(玩法模板层 + 旧 4 模板 + 存量数据清除)
06-08 命名铁律"huijing 框架不动" + 06-10/11 execution 内 cn.wanxiang.game.* 路径 改名 com.wanxiang.huijing(c74aa7da),旧路径全作废(勿照抄)
核心功能技术实现方案.md(单体) ↔ 技术实现方案-sections/ 互为 DUP,取一即可
wave3创作补全与发布闸门-review(HJ-BUILD-003) wave3-staging联调与P0补全-review(004 继承+取代)
W-G1 06-14 组(P3-W-G1/WG1-bakeoff/scale20) 06-16 开闸验收门 + 任务清单普查 接棒

3. 归档 / 分层状态(2026-06-16 治理)

  • 已执行(B0+B1 删噪声/搬证据):删 5 个 tracked __pycache__;从 tier1-engine-spike(9.4M→164K)、模型评估矩阵(1.4M→160K)、agent-loop-v1/runs(5.3M→284K) 删非 md 可重生成产物(留结论 md),wf-admin-wave2-phase1.mjs 代码移除。
  • 已执行(B3 压缩 + 退役设计簇):25 个已收口 execution/edit-plan 巨档压成桩(Mc批② 1305→9、wave3 985→8、A0 789→9、P3 641→10…);退役 06-09 核心功能技术实现方案单体(2360→9)+总体设计-review,删其 sections/ DUP。目录 21M→4.0M。
  • 已执行(蓝图除锈):.agents/knowledge/{tech-decisions,glossary,product-and-architecture,mvp-scope} 把废弃选型(Dify/OpenGame/自研Canvas/ComfyUI/AgentScope)的过期权威表述外科改为现行口径。
  • 已执行(B2 归档):64 个闭线工作记录(压缩桩 + 闭线 review/report/纪要)移入 docs/agent-specs/_archive/(文件名不变;活资产 20 处旧路径引用已同步改 _archive/)。热目录 ≤06-15 仅留 13 活档(即上方第 1 节)。
  • 已执行(核心档对齐):技术决策版/开发团队版/投资人版/护城河 + .agents/knowledge 蓝图已对齐现行真相(2026-06-16-技术决策版重写-review.md)。
  • 闭线/已死档全在 _archive/(仍 git 跟踪可查,按文件名);判活看本图第 1 节、判死看第 2 节。全量逐文件 action 见治理 review 附录 A。