5.9 KiB
项目档案：Aetherbound Guild
是什么
Aetherbound Guild / 裂脉远征团 是原创横屏 2D 日系手绘魔法公会远征策略游戏。当前只允许完整开发前设计和 HTML 原型；正式引擎开发冻结。
技术栈与目录结构
当前无运行时引擎。Markdown/JSON/CSV 是设计权威，HTML/CSS/JS 只用于设计原型。docs/reference、docs/product、docs/content、docs/presentation、docs/prototype、docs/reviews 按职责隔离。
硬性规范
- 授权商业参考只提炼结构，不复制名称、文案、公式、布局、代码、图片或音频。
- 完整设计包独立审查和 Owner 审核前，禁止运行时代码、引擎项目、批量最终资产、打包和发布。
- PMO 独占
.agent-taskgraph/与根共享文件；并行 worker 只写 Goal 指定目录。 - 每条内容必须有机械作用、交互、进度位置、表现、资产/音频和验证字段；禁止 filler。
需求与执行授权策略
| 配置 | 项目选择 |
|---|---|
| Agent TaskGraph 协议版本 | 0.8.0-beta.10（本活跃批次冻结；安装版 beta.12 只提供兼容 helper，不迁移协议） |
| Source baseline | READY: /Users/wusumac/Documents/game/aetherbound_guild at ac0dec25848dbc6fe54f8de07c8396b01d8d3a89, branch main, clean; redesign worktrees created only after the PMO baseline commit |
| 单任务快速路径 | 允许；本批不适用 |
| 复杂任务规格冻结 | .agent-taskgraph/spec.md design-spec-r3 已由 Owner 冻结 |
| 自主创建可见会话 | recruit-line-redesign-02 最多 10 个项目相关可见会话；完成六条设计线后新增两个独立 reviewer 已授权 |
| 派发预览授权 | 本批固定 HAPI 可见 Codex gpt-5.6-sol / xhigh / yolo 已授权 |
| 编制变更授权 | Owner 允许本批总会话数不超过 10；双 reviewer 分工已批准，仍须只读隔离、无写入冲突与真实 Goal |
| 默认 Human Gates | 依赖安装、删除、付费扩量、正式开发、打包、发布 |
| 已启用可选适配器 | HAPI：本批两个 worker 与 reviewer 均须用户可见、可接管 |
| Runtime 证据策略 | spawn 后验证线程、worktree、model、effort、permission 和 ACK；不匹配保持 inbox |
| 上下文模式 | balanced |
| Context 必读项上限 | 8 |
Execution profile（派发硬门）
| Execution profile | Confirmed value |
|---|---|
| Execution profile status | CONFIRMED |
| Execution profile confirmed by/at | Owner / 2026-08-10T22:38:28+08:00 / recruit-line-redesign-02 |
| Runtime choice confirmed by/at | Owner / 2026-08-10 / multiple visible HAPI sessions for the redesign batch |
| Execution runtime | hapi |
| Execution control | HAPI Hub helper spawn/inspect/message; visible sessions in Owner sidebar |
| Execution machine | local: id=a15888ad-d405-4884-a407-c28ddd8b397c; host=wusumacdeMac-mini.local |
| Execution flavor | codex |
| Model selection policy | fixed |
| Fixed model/effort | model=gpt-5.6-sol; effort=xhigh |
| Model catalog evidence | codex-cli 0.146.0; native catalog accepted gpt-5.6-sol with xhigh; per-session JSONL retained |
| Execution permission | yolo |
| Permission scope | runtime-only; Human Gates remain |
| Execution visibility | visible |
| Execution fallback | none; failed HAPI spawn remains inbox and is reported |
| Pre-dispatch recovery | Identity/runtime failure before ACK with clean worktree and zero Goal edits is PMO-owned recovery, not a product attempt; retry automatically while runtime/scope/model/permission/cost remain unchanged |
| Monitoring wait primitive | HAPI completion/blocker event + real timer cell; startup 90s, steady 600s; resume only with functions.wait(real cell_id) |
| Monitoring observe primitive | inspect_peer/session metadata/messages + exact task ledger reconciliation |
| Monitoring target evidence | Systems R5 HAPI a0ea4f06-a73d-47c4-bc0d-dad36c6d735d active; Experience attempt-1 c52000b5 archived INVALID, replacement pending |
共享文件锁
PMO 独占 .agent-taskgraph/、root README/AGENTS and cross-domain indexes. ABG-V2-CORE-SYSTEMS exclusively writes four named files under docs/product/; ABG-V2-CONTENT-MATRIX exclusively writes docs/content/; UX, art and audio workers each own disjoint named files under docs/presentation/; the validator owns only docs/reviews/DESIGN_VALIDATION_CONTRACT.md and tools/validate_predevelopment_design.py. R3 repair reuses disjoint owners: UX writes the two UX authorities, art writes only the art catalog, audio writes only the audio catalog, reference writes only TRANSFERABLE_STRUCTURE_LESSONS.md, validator writes only its contract/tool, and Systems writes only ECONOMY_AND_BALANCE.md plus the new anti-dominance fixture/script. No worker edits docs/prototype/ in this batch.
岗位工作区映射
| 岗位 | 负责模块/目录 | 常用验收命令 |
|---|---|---|
| reference-researcher | docs/reference/ |
evidence labels and local-link audit |
| systems-designer | docs/product/ |
contract consistency and decision audit |
| content-architect | docs/content/ |
exact-count/cross-reference/no-filler audit |
| presentation-designer | docs/presentation/, docs/prototype/ |
state/screen/asset coverage |
| independent-reviewer | docs/reviews/ |
fixed-revision read-only review |
本机环境
| 能力 | 状态 | 说明 |
|---|---|---|
| Git/worktree | ✅ | clean main; two redesign worktrees will bind to the PMO baseline commit |
| codex 登录 | ✅ | codex-cli 0.146.0 |
| 开新会话可用路径 | ✅ | HAPI Hub local runner READY; spawn/inspect/message/catalog verified |
| Owner 可见性偏好 | 所有本批 worker/reviewer 均 HAPI 可见 | |
| codex 线程工具 | 宿主未暴露 create_thread；使用正式 HAPI Hub spawn，不使用不可见 spawn_agent 冒充会话 | |
| 监控机制登记 | R5 dual review active after exact ACKs; startup 90s then steady 600s |
归档约定
STATUS 由 queue/ledger 派生；完成任务按月归档，聊天不作为唯一事实源。