genie MCP

不会写代码？没关系。说出你想要的 App，剩下的交给神灯。

30 秒看懂 · 流程 · 架构 · 安装 · 支持的 Agent · 分流表

✨ 30 秒看懂

你：/wish 做一个出海的 AI 记账 iPhone App，拍小票自动识别，要能订阅付费

🪔 神灯已亮。
🔮 解梦  → iOS 原生 · 海外 · AI + 支付 + 账号 · 复杂度 M
🧭 分流  → SwiftUI + Supabase + Edge Function 调 Claude + RevenueCat + XCUITest
📜 铸约  → 5 条用户故事、4 张表（含 RLS）、3 个函数、端到端链路全部写清
🎨 造梦  → 「温暖治愈」主题，亮/暗双色，5 个页面原型已截图走查
⚒️ 施法  → 编码 → xcodebuild 构建通过
🧪 试炼  → 单元测试 18/18 · UI 测试 6/6 · 截图 12 张
🌟 兑现  → 兑现度 96/100 🌟🌟🌟 神灯满愿 · 交付报告与愿望证书已生成

↑ 示意流程。真实运行时每一步都会落盘产物，你随时可以打开看。

Related MCP server: Agent Harness Kit

🪄 一个愿望是怎么变成 App 的

整个过程只打扰你两次：不确定国内还是海外时问一次，技术契约写好后确认一次。中途要装软件、要你的云账号或要花钱时，也会先问你。

🧭 技术栈分流：神灯怎么替你做选择

几个真实的分流例子（来自自带的回归测试）：

完整分流表见 docs/STACK_MATRIX.md（平台层 × 区域层 × 功能模块 × AI 调用铁律）。

🏛 架构

一句话：Skill 负责「想」和「做」，MCP 负责「算」和「记」。

• Skill（大脑）：告诉 AI 每个阶段该做什么、做到什么程度才算完。AI 读规程、写代码、跑命令、调用其他工具。

• genie MCP（神灯）：所有需要「稳定、可复现」的东西都在这里——分流规则、技术栈组合、契约骨架、设计令牌、流水线状态、测试记录、兑现度计算、报告生成。零依赖，Node.js 直接跑。

• 规程也装进了 MCP：不支持 Skill 的 agent 通过 wish_guide 工具读同一份规程，所以只要能接 MCP 就能许愿。

• 状态落盘：一切记录在你项目的 .wish/ 里，关掉电脑明天接着许。

makeawish/
├── install.mjs              一键接入各家 agent
├── mcp/
│   ├── server.mjs           🪔 genie MCP（11 个工具 + /wish 提示词）
│   └── lib/                 triage 分流 · route 组栈 · spec 契约 · design 令牌
│                            deliver 报告证书 · workspace 状态机
├── matrix/stacks.json       📚 技术栈分流表（唯一数据源）
├── skills/makeawish/        🧠 总控 skill + references/01-06 阶段规程
├── commands/                /wish · /wish-status · /wish-matrix（Claude Code、Gemini）
├── agents/wish-qa.md        🧪 试炼官子 agent：独立跑 UI 测试
├── .claude-plugin/          Claude Code 插件 & 插件市场清单
├── gemini-extension.json    Gemini CLI 扩展
├── qwen-extension.json      Qwen Code 扩展
├── GEMINI.md · QWEN.md      扩展上下文
└── scripts/                 smoke.mjs 冒烟测试 · render-matrix.mjs · draw-diagrams.mjs

另外提供 MCP 提示词 wish，在支持 MCP prompts 的客户端里就是一个 /wish 命令。

📦 安装

需要 Node.js ≥ 20。没有别的依赖。

第 1 步：下载

点本页右上角绿色的 Code → Download ZIP，解压后把文件夹改名为 makeawish，放到你的用户目录下（也就是 ~/makeawish）。会用 git 的话，直接把本仓库 clone 到同一位置。

第 2 步：一键接入你电脑上所有的 AI 编程助手

node ~/makeawish/install.mjs all

第 3 步：重启 agent，然后说

我想做一个……

想只装某一个，把 all 换成名字就行，比如 node ~/makeawish/install.mjs cursor。加 --project <你的项目目录> 会同时写入项目规则，让 agent 更主动地触发许愿；加 --dry-run 只看不装。

🤝 支持的 Agent

✅ 已验证：在真实 CLI 中完成安装并确认 genie MCP 连接成功。🧪 社区适配：按各家公开的配置格式实现，欢迎提 Issue 反馈。

Claude Code 用户也可以把下载好的文件夹当作插件市场添加：

claude plugin marketplace add ~/makeawish

claude plugin install makeawish@makeawish

🌟 兑现度与愿望证书

神灯不会自己说「做完了」。交付时按下面的规则打分：

≥95 🌟🌟🌟 神灯满愿 · ≥80 🌟🌟 愿望成真 · ≥60 🌟 初步显灵 · 其余 💨 法力不足

没有构建记录、或者带界面却没做 UI 测试的应用，不算兑现。最后会生成 DELIVERY.md 交付报告，和一张带 UI 截图的 certificate.html 愿望兑现证书。

❓ 常见问题

能。你只需要会描述你想要什么。神灯会在需要你做决定的时候用选择题问你（比如「主要给国内用户还是海外用户？」），其他的它自己搞定。不过最后上架应用商店、绑定域名这类需要你本人账号的事，还是得你自己点。

面向海外用户默认用 Supabase（数据库、登录、存储一站式）+ Claude 模型 + Stripe / 应用内购买；面向国内用户默认用腾讯云 CloudBase + 混元 / DeepSeek 等国内模型 + 微信 / 支付宝，并提醒你备案和隐私合规。

不会。装软件、用你的云账号、任何可能产生费用的操作，都会先列出来问你。密钥也不会让你贴在聊天里，而是让你自己写进本地配置文件。

一次许愿聚焦一个 MVP（通常 3–5 个核心功能）。做完后交付报告里会附上「下一个愿望」建议，继续许就行。复杂度高的愿望，Claude Code 下会拆成多个模块并行施法。

只要它支持 MCP，就运行 node install.mjs print，把输出的配置和规则粘贴进去即可。规程本身也通过 MCP 提供，不依赖 Skill 功能。

🛠 开发

npm test

冒烟测试会启动 genie MCP，走完整条许愿流水线，并对分流引擎跑回归用例。修改 matrix/stacks.json 后运行 npm run matrix 重新生成分流表文档；README 里的图由 npm run diagrams 生成（scripts/draw-diagrams.mjs）。

📄 License

MIT