mirror of
https://github.com/motajs/template.git
synced 2026-09-20 06:20:17 +08:00
docs(04): plan hero-mover interface exploration (04-02)
This commit is contained in:
parent
908fbf385b
commit
35a5973cbe
@ -184,8 +184,12 @@ Plans:
|
||||
**Plans**: 1/2 plans executed(第一步·只读对账已完成;第二步·勇士移动接口探索(只读)已规划 — 04-CONTEXT D-01/D-02/D-13/D-17/D-18;后续适配实施与双布局待探索结果与缺失候选裁决后另行规划)
|
||||
|
||||
Plans:
|
||||
**Wave 1**
|
||||
|
||||
- [x] 04-01-PLAN.md — 渲染端 ↔ 数据端接口对账(只读清点,产出 `04-RENDER-INTERFACE-AUDIT.md`;按 ① 错配 / ② 数据端缺失 / ③ 多余旧路径 三类登记)
|
||||
|
||||
**Wave 2** *(blocked on Wave 1 completion)*
|
||||
|
||||
- [ ] 04-02-PLAN.md — 勇士移动接口探索(只读,D-17):产出 `04-HERO-MOVER-INTERFACE.md`(数据端现行接口 / 渲染端现状 / 逐成员三态对账 / 缺失接口候选 / 未确定 / 处置;排除 `HeroRendering`(D-18)与 `core.*`(D-12);不改任何代码,适配(04-03+)未规划)
|
||||
|
||||
**UI hint**: yes
|
||||
|
||||
@ -3,16 +3,16 @@ gsd_state_version: "1.0"
|
||||
milestone: v1.0
|
||||
current_phase: 04
|
||||
current_phase_name: 渲染适配与双布局
|
||||
status: verifying
|
||||
status: executing
|
||||
stopped_at: Completed 04-01-PLAN.md(只读对账账本已交付;阶段 4 剩余工作待用户拆分)
|
||||
last_updated: "2026-09-18T02:52:58.322Z"
|
||||
last_updated: "2026-09-18T04:24:14.367Z"
|
||||
last_activity: 2026-09-18
|
||||
last_activity_desc: Phase 04 execution started
|
||||
state_head: 4327e6733b1e241c3a840a91c63c9c10e860624c
|
||||
state_head: 908fbf385b8517429de5c3095e0b79b46ecd1df6
|
||||
progress:
|
||||
total_phases: 7
|
||||
completed_phases: 0
|
||||
total_plans: 72
|
||||
total_plans: 73
|
||||
completed_plans: 71
|
||||
milestone_name: milestone
|
||||
---
|
||||
@ -28,9 +28,9 @@ See: .planning/PROJECT.md (updated 2026-09-17)
|
||||
|
||||
## Current Position
|
||||
|
||||
Phase: 04 (渲染适配与双布局) — EXECUTING
|
||||
Phase: 04 (渲染适配与双布局) — READY TO EXECUTE
|
||||
Plan: 1 of 1
|
||||
Status: Phase complete — ready for verification
|
||||
Status: Ready to execute
|
||||
Last activity: 2026-09-18 — Phase 04 execution started
|
||||
|
||||
Progress: [█████░░░░░] 50%
|
||||
|
||||
@ -63,6 +63,8 @@ Phase 4 第二个增量(D-17):对**勇士移动子系统**做**只读接
|
||||
|
||||
**后续适配(04-03+)在本 run 不规划**:适配依赖本探索输出,且需用户先裁决缺失候选(D-13/D-17)。
|
||||
|
||||
**后续增量决策(显式延后,本计划不涉及、不实施):** CONTEXT.md 的三项设计补充裁定属于**后续增量**,与本 run 的只读勇士移动接口探索无关,故本计划不规划、不设计、不实施、不裁决它们,留待相应增量规划时另行覆盖:D-14(全局 `hook` 和 `loading` 也是 legacy 内容,需删除)、D-15(存档系统 UI 尚未接入新的存档系统)、D-16(渲染端结构化重构:拆为 `base-system-client` 三层,不再需要 common)。三者均不在本计划的交付物、对账范围或范围门禁内。
|
||||
|
||||
**执行前置关卡(AGENTS.md,第一个 block 点):** 本计划第一个执行步骤是 Task 0 —— 先向用户汇报「本计划要解决的问题 / 大致解决方案 / 范围边界与禁令」,然后**停下等待**用户明确回复「可以执行」四个字。收到该回复前,任何任务都不得执行,也不得派发执行子代理;无论触发方式(`/gsd-execute-phase`、`/gsd-manager`、`/gsd-autonomous`、子代理/执行器派发)或配置模式(`.planning/config.json` 的 `yolo`、`workflow.auto_advance`)如何,均不得自动放行。故本计划 `autonomous: false`。
|
||||
|
||||
Purpose: 勇士移动是本次对账暴露的主要失配点(D-17)。在动适配代码前先把「数据端到底提供什么、渲染端到底需要什么、差在哪」钉死到接口成员级,避免按旧形状直接改渲染端。
|
||||
|
||||
@ -36,6 +36,19 @@
|
||||
### 执行方式
|
||||
- **D-09:** 允许派子代理进行只读扫描(不得修改任何文件)。
|
||||
|
||||
### 设计补充(用户裁定,2026-09-18;仅记录,暂不执行)
|
||||
- **D-10:** `HeroRendering` 删除;渲染端相关的数据存储放到渲染端,渲染端自身也可以继承 `ISaveableContent`。
|
||||
- **D-11:** 诸如 `getHeroStatusOn` 这种裸函数,除非它是功能性函数,或者属于某些已明确的函数(如 replay 的那些修饰器裸函数),否则大多是将要删除的。
|
||||
- **D-12:** 所有调用 `core.*` 或 `client.*` 的地方大多需要删除。现行接口设计倾向**无全局单例**:所有内容全部挂到主类上,主类允许多例。其中 `core.*` 属旧引擎适配,应属于**第五阶段**,暂时可忽略;`client.*` 属于**本阶段**需要处理的内容。
|
||||
- **D-13:** 数据端缺失接口可能较多,等到开始改的时候再逐步确认(本阶段不从对账清单一次性定死缺失接口)。
|
||||
- **D-14:** 全局 `hook` 和 `loading` 也是 legacy 内容,需要删除。
|
||||
- **D-15:** 存档系统的 UI 目前还未接入新的存档系统。
|
||||
- **D-16:** 渲染端还需要进行结构化重构:将渲染端拆为类似数据端的 common-base-system-state 结构,但只需拆为三层——`base-system-client`(不再需要 common)。
|
||||
|
||||
### 下一步聚焦(用户裁定,2026-09-18;待规划)
|
||||
- **D-17:** 由对账结果看,主要失配点在**勇士移动**部分。下一步规划:把**勇士移动适配到新接口**——先进行**接口探索**(并找出缺失的接口),再进行**适配工作**。
|
||||
- **D-18:** `HeroRendering` 相关暂不处理:用户先修改数据端,之后再处理。
|
||||
|
||||
### the agent's Discretion
|
||||
- D-07 的「影响」字段具体写法、「多余旧路径」是否需要进一步细分,交由 AI 在对账执行时按实际情况把握,但不得据此扩大范围。
|
||||
|
||||
|
||||
@ -41,8 +41,8 @@
|
||||
],
|
||||
"next": {
|
||||
"command": "/gsd:progress --next",
|
||||
"label": "Advance to the next step (verify)",
|
||||
"reason": "Phase 04 of 7 · ready to verify"
|
||||
"label": "Advance to the next step",
|
||||
"reason": "Phase 04 of 7 · executing"
|
||||
},
|
||||
"updated_at": "2026-09-18T02:52:40.728Z"
|
||||
"updated_at": "2026-09-18T04:24:14.460Z"
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user