游戏系统策划多智能体工作流。基于 UI 参考图，自动完成需求拆解、策划案撰写、规范审查的全流程。触发词：写策划案、设计系统、系统设计、策划文档、需求文档、审查策划案、规范审查、修改策划案、逆向需求。
游戏系统策划多智能体工作流。基于 UI 参考图，自动完成需求拆解、策划案撰写、规范审查的全流程。触发词：写策划案、设计系统、系统设计、策划文档、需求文档、审查策划案、规范审查、修改策划案、逆向需求。
npx skills add https://github.com/Gnc0/system-designer --skill system-designer复制此命令并粘贴到 Claude Code 中以安装该技能
| name | system-designer |
| description | 游戏系统策划多智能体工作流。基于 UI 参考图，自动完成需求拆解、策划案撰写、规范审查的全流程。触发词：写策划案、设计系统、系统设计、策划文档、需求文档、审查策划案、规范审查、修改策划案、逆向需求。 |
| 术语 | 含义 |
|---|---|
| 策划案 | 系统策划文档，描述游戏内功能系统的完整设计 |
| 需求 Draft | 从 UI 参考图提取的结构化需求草案 |
| 规范审查 | 对策划案的格式、语言、逻辑进行合规性检查 |
| session_id | 本次任务的唯一标识，格式 %Y%m%d_%H%M%S |
docs/ 目录edit 工具编辑策划案文件。禁止由主线程直接修改subagent 工具的 SINGLE 模式调用~/.pi/agent/agents/sd-*.md）task 参数只包含用户数据，禁止附加与 agent system prompt 冲突的指令| 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（交互设计规范） |
通过 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.pngvision_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 审查。