把需求、计划与验收写进一条 /goal

乔木 Goal

先写清做到什么才算完成

向阳乔木的目标起草技能,把模糊需求整理成结果、验证、约束、写入边界、迭代和完成条件。先给可用草案,再用少量选择题调整;适合多步开发与研究任务。

作者 向阳乔木

乔木 Goal:先写清做到什么才算完成 项目图片

作者列出的使用环境

  • Claude Code
  • Codex
GitHub Star
900
版本
0.2.0
资料核对

先把一个目标写完整,再决定是否启动

第一次选一个有明确输入和结果的小范围任务,要求只生成草案。检查约束、完成证据和当前授权是否准确,再将确认过的一份 /goal 交给支持该功能的宿主。

选一个任务,开始使用

在目标项目的根目录运行安装命令,并选择 Codex。确认技能可用后附上任务材料,使用下方提示词起草;先审阅输出文件,启动目标是随后单独的一步。

你现在有一句需求、一份计划,还是现成目标

从一条需求和项目背景出发,先给默认执行草案。适合知道问题、还没写清范围与完成条件的时候。

  1. 在当前项目安装目标起草技能

    在目标项目根目录运行作者命令,按提示选择 Codex。默认安装到项目,-g 才是用户级安装;下方路径和检查示例按项目安装编写。安装与调用仍在自己的助手中完成。

    npx skills add joeseesun/qiaomu-goal-meta-skill
    查看作者安装说明

    首次路径:项目内安装,保存一份单语言目标

    运行命令时选择 Codex,默认项目目录为 .agents/skills/qiaomu-goal-meta-skill/,应包含 SKILL.md、references/ 与 scripts/。作者 README 的 ~/.agents 检查针对全局目录,不能用于判断本页项目安装是否成功。准备 brief.md 与 project-context.md,在助手中确认该技能已加载,发送“整理模糊需求”提示词。检查 goals/register-zh.txt 是否只有一条 /goal,字段有内容、命令有来源、边界符合原意;再按第三个任务做文本与人工检查。

    查看安装器的宿主与路径表
  2. 把这段话发给 AI

    下方是本站依据作者流程编写的使用示例,默认只起草或审阅目标。文件名是输入约定,请替换为真实材料;不要把生成的 /goal 当作这次起草请求直接执行。

    使用 qiaomu-goal-meta-skill,只为“让现有网站的手机注册流程更清楚”起草目标,不执行目标。读取 brief.md 与 project-context.md;以首次访客能够理解必填项、看懂错误提示并完成现有注册流程为结果,保留已有账号规则与接口。低风险缺口写成明确假设;只对改变成本、风险或产品方向的事项给编号选项,并用一句话解释默认选择。验证命令只引用项目材料中已知的命令,不知道时安排先发现。写清允许修改范围、桌面和手机上的检查证据、失败后的取证方式、完成条件及真正未解决的阻塞;保留已有授权,不额外扩大任务。只要中文版,使用 /goal 和纯中文字段,每个字段单独一行并写明具体内容,保存 goals/register-zh.txt;理由和选项另存 goals/register-notes.md。最后复核七个要素、文件路径和假设,并按实际安装位置运行附带检查器,保留结果;环境不具备时标为未检查。本次只交付草案。

  3. 检查你拿到的结果

    • 一份无模板空位的中文目标文件,默认理由与可选调整分开保存。
    • 核对成果、命令依据、范围与授权;缺少验收依据时保留待补资料的步骤,不伪造已确定的事实。
    查看这项任务的作者说明
进一步了解这个 Skill

Qiaomu Goal Meta Skill 处理的是开工前的目标定义。你说“让注册页好用一点”,它应补成谁能完成什么流程、如何证明有效、哪些行为不能变,以及允许修改哪里。产物是一段任务指令;生成这段文字不代表修好了注册页,也没有自动启动持续执行。

作者采用先给推荐版的方式:低风险缺口用明确假设补足,随后解释默认选择,并只对会改变成本、风险、所有权或方向的事项给出简短选项。问题数量不是固定四题。中文请求默认附一份语义一致的英文镜像,明确要求单一语言时只输出该语言。

结果、验证、约束、边界、迭代策略、完成条件和暂停条件,是这套技能组织目标的七个要素。这是作者的写作格式与检查规则,不是 Codex 要求每条 /goal 都必须具有的固定字段。约束说明什么不能变,边界说明可以写哪里;完成靠证据,受阻要说明缺什么,不能把二者混为一谈。

已有计划可以保留依赖与范围后转成目标;陌生领域则先安排阅读项目文档、样例和权威资料,再决定可实现的部分。对于“高级”“专业”这类方向词,技能会转成层级、可读性、交互与截图检查。默认最多三轮聚焦改进可按任务调整,不能把用完轮次当作完成证明。

仓库另带一个轻量文本检查器,能发现部分缺字段、占位符和宽泛表述,但不会判断命令是否存在、范围是否合理或两种语言是否一致。源码采用 MIT 许可;起草使用宿主模型额度,后续执行还需要相应工具、权限和资源。

来源与核验

资料核对

已按固定提交阅读全文、三个参考文件与检查器源码,并补核官方安装器和 OpenAI Goals 文档。未安装技能、运行第三方检查器或激活目标。