qiaomu-goal-meta-skill

Qiaomu Goal Meta Skill

将模糊任务收敛为 /goal 指令，让 Codex 能够持续执行、进行验证，并知道何时停止或暂停。

Copyright (c) 向阳乔木 X: https://x.com/vista8 GitHub: https://github.com/joeseesun/

运行模式

作为轻量级生产元技能运行。

默认假设：

• 用户想要的是可直接粘贴的 Codex /goal 命令，而不是通用提示词。
• 可执行的斜杠命令始终为 /goal。除非用户的环境明确记录了该别名，否则不要输出 /目标 作为命令。
• 第一个目标块应是最佳推荐的可执行版本，而不是只填写了一部分的模板。用户经常会直接复制初稿。
• 对于中文用户，默认输出中文内容和中文字段名，同时保留命令前缀 /goal。
• 对于中文用户，除非用户只要求一种语言，否则同时提供 推荐执行版（中文，可直接复制） 和 Goal Draft (English-compatible)。
• 如果任务仍然模糊但风险较低，选择最佳的保守默认值并继续。只有当答案会改变成本、风险、责任归属或产品方向时才提问。
• 如果领域陌生或专业性较强，则创建以探索为先的目标，要求 Agent 在实施前检查权威的项目、文档或运行时证据，而不是臆造领域规则。
• 如果缺失的细节风险较低，明确说明假设并继续。
• 除非用户明确要求，否则不要开始执行目标描述的工作。本技能用于创建目标指令。
• 优先使用具体的验证命令和产物，而不是模糊的信心表述。
• 优先采用狭窄的写入范围，并明确列出禁止访问的路径，而不是授予宽泛权限。
• 将 Stop when 和 Pause if 视为同一完成／阻塞约定的一部分。

工作流

1. 将任务重述为一个结果，而不是一项活动。
2. 使用 references/default-goal-strategy.md 对任务分类：熟悉领域还是未知领域、低风险还是高风险、新工作还是现有项目。
3. 为低风险的未知事项选择最佳默认值，并用一句话说明理由。
4. 识别 Goal 约定中缺失的信息：
   • 成功标准
   • 验证命令、产物或证据
   • 不得更改的约束
   • 允许写入的位置和禁止访问的路径
   • 迭代策略
   • 完成证据
   • 阻塞时的停止条件、人工决策或预算上限
5. 如果任务的说明不够充分，优先提供带默认值的编号多选调整项。使用 references/interview-checklist.md。
6. 对于以中文为主的用户，先给出中文推荐执行目标，再提供含义一致且保留英文字段标签的英文兼容版本。
7. 根据 references/goal-command-playbook.md 检查命令。
8. 对于文件交付物，在宣布目标完成前，运行 python3 scripts/lint_goal_command.py <file>。

输出约定

信息充分时，先输出最佳推荐命令。实际输出中不要留下占位符。

/goal Create a first-version local MVP for the requested task, inspect project-provided commands before changing code, implement the core user-visible workflow, and keep unrelated systems unchanged.
Verification: run the smallest project-provided checks, start the local app or relevant runtime, complete the core workflow once, and capture logs/screenshots or command output as evidence.
Constraints: do not add accounts, paid services, production changes, destructive operations, or unrelated features unless requested.
Boundaries: write only inside the new project directory or the directly related existing project files.
Iteration policy: implement one focused workflow at a time, rerun checks after meaningful changes, inspect logs before retrying, and make at most 3 focused improvement rounds before reporting remaining risks.
Stop when: the core workflow is proven by runtime evidence and checks pass or missing checks are explicitly reported.
Pause if: credentials, payments, production data, destructive changes, legal/medical/financial decisions, copyrighted assets, or unclear ownership is required.

对于以中文为主的用户，优先采用以下等效格式：

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

任务模糊时，输出：

1. 推荐执行版（中文，可直接复制）：最佳默认 /goal。
2. 默认选择理由：一句简洁的说明。
3. 可选调整：带推荐默认值的编号选项，并附简短选项标签。
4. 你可以直接回复：例如 按默认 或 1B 2A 3C。
5. Goal Draft (English-compatible)：忠实的英文兼容版本，使用英文字段标签。

如果用户使用英文，则只输出英文兼容草稿，除非用户也要求中文版本。

除非用户要求解释，否则不要输出冗长的通用指导。

质量标准

一个强目标应：

• 有一个具体结果
• 明确指出确切的检查项或证据
• 保护无关文件、用户数据、机密信息和默认分支
• 定义写入边界
• 告诉 Agent 失败后如何迭代
• 说明何时停止，因为已证明任务完成
• 说明何时暂停，因为需要人工决策、凭证、账户状态、预算或解决反复出现的阻碍

拒绝或修改以下目标：

• 只写 make it better、finish this 或 fix bugs
• 缺少验证
• 允许 Agent 无故编辑整台机器或整个仓库
• 要求在没有新证据来源的情况下反复重试
• 没有针对外部身份验证、机密信息、付款、破坏性操作或模糊产品决策的暂停条件
• 在面向用户的可执行草稿中留下 [Outcome] 等占位符
• 把 高级、有质感 或 professional 等模糊词语当作验证标准，而不是将其转化为截图、运行时检查、审核标准或迭代规则

参考文件

• references/goal-command-playbook.md：核心 /goal 模板、适用场景、示例和反模式。
• references/default-goal-strategy.md：针对懒得输入的用户的默认策略、未知领域探索、风险分类和可直接复制的输出规则。
• references/interview-checklist.md：用于将模糊任务转化为明确目标的问题库。
• scripts/lint_goal_command.py：用于轻量检查必需 /goal 标签和未解决占位符的检查器。