gnc0 业务规则
术语
| 术语 | 含义 |
|---|---|
| 策划案 | 系统策划文档，描述游戏内功能系统的完整设计 |
| 需求 Draft | 从 UI 参考图提取的结构化需求草案 |
| 规范审查 | 对策划案的格式、语言、逻辑进行合规性检查 |
| session_id | 本次任务的唯一标识，格式 %Y%m%d_%H%M%S |
约束
- 永远不要在没有 UI 参考图的情况下开始写策划案（至少需要图片或文字描述之一）
- 永远不要跳过用户对需求 Draft 的确认步骤
- 所有子代理通过 agent 名称直接调用（sd-writer / sd-mda / sd-reviewer），禁止 read prompt 文件再传入
- 所有生成的策划案必须保存到
docs/目录 - 规范审查后如有修改：必须先经用户确认，再启动子代理用
edit工具编辑策划案文件。禁止由主线程直接修改 - 最小化修改原则：如果需要修改skill.md，请最小化修改，不要全量优化。
子代理调用
- 使用
subagent工具的 SINGLE 模式调用 - system prompt 由 pi 框架自动注入（
~/.pi/agent/agents/sd-*.md） task参数只包含用户数据，禁止附加与 agent system prompt 冲突的指令
Agent 定义
| Agent | 用途 | 内部规范 |
|---|---|---|
sd-writer |
策划案撰写/修改 | agents/sd-writer.md（格式、语言、结构等规范） |
sd-mda |
MDA 需求拆解 | agents/sd-mda.md（MDA 拆解规则） |
sd-reviewer |
规范审查 | agents/sd-reviewer.md（审查标准） |
sd-interactive |
客户端交互需求策划案 | agents/sd-interactive.md（交互设计规范） |
vision_describe 调用方式
通过 MCP 服务器将图片转为结构化文字描述，供文本模型理解 UI 图。
vision_describe(image_path: "data/images/{session_id}_ref.png")
vision_describe(image_path: "data/images/{session_id}_ref.png", provider: "kimi", model: "kimi-k2.5")
支持的 provider：kimi / moonshot / anthropic / openai。
不指定 provider 时按 config.json → VISION_PROVIDER 环境变量 → 默认值（kimi）。
API Key 优先级：VISION_API_KEY 环境变量 > config.json。
MCP 服务器需在 pi 的 settings.json 中注册（详见 README.md），配置路径指向 src/vision-describe-mcp/。
工作流
一、写策划案（主流程）
Step 1：获取 UI 参考图
提示语：「请提供该功能的 UI 参考图，可直接在对话中粘贴截图或拖入图片文件。」
Step 1.5：视觉理解（如需）
若主控或子代理无法直接理解图片：
- 保存图片到
data/images/{session_id}_ref.png vision_describe(image_path: "data/images/{session_id}_ref.png")- 将描述文本作为「图片描述」传入后续步骤
Step 2：调用需求拆解（sd-mda）
subagent SINGLE: { agent: "sd-mda", task: "以下是用户提供的 UI 参考图描述和说明：\n\n{图片描述}\n\n{用户补充说明}" }
→ 展示 Draft → 等待用户确认 → 保存为 docs/{session_id}_confirmed_draft.md
Step 3：调用策划案撰写（sd-writer）
subagent SINGLE: { agent: "sd-writer", task: "请根据需求文档撰写策划案。需求文档路径：docs/{session_id}_confirmed_draft.md\n\nsession_id: {session_id}\n\n最后将文件保存为txt文件。" }
Step 4：自动调用规范审查（sd-reviewer）
subagent SINGLE: { agent: "sd-reviewer", task: "请审查以下策划案：docs/{session_id}_{docs_name}.md" }
→ 展示审查报告 → 等待用户确认修改项
二、审查策划案
subagent SINGLE: { agent: "sd-reviewer", task: "请审查以下策划案内容：\n\n{用户粘贴的策划案}" }
三、修改策划案
subagent SINGLE: { agent: "sd-writer", task: "请修改策划案 docs/{session_id}_{docs_name}.md，修改要求：\n\n{用户修改意见}\n\n请使用 edit 工具直接编辑该文件，逐一修正后输出修改摘要。" }
修改后自动调用 sd-reviewer 审查。