承接目录治理:上轮只压缩内容未减文件数,闭线工作记录仍平铺致目录看着仍一堆(创始人指出)。本次执行 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>
6.1 KiB
6.1 KiB
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 harnessplayer_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。