93 lines
5.6 KiB
Markdown
93 lines
5.6 KiB
Markdown
# 项目档案:Aetherbound Guild
|
|
|
|
## 是什么
|
|
|
|
`Aetherbound Guild / 裂脉远征团` 是原创横屏 2D 日系手绘魔法公会自动战斗游戏。
|
|
Phase 8 产品设计已建立;Phase 9 正在用 Godot 逐模块实现。P9.0R10 已证明任意两名
|
|
初始 Recruit 都能完成前两战,P9.1 要把六种组合接入同一条完整首局,并拆分单体运行时。
|
|
|
|
## 当前技术栈与结构
|
|
|
|
- Godot 4.6.1,横屏移动端,中文优先,真实运行时代码位于 `runtime/`。
|
|
- `runtime/main.gd` 当前约 3700 行,是 P9.1 必须降低的协作和回归风险。
|
|
- `docs/product/` 与 `docs/presentation/` 是完整设计权威;P9.1 只落地首局薄切片。
|
|
- `prototype/` 是已接受的 HTML 设计参考,不是当前游戏实现。
|
|
- `.agent-taskgraph/` 由 PMO 独占;worker 不修改队列、角色、状态和决策台账。
|
|
|
|
## 当前批次
|
|
|
|
| 配置 | 已确认值 |
|
|
|---|---|
|
|
| 批次 | `abg-p9-1-continuous-development-01` |
|
|
| Agent TaskGraph 协议版本 | 0.8.0-beta.12 |
|
|
| Source baseline | READY: accepted product `41204acafa911a505f5b24a493aa032983e706d1`; PMO specification integration starts from clean/upstream `7bc871d` |
|
|
| Frozen spec | `.agent-taskgraph/spec.md` revision `p9.1-spec-r2`; implementation contract `p9.1-contract-r2` |
|
|
| 当前阶段 | 三份规格已汇合;下一阶段为独占 foundation 与并行代表性视觉切片 |
|
|
| 最大同时工作会话 | 3 个 worker;PMO 独立监督 |
|
|
| Owner 授权 | 2026-08-13:使用 agent graph,并行安排策划、技术架构、设计师和多个开发 |
|
|
| Human Gates | 玩法理解、乐趣、视觉、听感、物理设备、打包、商店与发布 |
|
|
| 已启用可选适配器 | HAPI:本批 worker/reviewer 必须用户可见、可接管 |
|
|
| Paid image boundary | Owner standing approval reaffirmed 2026-08-13; current P9.1 visual slice only, <=4 paid calls and <=USD 5 including retries |
|
|
|
|
## Execution Profile
|
|
|
|
| Execution profile | Confirmed value |
|
|
|---|---|
|
|
| Execution profile status | CONFIRMED |
|
|
| Execution profile confirmed by/at | Owner / 2026-08-13 / current P9.1 request |
|
|
| Runtime choice confirmed by/at | Owner / visible HAPI sessions requested for agent graph |
|
|
| Execution runtime | hapi |
|
|
| Execution control | HAPI Hub helper spawn/inspect/message; Owner sidebar visible and takeover-capable |
|
|
| 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 | HAPI runner catalog VERIFIED 2026-08-13T00:40:01Z: `gpt-5.6-sol` supports `xhigh`; permission catalog includes `yolo` |
|
|
| Execution permission | yolo |
|
|
| Permission scope | Runtime session bypass only; Goal Frozen and all Human Gates remain |
|
|
| Execution visibility | visible |
|
|
| Execution fallback | none; HAPI control-plane failure leaves tasks in inbox |
|
|
| Pre-dispatch recovery | Clean, zero-edit runtime/identity failure may be retried without consuming a product attempt |
|
|
| Monitoring wait primitive | HAPI completion/blocker event + real timer cell; steady interval 600s |
|
|
| Monitoring observe primitive | `inspect_peer`/Hub metadata/messages + task ledger reconciliation |
|
|
| Monitoring target evidence | Current P9.1 HAPI Session IDs from active/review ledgers only |
|
|
|
|
Every new session requires fresh `runtime-evidence.json`, a delivered Role bootstrap and the exact
|
|
`IDENTITY_READY` before its task becomes active. A CLI binary or historical session is not proof.
|
|
|
|
## 共享写入边界
|
|
|
|
- PMO only: `.agent-taskgraph/`, `CURRENT_CHECKPOINT.md`, P9.1 parent Goal/contract and acceptance records.
|
|
- Expert wave produced three separate Markdown outputs under `docs/runtime/p9_1/`; PMO reconciles them into the frozen P9.1 contract.
|
|
- Foundation worker alone may extract shared APIs and change `runtime/main.gd` during extraction.
|
|
- The UX/visual role may prepare the bounded representative visual slice without editing runtime source.
|
|
- Domain, UI and test workers run after foundation integration and own disjoint paths.
|
|
- Integration worker alone wires parallel products into shared entry and runner files.
|
|
- Reviewer is read-only. H5 publishing occurs only after reviewer PASS.
|
|
|
|
## 岗位工作区映射
|
|
|
|
| 岗位 | 负责范围 | 验收重点 |
|
|
|---|---|---|
|
|
| p91-game-designer | `docs/runtime/p9_1/GAMEPLAY_EXPERIENCE_SPEC.md` | 六组合首局、状态依赖选择、完整结果 |
|
|
| p91-ux-visual-designer | `docs/runtime/p9_1/UX_VISUAL_FLOW_SPEC.md` | 页面/状态/中文因果文案/横屏层级 |
|
|
| p91-runtime-architect | `docs/runtime/p9_1/RUNTIME_ARCHITECTURE_SPEC.md` | API、状态所有权、拆分次序、测试接缝 |
|
|
| p91-runtime-foundation-developer | shared runtime extraction | 行为等价、回归安全、并行写入面 |
|
|
| p91-domain-developer | `runtime/domain/p9_1/` | 任意组合的规则与事务 |
|
|
| p91-ui-developer | `runtime/ui/p9_1/` | 真实 Godot 页面与状态呈现 |
|
|
| p91-test-developer | P9.1 tests/capture helpers | 矩阵、触摸、布局、严格诊断 |
|
|
| p91-integration-developer | integration-owned shared files | 完整首局、全回归、H5 预览 |
|
|
| p91-independent-reviewer | read-only fixed revision | PASS/FAIL/INVALID |
|
|
|
|
## 本机资源事实
|
|
|
|
- P9.0R10 product source: `41204acafa911a505f5b24a493aa032983e706d1`。
|
|
- P9.0R10 closure: `f0b7d7b0234d8ad304f7b9d39fa99ded1dbfc27d`。
|
|
- 当前没有本批次拥有的 Godot/Xcode/sign/upload 进程。
|
|
- 其他项目进程不是本批资源,不能终止或归为本批失败。
|
|
|
|
## 归档
|
|
|
|
先前 `recruit-line-redesign-02` 的完整状态保存在
|
|
`.agent-taskgraph/archive/recruit-line-redesign-02/`,只作为历史证据,不参与 P9.1 状态计算。
|