AIAI 工具图鉴
← 返回全部文章
·约 15 分钟PPT

qiaomu-goal-meta-skill

技能插件
下载 PPT下载视频

配套媒体

本页对应的 PPT 与演示视频

qiaomu-goal-meta-skill-recommend.mp4
PPT
qiaomu-goal-meta-skill-recommend.pptx浏览器不能直接打开 PPT，下载后用 PowerPoint / WPS / Keynote 查看
下载没反应？点这里复制直链

侧边栏预览窗口（Electron webview）会拦截下载，把下面的链接复制到 Chrome / Edge 地址栏打开即可保存。

PPT../media/qiaomu-goal-meta-skill.pptx
视频../media/qiaomu-goal-meta-skill.mp4
本文目录
  1. 🚀 什么是 qiaomu-goal-meta-skill？
  2. ✨ 核心功能一览
  3. 🛠️ 快速上手：5 分钟跑通示例
  4. 安装 Skill
  5. 核心代码示例
  6. Lint 检查
  7. 📊 与竞品对比
  8. 💡 适用场景
  9. 场景 1：在 Codex 桌面端直接看到 /goal 模式开关
  10. 场景 2：直接输入 /目标 中文别名触发
  11. 场景 3：真实案例——用 /goal 一比一复刻截图 HTML
  12. 场景 4：仓库 README 自带「为什么值得用」红框清单
  13. 场景 5：一张图说清 Codex /goal 的 5 段流程
  14. 用户群体总结
  15. 💰 定价方案
  16. 🎯 总结

📌 核心价值：把"模糊需求"翻译成 Codex 可持续执行、可验证、可暂停的 /goal 任务合同

不是又一个 Prompt 模板，而是一份带 Linter、带面试清单、带双语文案、带边界保护的目标结构化工程方案。内置六要素（Outcome / Verification / Constraints / Boundaries / Iteration / Stop or Pause）让 Codex 知道什么时候完成、什么时候暂停、什么时候找你。

封面图

🚀 什么是 qiaomu-goal-meta-skill？

qiaomu-goal-meta-skill 是向阳乔木（joeseesun）为 Codex / Claude Code 这类带 /goal 斜杠命令的 Agent 写的一个元技能（Meta Skill）。它本身不直接做业务，而是把"用户随口说的一句话需求"，改写成 Codex 可以长跑、可以验收、可以自我约束的 /goal 指令。

GitHub 数据：⭐ 585 stars，44 forks，MIT 协议，最新发布覆盖 Codex CLI 0.128.0 起新增的 /goal 命令。

GitHub stars GitHub forks

核心定位：当 Codex 升级出 /goal 命令却没人写得稳，qiaomu-goal-meta-skill 把"模糊需求"压成六要素任务合同

它解决三个真实的痛点：

  1. 需求发散：用户说"做个好看点的网站"，Agent 跑三小时可能交付一堆不是用户想要的东西
  2. 验收空洞：提示词只说"做得好一点"，没有 Verification，结果好坏全靠 Agent 心情
  3. 越权风险：没有 Boundaries，Agent 可能顺手改 .env、改主分支、动生产数据

✨ 核心功能一览

功能对比表

功能模块 描述 亮点
目标结构化 把模糊任务收敛成 Outcome + Verification + Constraints + Boundaries + Iteration + Stop/Pause 六要素 强制留白不再发散
中英双语 默认中文为可执行版，再附英文兼容镜像 中文用户友好且兼容英文工具链
内置 Linter scripts/lint_goal_command.py 自动检查必填标签和未替换占位符 上线前最后一道闸
边界保护 显式列允许写入路径和禁止触碰路径 防止 Agent 越权
默认策略 模糊任务自动选保守默认 + 一句理由 减少无意义追问
风险分级 低 / 中 / 高三档，配套不同 Pause 触发条件 把"判断"留给人
双语草案 推荐执行版 + English-compatible Mirror 语义一致 直接复制可用
失败处理 重试 3 轮后必须报剩余风险 防止"瞎重试"循环

