现在基于 AGENTS.md、docs/ 和 templates/,实现 Agent GD Studio 的最小客户旅程原型。
- Stable ID:
codex-user-prompt:69c5c5deea528a19
- Source kind:
codex-session-user
- Category:
coding-agent-workflow
- Timestamp:
2026-05-14T13:17:12.610Z
- Semantic hash:
69c5c5deea528a196b7b781e83c43186ab11e67e74a31071e40a91123361727f
- Public handling: selected full-text prompt with secret filtering.
Prompt Text
现在基于 AGENTS.md、docs/ 和 templates/,实现 Agent GD Studio 的最小客户旅程原型。
本轮目标:
做一个本地可运行的最小原型,验证客户从“输入游戏想法”到“生成第一个可执行任务包”的流程。
本轮不是实现完整产品。
本轮不是实现真实多 agent 编排。
本轮不是接入真实 LLM。
本轮不是开发游戏。
本轮不是做复杂 UI。
本轮允许修改或创建:
- src/**
- output/**
- README.md
- package.json
- tsconfig.json
- vite.config.ts 或其他必要的最小运行配置
- tests/** 如果项目已有测试结构
本轮禁止修改:
- AGENTS.md,除非发现明显路径错误
- docs/**,除非发现模板引用路径错误
- templates/**,除非发现模板无法被程序读取
- 任何游戏项目代码
- 任何外部 API 接入
- 任何真实 agent 调度系统
如果你认为必须修改 docs 或 templates,请先在计划中说明原因,只做最小必要修改。
请先检查当前项目结构,然后实现一个最小 CLI 原型。
如果项目已经是 Web 项目,可以实现简单 Web 页面;如果没有明确前端框架,优先实现 CLI,因为 CLI 更小、更稳定。
# 1. 用户流程
CLI 至少支持以下流程:
1. 用户输入一句游戏想法。
示例:
“我想做一个像杀戮尖塔的卡牌游戏,但加入宠物养成。”
2. 系统读取:
- AGENTS.md
- docs/GATES.md
- docs/CLIENT_JOURNEY.md
- templates/CLARIFICATION_TEMPLATE.md
- templates/PROJECT_BRIEF_TEMPLATE.md
- templates/SCOPE_TEMPLATE.md
- templates/MILESTONE_TEMPLATE.md
- templates/TASK_TEMPLATE.md
3. 系统判断该想法是否可直接进入开发。
默认规则:
- 如果缺少核心循环、MVP 范围、目标平台、输入方式、参考游戏借鉴点、验收标准,则判定为 Not executable。
- Not executable 时不得生成开发代码。
- Not executable 时必须生成澄清问题。
4. 系统生成 5-8 个澄清问题。
问题必须尽量是选择题或范围题。
问题必须覆盖:
- 参考游戏具体借鉴点
- 核心循环
- MVP 范围
- 目标平台
- 输入方式
- 战斗或主要玩法方式
- 第一版明确不做什么
5. 用户回答这些问题。
6. 系统根据用户回答生成以下文件:
- output/project_brief.md
- output/scope.md
- output/milestone_plan.md
- output/tasks/TASK-001.md
- output/decision_log.md
7. 系统最后输出:
- 当前项目是否可进入开发
- 如果不可进入开发,说明缺少什么
- 如果可进入下一步,说明 TASK-001 是什么
- 明确提醒:本轮没有生成游戏代码
# 2. 实现要求
请实现确定性逻辑,不要接入 OpenAI API 或其他 LLM。
可以使用简单规则、关键词检测、模板填充、命令行交互来模拟流程。
例如:
- 检测用户是否提到“像/类似/参考”
- 检测是否提到平台:PC、Web、手机、Steam、iOS、Android
- 检测是否提到玩法类型:卡牌、动作、建造、生存、RPG、塔防、解谜等
- 如果缺少某项,就生成对应澄清问题
- 用户回答后,把回答写入对应 artifacts
请优先保证:
- 流程正确
- 输出文件清晰
- 代码简单
- 容易扩展
- 不做过度工程
# 3. 建议文件结构
如果当前项目没有更合适的结构,可以使用:
src/
cli.ts
core/
artifactWriter.ts
clarification.ts
executableCheck.ts
projectBuilder.ts
taskBuilder.ts
templateLoader.ts
types.ts
output/
tasks/
# 4. 核心模块要求
## executableCheck
输入:
- rawIdea: string
- optionalAnswers?: object
输出:
- executable: boolean
- missing: string[]
- reasons: string[]
判断至少覆盖:
- game_type
- reference_borrowing
- core_loop
- platform
- input_method
- mvp_scope
- non_goals
- acceptance_criteria
## clarification
输入:
- missing: string[]
- rawIdea: string
输出:
- questions: ClarificationQuestion[]
ClarificationQuestion 至少包含:
- id
- question
- type: single_choice | multi_choice | short_text
- options
- why_it_matters
## projectBuilder
输入:
- rawIdea
- answers
输出:
- projectBrief markdown
- scope markdown
- milestonePlan markdown
- decisionLog markdown
## taskBuilder
输入:
- projectBrief
- scope
- milestonePlan
- answers
输出:
- TASK-001 markdown
TASK-001 必须符合 templates/TASK_TEMPLATE.md 的字段结构。
TASK-001 的默认目标应该是:
“Create the smallest playable prototype shell for the confirmed MVP direction.”
但它不能实现游戏代码,只是生成未来给执行 agent 的任务包。
# 5. CLI 体验要求
运行方式可以是:
npm run gd:init
或者:
npm run start
CLI 交互示例:
Agent GD Studio
Describe your game idea:
> 我想做一个像杀戮尖塔的卡牌游戏,但加入宠物养成。
Status: Not executable yet.
Reason:
- Reference game is mentioned but borrowable mechanics are unclear.
- MVP scope is missing.
- Platform is missing.
- Input method is missing.
- Acceptance criteria are missing.
Please answer these questions:
1. When you say “like Slay the Spire”, what should be borrowed?
A. Turn-based card combat
B. Map route selection
C. Relic system
D. Deck-building progression
E. Random events
...
After answering, the CLI writes artifacts to output/.
# 6. Tests or verification
如果项目已有测试框架,请添加最小测试覆盖:
- executableCheck detects missing fields
- clarification generates questions for missing fields
- taskBuilder outputs required sections
如果没有测试框架,不要引入复杂测试系统。
可以添加一个简单脚本:
npm run gd:demo
它使用固定示例输入,自动生成 output/ artifacts,方便验证。
# 7. README 更新
请更新 README.md,加入:
- Agent GD Studio 是什么
- 当前原型能做什么
- 如何运行
- 输出文件在哪里
- 当前限制
- 下一步计划
必须明确写出当前限制:
- 不接入真实 LLM
- 不执行游戏代码开发
- 不是真实多 agent 编排
- 只验证客户旅程和 artifact 生成链路
# 8. 完成后输出
完成后请输出:
1. 你实现了什么
2. 创建或修改了哪些文件
3. 如何运行 demo
4. 生成的 artifacts 在哪里
5. 当前原型有哪些限制
6. 下一步建议
重要:
本轮不要实现游戏代码。
本轮不要接入外部 API。
本轮不要把 mock agent 做成复杂框架。
本轮只验证客户旅程。
Reuse Notes
- EXTRACTED: This is a selected Codex prompt or automation prompt from the local Codex corpus.
- INFERRED: Future agents can reuse its structure, constraints, and acceptance criteria when creating similar Codex workflows.