qiaomu-goal-meta-skill是一个面向 Codex 的 Goal 指令生成器：它把一句模糊需求，收敛成可直接复制的/goal命令，内置验证、约束、边界、迭代策略、完成条件和暂停条件。你不需要先填规划表格，它先给推荐执行版，再给几道编号选择题，回一行按默认或1B 2A 3C就能锁定目标。

痛点：为什么 AI 任务总"跑偏"？

很多 agent 任务失败，不是模型不会写代码，而是目标太松：

• "帮我做个 App"
• "修一下这个问题"
• "做得高级一点"

这些话对人类有感觉，对 AI 却缺少四样东西：怎么验证、哪里不能碰、失败后怎么迭代、什么时候必须暂停。

qiaomu-goal-meta-skill 的思路是：让 Codex 开工前先拿到一份"任务合同"，而不是让你先填一堆空白模板。核心规则定义在 SKILL.md 中。

一键安装：懒人也能 30 秒上手

前提：已安装支持 Agent Skills 的运行环境（Codex、Claude Code 等），并有 Node.js 和npx。

npx skills add joeseesun/qiaomu-goal-meta-skill

安装后确认一下路径即可：

test -f ~/.agents/skills/qiaomu-goal-meta-skill/SKILL.md

第一步：先给"推荐执行版"，而不是半填的模板

对中文用户，它默认先输出一段可直接复制的推荐执行版（中文，可直接复制），字段名是中文，但命令前缀保持/goal（不会输出不可执行的/目标）。

一个典型的输出长这样（示例来自 README.md）：

推荐执行版（中文，可直接复制） /goal 基于用户需求创建第一版本地 MVP，先读取项目已有命令和约束，实现核心用户可见流程，并避免改动无关系统。 验证：运行项目提供的最小相关检查，启动本地应用，完整走通一次核心流程，并用日志、截图或命令输出作为证据。 约束：不加入账号、付费服务、生产变更、破坏性操作或无关功能，除非用户明确要求。 边界：只写入新项目目录，或只修改现有项目中与该功能直接相关的文件。 迭代策略：一次实现一个聚焦工作流，每次有意义改动后重跑检查，重试前先读日志，最多做 3 轮聚焦改进后报告剩余风险。 完成条件：核心流程有运行证据证明可用，检查通过或明确说明缺少配置。 暂停条件：需要凭证、付费、生产数据、破坏性操作、法律/医疗/金融判断、版权素材或所有权不清时暂停。

注意它不留下[Outcome]这类占位符——第一个代码块就是能直接贴进 Codex 执行的最优版本。

第二步：一句话默认选择理由，让你知道它为什么这么选

推荐版下面会跟一句默认选择理由，例如：

默认选择理由：先做本地 MVP，因为它能最快验证核心体验，同时避免账号、后端和发布流程拖慢第一版。

这套"默认优先"策略写在 references/default-goal-strategy.md 里：低风险的不确定性，做明确假设直接推进，不拦着你填表。

第三步：选择题懒人策略，3 行回复收敛目标

只有当某个选择会真正改变成本、风险或方向时，它才用编号选择题来问，而不是开放式问卷：

可选调整 1. 项目形态：A 新建本地 MVP（默认） / B 改现有项目 / C 先做原型 2. 范围：A 核心流程（默认） / B 加常见增强 / C 做完整产品 3. 验证：A 本地运行检查（默认） / B 真机或线上检查 / C 发布前检查 你可以直接回复：按默认，或回复类似 1B 2A 3C。

不用写长句，回选项就能继续收敛。问题题库在 references/interview-checklist.md，它覆盖目标结果、验证、约束、边界、迭代策略、停止/暂停六类问题——只问必要的那几个。

四件套：一个 /goal 合同里到底有什么

模板本体定义在 references/goal-command-playbook.md，六个要素各回答一个问题：

几个内置原则值得留意：

• 🎯陌生领域先发现：涉及医疗、金融、合规时，先生成"发现优先"的 goal，先读权威文档和样例数据，不编造领域规则。
• 🧩模糊词不删除，翻译成验证："高级""有质感"会被转成设计方向 + 截图检查 + 最多 3 轮聚焦视觉改进。
• ⏸️高风险才暂停：凭证、支付、生产数据、破坏性操作、上架发布等才会写进暂停条件。

收尾质检：内置 lint 拦掉"弱目标"

仓库自带一个轻量检查脚本 scripts/lint_goal_command.py，生成文件交付前可以跑一遍：

python3 ~/.agents/skills/qiaomu-goal-meta-skill/scripts/lint_goal_command.py goal.txt

它会拦住这些"坏味道"：

• /目标这种不可执行前缀
• [Outcome]、TODO、待定等占位符
• make sure it works、随便改、edit anything、keep trying这类模糊指令
• 缺少具体证据的验证条件、内容过薄的字段

什么时候用，什么时候不用？

✅ 适合：开发网站/App/游戏/插件、修 bug、重构、加测试、跑发布、设计 UI 原型、多步骤研究、把模糊需求变成可执行任务。

❌ 不适合：一句话翻译、简单改写、一行 shell 输出、不需要持续执行和验证的小任务。

另外记住它的边界：这个 skill只创建/goal指令，不默认执行目标本身，也不会替你绕过版权、支付、生产数据或合规判断。

上手话术清单：你可以这样说

• "用 qiaomu-goal-meta-skill 帮我把这个需求写成 Codex /goal。"
• "这个任务太模糊，先给推荐执行版，再给我几个可选调整。"
• "帮我把修 bug 的任务写成带验证和暂停条件的 goal。"
• "这个任务涉及版权素材，帮我写发现优先的 goal。"

常见问题：为什么我的 goal 还是"模板味"？

总结：把"填表时间"还给"执行时间"

qiaomu-goal-meta-skill 的整套设计就三句话：先给可直接复制的推荐版 → 一句话说明默认理由 → 用编号选择题收敛。你最多花 3 行回复的成本，换一份有验证、有边界、知道何时停止的/goal任务合同。如果你还在让 AI 对着空白规划表格发呆，不妨今天就装上试试。