🛠️ 快速上手：5 分钟跑通示例

安装 Skill

# 1. 克隆仓库到 Codex 的 skills 目录
git clone https://github.com/joeseesun/qiaomu-goal-meta-skill.git \
    ~/.codex/skills/qiaomu-goal-meta-skill

# 2. 在 Codex / Claude Code 中启用
# /skills list  → 看到 qiaomu-goal-meta-skill 即生效

核心代码示例

直接调用 skill，让它把一句模糊需求改写成 /goal：

用户输入：
/plan 我想做一个好看的播客 App，能用就行，先别管后端。

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

注意：第一段永远是「推荐执行版」，不是半填模板——用户通常直接复制第一段就开跑

Lint 检查

# 提交 /goal 之前跑一遍 lint
python3 ~/.codex/skills/qiaomu-goal-meta-skill/scripts/lint_goal_command.py \
    my-goal.md
# 输出 ✅ / ❌ + 缺失标签 / 未替换占位符

关键提示：Linter 强制要求标签完整、占位符必须替换；写完先 lint 再让 Agent 执行，避免跑到一半才发现写漏

📊 与竞品对比

竞品对比表

对比维度 qiaomu-goal-meta-skill Codex 裸 /goal Plan-to-Goal 面试 通用 Prompt 模板
六要素结构 ✅ 强制 Outcome/Verification/Constraints/Boundaries/Iteration/Stop ❌ 用户自己写 ⚠️ 只给面试问题 ❌ 散点字段
中英双语 ✅ 中文可执行 + 英文兼容镜像 ❌ 单一语言 ⚠️ 看用户怎么问 ❌ 多数只有英文
内置 Linter ✅ 自动检查必填标签和占位符 ❌ 没有 ❌ 没有 ❌ 没有
边界保护 ✅ 显式 Allowed Writes / Forbidden Paths ❌ 没有 ⚠️ 引导用户写 ❌ 没有
默认策略 ✅ 模糊任务自动选保守默认 + 一句理由 ❌ 没有 ⚠️ 问到你为止 ❌ 没有
风险分级 ✅ 低/中/高 + Pause 触发条件 ❌ 没有 ❌ 没有 ❌ 没有
中文人友好 ✅ 字段名中文、提示中文 ⚠️ 取决于 Codex 端 ⚠️ 取决于上下文 ❌ 多数英文
协议 MIT 跟 Codex 跟工具 多种

💡 适用场景

场景 1：在 Codex 桌面端直接看到 /goal 模式开关

Codex 追求目标模式

功能说明：Codex 桌面端（macOS / Windows 客户端）从 0.128.0 版本起，在 chat 面板侧边栏新增了「追求目标」开关，开启后 Codex 切换到 /goal 模式，会把对话当成长跑任务来处理——自动应用本 skill 输出的六要素任务合同。

输入要求：在 Codex 桌面端侧边栏点开 Settings → 找到「追求目标」/「Goal mode」开关

输出效果：切换后，输入框提示文案变化；可以输入 /goal 触发长跑任务

适用场景：

  • 复杂代码改造（重构大文件、跨模块迁移）
  • 多步骤研究（论文综述、批量资料整理）
  • 需要中途暂停、稍后继续的长任务

场景 2：直接输入 /目标 中文别名触发

Codex 输入 /目标 命令

功能说明：Codex 在中文 locale 下接受 /目标 作为 /goal 的别名（注意：本 skill 明确建议用户仍用 /goal 前缀，避免部分环境不识别中文别名）。输入后，Codex 会调用本 skill 做一次"需求访谈"再生成可执行版。

输入要求：在 Codex 桌面端 chat 输入框输入 /目标 或 /goal + 一段模糊需求

输出效果：Codex 弹出结构化输出（推荐执行版 + 默认理由 + 可选调整 + 英文镜像）

