gda-demo-e2e
Skill1 starsChanged 17 days agoMITView on GitHub
以 demo/<名称> 为场地,用 GDA 完成一轮端到端开发或验收,产出问题记录、优化建议与递归闭环证据;触发词:端到端测试、e2e、跑一轮验收、验收 demo、用 GDA 开发这个 demo、测试 GDA 工具表现、递归优化闭环、指定某个 demo 做端到端。
In this repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- cpp-registrationSkill
- domain-tool-authoringSkill
- gda-e2e-analysisSkill
- skill-proposerSkill
- thread-security-gateSkill
- wiki-maintainerSkill
- godot-autopilot-contentSkill
- godot-autopilot-csharpSkill
- godot-autopilot-resourcesSkill
- godot-autopilot-runtimeSkill
- godot-autopilot-scene-systemSkill
- godot-autopilot-scriptingSkill
- godot-autopilot-serversSkill
- godot-autopilotSkill
- godot-autopilot-toolsSkill
The file
Files
Demo 端到端验收
读取 demo 工程,用 GDA 完成一轮真实开发或验收,记录过程、问题与优化建议。只做在线探索与证据沉淀;不分析 GDA 源码,不修改 GDA 本体。
输入
- 识别 demo 标识;支持
pink_man_adventure与demo/pink_man_adventure两种写法。 - 接收可选的本轮聚焦目标,例如「只验证场景与脚本工具」;未给出时按 demo 的任务书完整推进。
- 未收到 demo 标识时,列出
demo/*并停止;不默认选一个。
1. 校验输入
- 规范化到
<repo>/demo/<name>。 - 校验
project.godot;缺失时报错、列出demo/*中的工程并停止。 - 校验
docs/;缺失时只做运行与观测验收,并在报告中注明无设计文档。
2. 读任务书
按顺序读取;后读文档不覆盖先读文档的硬约束:
docs/README.md:项目说明与阅读路径。docs/test/test-plan.md:任务性质、测试约定、证据要求、问题格式、终止条件。docs/test/acceptance.md:验收清单。- 按 test-plan 的阅读路径补读
docs/gdd/、docs/tech/、docs/art/中与本轮相关的页面。 - 若
report/<demo>/最近一轮存在analysis.md,只读取其中的「待下一轮端到端验证项」,作为本轮附加观察点;文件缺失时继续执行,不阻塞,不改变 test-plan。
判定任务形态:
- 开发型:工程为空或文档要求从零实现。仅经 GDA 创建和修改工程文件。
- 验收型:工程已建成且 test-plan 要求只读运行与核对。保持工程文件只读。
优先遵循 demo 文档的项目约定;与本技能默认流程冲突时,以 demo 文档为准,并在报告中记录冲突。
按 demo 文档定位素材与资源,不假设固定目录。开发型只读查阅 *.tscn、*.tres、project.godot 用于核对与截图验证;不手动修改。
执行期边界
只做测试与记录,不做 GDA 源码分析;把源码分析留给报告产出后的独立阶段。
只读取:
demo/<name>/下的文档、素材、project.godot、*.tscn、*.tres、*.gd,用于只读核对。- 本轮
report/<demo>/<YYYY-MM-DD-HH-mm>/下的报告、证据与截图。 - GDA 工具返回的日志、轨迹、错误信息。
demo/<name>/.agents/skills/godot-autopilot-*(若存在),仅用于查工具用法。
禁止读取:
- 本仓库的
src/、skills/、docs/wiki/、AGENTS.md、cli/、tests/。 - 仓库根
.agents/skills/下除本技能规则外的内容。 - GDA 的构建、测试与实现代码。
把文件搜索与通配扫描限定在 demo/<name>/ 与本轮报告目录内;不使用仓库根递归搜索。
只执行 uv run main.py build 与 uv run main.py deploy --demos <name> 完成构建与部署;读取命令输出,不读 scripts/ 或源码实现。
遇到工具失败、行为异常或疑似缺陷时:
- 按五要素记录问题,附 trace 与截图。
- 不读源码定位根因。
- 在报告中标记「待分析」,留给后续根因分析阶段。
以下动作只在报告产出后的分析阶段执行;本轮出现时立即停止:打开 src/、docs/wiki/、AGENTS.md、cli/、tests/;查看 GDA 的 git 历史或实现;修改 GDA 源码或技能文件。
3. 前置检查
先在仓库根执行固定的 CLI 探针序列(只读,不修改配置;
gda指本仓库 CLI,见cli/bin/gda.ts):顺序 命令 通过判据 1 gda status退出码 0,返回 running=true2 gda call get_engine_version退出码 0,返回引擎版本 3 gda call system_status(连续两次)两次均退出码 0 任一探针失败时:记录命令、退出码(0 成功 / 1 工具失败 / 2 传输或环境失败 / 3 用法错误)与
gda endpoints的输出(端口来源、MCP/API 地址与alive),再按下列判据分流,不自行启动或重启 Godot:- CLI 成功而后续 MCP 工具调用失败 → 客户端路径问题(客户端连接、协议或授权),GDA 本体可用;
- CLI 与客户端都失败且
gda endpoints显示端口无监听 → 查 Windows 事件日志与%LOCALAPPDATA%\CrashDumps,在报告中如实记录后再判断是否停止。
- 确认
addons/godot-autopilot/已部署。缺失时在仓库根执行:uv run main.py builduv run main.py deploy --demos <name>
- 调用
system_status,要求running=true。不可达时停止,说明需要打开 Godot 编辑器并启用插件;部署后仍不可达时请用户重新打开工程或启用插件。不自行启动或重启 Godot。 - 记录基线:开始时间、
system_status.version、get_engine_version、git rev-parse --short HEAD。 - 用
execute_script读取GODOT_AUTOPILOT_TRACE_DIR与GODOT_AUTOPILOT_LOG_DIR。被授权门拒绝时,记录「轨迹不可得」及原因,继续执行,不推测。 - 以
search_tools的返回确认工具名与参数,不凭记忆调用。
4. 执行
- 按 demo 的 test-plan 推进;无 test-plan 时按「搭 → 写 → 看 → 定」四拍推进:先搭场景与调整,再写脚本与挂载,再运行调试,据结果进入下一轮。
- 单环只做一个功能增量,不合并多个功能。
- 每环开始前记录基线:同条件截图、读回值或日志。
- 每环的「看」必须产生证据:结构类用编辑器截图,运行类用游戏截图,逻辑类用读回值或日志。
- 改动后用与基线相同的条件复测,记录行为差异;不只写「通过」,必须提供基线 vs 改动后的可比证据。
- 失败时区分「改动无效」与「引入回归」;回退引入回归的改动,只回滚本环。
- 本环验收项全过才进入下一环。
- 当场微调手感与数值问题并复验;不带病进入下一环。
- 存在本轮聚焦目标时优先覆盖该目标,同时交付一个可运行、可复验的增量。
5. 过程记录
- 开始执行前创建本轮目录(见第 8 节)与其中的
report.md,写入标题、基本信息与「执行过程」标题。 - 每环结束立即在「执行过程」追加一段:环号、目标、基线证据、关键动作、改动后证据、行为差异、截图相对路径、发现的问题。
- 随做随写报告;不凭印象补写。
- 不抄录全量调用序列;只摘录支撑结论的关键事件(工具名、参数摘要、ok、error_code、duration_ms、request_id)。
6. 证据
| 证据 | 来源 | 用途 |
GDA 轨迹 trace-*.jsonl | GODOT_AUTOPILOT_TRACE_DIR | 调用序列、耗时、错误码、参数摘要 |
GDA 日志 gda-*.log | GODOT_AUTOPILOT_LOG_DIR | 人类可读的失败上下文 |
| 截图 | 本轮目录 img/ | 结构、画面、菜单与行为 |
| 读回值 | 工具返回 | 逻辑断言 |
| 对照证据 | 基线 vs 改动后的成对截图/读回值/日志 | 证明行为差异,区分修复与回归 |
- 在报告中注明轨迹默认脱敏:参数截断到 4000 字符、敏感键替换;截图默认不写入轨迹。
- 轨迹保留最近 20 文件 / 50MB。结束前把本轮关键事件摘录到本轮目录
evidence.md:工具名、参数摘要、ok、error_code、duration_ms、request_id、对应截图。不复制完整trace-*.jsonl与gda-*.log。 - 在报告与
evidence.md中记录原始轨迹与日志路径,用<集中根>/projects/...占位;不写真实用户名或本机绝对路径。 - 用相对路径引用报告与
evidence.md中的截图;原始轨迹/日志只作可追溯来源,不要求轮目录内存在副本。 - 涉及画面效果时看截图验收;不用逻辑断言替代截图。
7. 评估
从资深使用者与开发者视角评估 GDA;记录不足与良好表现;不找茬、不夸大。把影响推进的负面表现登记为第 4 节的带编号问题条目;第 3 节只做归纳,不留无法追溯的结论。
按以下维度选用;无发现的维度跳过;不凑数:
现有工具与 Skill 优化、工具完备性、参数与数据合理性、日志、步骤合并/快捷工具、错误处理与恢复、性能与效率、一致性与幂等性、可发现性与文档、可组合性与工作流、上下文感知与状态管理、安全与权限、兼容性与版本适配、可测试性与验证、可视化与反馈、可扩展性、资源/场景/脚本操作覆盖、版本控制友好、任务规划与自主性、与 Godot 原生工作流对比、工具粒度与依赖、返回值结构化与机器可读。
按以下规则编号并标注问题:
- 给每条问题分配唯一编号
Q1、Q2…,编号在本轮内唯一且连续。 - 标注类型:失败 / 缺陷 / 体验 / 文档。
- 标注可复用性:通用 / 本工程。通用指换一个 demo 仍可复现;本工程指仅在当前 demo、当前环境或本次会话出现。
按五要素记录每个问题:
- 触发场景
- 详细操作步骤
- 预期行为
- 实际表现(附证据)
- 问题分析(只基于本轮可观察证据;不读 GDA 源码补全根因,根因结论标记「待分析」)
按以下格式写问题条目:
### Q1 [失败] <一句话标题>
- 触发场景:
- 操作步骤:
- 预期行为:
- 实际表现:
- 问题分析:
- 可复用性:通用 | 本工程
- trace:`<文件名>#seq=<n> | <tool> | ok=<bool> | error_code=<...> | duration_ms=<...> | request_id=<...>`
- 截图:`img/<文件名>`8. 报告
- 把本轮目录设为
report/<demo>/<YYYY-MM-DD-HH-mm>/;取本地开始时间;目录已存在时追加-2、-3,不覆盖已有轮次。 - 在本轮目录写
report.md(目录已带时间,文件名固定)。 - 在本轮目录写
img/(截图)与evidence.md(关键事件摘录);其他本轮产物同样放本轮目录,不写入共享目录。 - 只写
report.md、evidence.md、img/;不创建、不改写analysis.md;本轮结束后不再改写这些文件。 - demo 文档若写
report/<ts>-report.md或report/img/,以本技能路径为准,并在报告中说明覆盖。 - 按以下结构写报告:
# <demo> 端到端测试报告
- 开始时间 / 结束时间 / GDA 版本 / Godot 版本 / git HEAD / 任务类型 / 完成度
- 轨迹:`<集中根>/projects/...`(关键事件见 `evidence.md`)
- 日志:`<集中根>/projects/...`
## 1. 结论摘要
## 2. 执行过程(每环一段,随做随写)
## 3. GDA 工具表现评估(按选用的维度)
## 4. 问题记录(Q1、Q2…;类型 + 可复用性 + 五要素 + trace 引用 + 截图)
## 5. 优化建议(S1、S2…;按优先级,每条含实际收益、触发场景、验证方式)
## 6. 递归闭环产出(经验条目、优化提案、验证方式、下轮建议)
## 7. 通用事实 vs 本工程偶然现象
## 8. 证据索引(截图、trace/log 路径、未覆盖项)按以下规则写优化建议:
- 给每条建议分配
S1、S2…,便于后续逐项评估。 - 只写同时满足以下条件的建议:
- 当前开发实际遇到并影响推进;
- 能说明实际收益与触发场景;
- 能说明验证方式;
- 不是过度设计或理论上的「最好有」。
- 按优先级排序:阻塞开发 > 显著降低效率 > 影响结果正确性 > 提升长期可维护性。
9. 递归优化闭环
本轮只执行「在线探索」与「证据沉淀」;把「离线评估」与「部署改进」留给后续轮次,并在执行前取得用户明确授权。
- 用真实开发动作、轨迹与报告完成在线探索与证据沉淀。
- 把
report/下所有 demo 的轮目录作为证据池,跨轮累积;每轮目录自包含报告、截图、关键事件摘录、对照证据与后续analysis.md(若存在);不新建索引文件。 - 每轮结束向证据池新增一条可回放记录:本轮
report.md、evidence.md、关键对照(Q 编号与基线/改动后差异)、analysis.md(若存在)。历史证据不足时,由后续分析阶段用最小复现代替回放,并在报告中注明。 - 在报告第 7 节区分:
- GDA 通用事实:换 demo 或工程仍成立,写明复现条件。
- 本工程偶然现象:仅在本 demo、本次会话或当前环境出现,写明未跨工程验证。
文件契约(自包含)
只通过文件系统与后续流程配合;不依赖任何其他技能。
- 接收输入:
demo/<name>/、docs/、同一 demo 的历史轮目录。 - 写出输出:
report/<demo>/<YYYY-MM-DD-HH-mm>/report.md、同目录evidence.md、img/;每环的基线/改动后对照证据。 - 若同 demo 最近一轮存在
analysis.md,只读取「待下一轮端到端验证项」。 - 不写
analysis.md;不修改已有轮目录中的文件。 - 按
Q<n>编号问题、S<n>编号建议;标注问题类型与可复用性(通用/本工程)。 - 提供可回放的报告、证据与对照材料,供后续离线评估;不复制完整轨迹。
- 测试期只读
demo/、本轮报告目录与 GDA 工具输出;把 GDA 源码、docs/wiki/、AGENTS.md、cli/、tests/留给分析阶段。
10. 禁止事项
- 禁止绕过 GDA 手动编辑任何 Godot 工程文件(
*.tscn、*.tres、*.gd、project.godot等)。 - 禁止主动重启 Godot;引擎崩溃时停止并如实记录。
- 禁止更新
docs/wiki/、AGENTS.md或技能文件;禁止修改 GDA 源码。 - 禁止编造、夸大或凭印象补写工具表现与调用记录。
- 禁止为凑评估维度硬评,禁止把理论上的「最好有」写成优化建议。
- 禁止提交 git。
11. 终止与收尾
出现以下情况时立即停止并转入报告:
- GDA 功能缺失或致命缺陷导致无法继续开发;
- Godot 崩溃;
- 前置检查失败且无法在不违反约束的前提下恢复。
收尾前逐项核对:
- 轮目录名为
YYYY-MM-DD-HH-mm(零填充),可按目录名排序取最新; - 本轮目录包含
report.md、img/、evidence.md,报告内截图引用均为相对路径; - 报告 8 节齐全,问题均有证据;
- 问题编号唯一、类型与可复用性标注齐全,写入边界未被越界;
- 每环有基线 vs 改动后的成对对照证据,引入回归的改动已回退;
- 证据池已登记本轮可回放材料;
- 本轮未读取 GDA 源码、
docs/wiki/、AGENTS.md、cli/、tests/;疑似缺陷均标记「待分析」; - 截图文件存在且报告中标注对应环号与验收项;
- 原始轨迹/日志路径已记录,关键事件已写入
evidence.md; - 遗留问题、未覆盖项与下一轮建议已写入报告。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