适用场景：

  • 给同事甩一句话任务，让 Codex 转成可执行合同
  • 把"做个好看的播客 App"翻译成 Outcome + Verification + Constraints 等六要素
  • 团队协作：把个人模糊意图沉淀成可复用模板

场景 3：真实案例——用 /goal 一比一复刻截图 HTML

Codex /goal 复刻截图任务

功能说明：用户给 Codex 截了一张 Clio 播客 App 的界面图，要求「一比一复刻截图的效果为 HTML 页面」。Codex 直接把它当成一个 /goal 长跑任务——分析截图、生成 HTML、跑本地预览、截对比图、迭代 3 轮内收敛。

输入要求：截一张目标界面 + 一句"复刻为 HTML" 描述

输出效果：自动产出一个 Clio 风格播客 App 的单页 HTML（带播放控制、订阅、章节列表）

复刻结果：Clio 播客 App

适用场景：

  • 设计稿 → 静态 HTML 还原
  • 竞品分析 → 复刻 + 改造
  • 教学示例 → 把视觉稿做成可点可改的代码

场景 4：仓库 README 自带「为什么值得用」红框清单

qiaomu-goal-meta-skill GitHub README

功能说明：仓库 README 在「为什么值得用」部分用红框直接列出 4 条核心价值——Outcome 必填、Verification 必填、Constraints 必填、Boundaries 必填，这正好对应本 skill 的六要素前 4 项，落地于 Linter 检查逻辑。

输入要求：打开 GitHub 仓库主页

输出效果：扫一眼 README 红框就能判断本 skill 是否适合你

适用场景：

  • 选型评估：判断"这个 skill 是不是只做包装"
  • 团队推广：把红框当宣传统一话术
  • 写文档参考：README 本身就是一段规范

场景 5：一张图说清 Codex /goal 的 5 段流程

Codex /goal 5 段流程图解

功能说明：第三方技术博客用一张长图解构了 Codex /goal 的 5 段工作流——需求理解 → 任务结构化 → 启动 Agent → 过程监督 → 验收闭环。配合本 skill 的六要素，Codex 长跑任务从"碰运气"变成"看证据"。

输入要求：阅读第三方博客完整版（如稀土掘金上的解读文章）

输出效果：理解 /goal 与普通 chat 的本质差异（持久化、暂停、证据、边界）

适用场景：

  • 给团队做 Codex 内部培训
  • 写技术 blog 引用配图
  • 帮助决策者理解"为什么要切换到 /goal 模式"

用户群体总结

  • ✅ 复杂代码改造团队：把"重构"翻译成有 Verification + Boundaries 的合同
  • ✅ 多 Agent 协作流：每个子任务都按六要素交付，可追溯
  • ✅ 企业内训讲师：用六要素帮新人写出"Agent 看得懂的需求"
  • ✅ 独立开发者：让 Codex 长跑后自己验收，不再盯屏幕
  • ❌ 不适合：单行问答、临时翻译、调试报错（这种直接 chat 更快）

💰 定价方案

完全开源，零成本使用。

开源协议： MIT

💡 新用户福利：直接 git clone + 复制第一段推荐执行版即可，30 秒跑通第一个 /goal 任务

🎯 总结

qiaomu-goal-meta-skill 解决了一个被严重低估的问题：Codex 升级了 /goal 命令，但没人教用户怎么写"Agent 看得懂的目标合同"。它把"模糊需求 → 六要素任务合同 → Linter 检查 → 双语交付"做成一条流水线，配合 Codex 桌面端的「追求目标」开关和 /goal 斜杠命令，让 Agent 长跑任务不再开盲盒。

推荐指数：⭐⭐⭐⭐⭐（满分 5 星）

适合人群：

  • 已经在用 Codex / Claude Code 做长跑任务的工程师
  • 团队想统一"需求 → Agent 任务"的写法
  • 个人想从"盯 Codex 屏幕"切换到"挂机收结果"

立即体验：

数据截至 2026-06-15，最新信息请以 GitHub 仓库为准。