qiaomu-goal-meta-skill

1. 基本信息

项目	内容	数据来源
名称	qiaomu-goal-meta-skill	GitHub API
作者/维护者	向阳乔木（GitHub: joeseesun，X: @vista8）	GitHub API
来源链接	https://github.com/joeseesun/qiaomu-goal-meta-skill	—
许可证	MIT	GitHub API
GitHub Stars	799	GitHub API
Forks	60	GitHub API
最新版本	0.2.0（manifest.json 标注）	仓库 manifest.json
安装方式	`npx skills add joeseesun/qiaomu-goal-meta-skill`	仓库 README

2. 功能介绍与亮点

qiaomu-goal-meta-skill 把一句模糊的任务描述，收敛成 Codex 可直接执行、可验证、知道何时暂停的 /goal 指令。它不替用户干活，只负责把“帮我做个 App”这类对人类有感觉、对 agent 缺关键信息的话，转成一份结构完整的“任务合同”。

核心能力：

七要素合同：产出目标、验证证据、约束、写入边界、迭代策略、完成条件、暂停条件七项俱全的 /goal 指令，避免“改到哪算哪”
中英双版直出：中文用户默认先给可直接复制的中文执行版，再附英文兼容镜像，字段标签保持一致
懒人选择题：信息不足时给编号化选项+推荐默认值，不强迫用户先填长表单
陌生领域先发现：涉及医疗、金融、合规等专业领域时，自动生成“先读文档再动手”的发现优先型目标，不编造专业结论
模糊词翻译成验证：“高级”“有质感”等主观词会被转成截图检查、层级间距等可验证标准
自带本地校验器：scripts/lint_goal_command.py 检查占位符、危险模糊指令与必填字段是否齐全

技术上是纯 Markdown 提示词技能，唯一附带的 Python 脚本只做只读文本正则校验，不执行外部命令、不联网。仓库 2026-06-11 发布当天即登上 GitHub Trending 每日榜单（Python 类第 20 名）。

3. 适用场景

固定分类：元技能与 Agent 增强

适合用 Codex（或类似 agent）执行较复杂任务前的初中级用户：开发网站/App/游戏/浏览器插件、修 bug、做重构、加测试、设计 UI 原型、创建整理 skill、多步骤研究交付等场景，尤其是需求本身还很模糊、用户不想先手写详细计划的情况。作者明确标注不适合“一句话翻译”、“一行 shell 输出”等不需要持续执行验证的小任务。

4. 跨 Agent 兼容性

依据仓库 manifest.json（target_platforms）与 agents/interface.yaml（adapter_targets/degradation）判断：

Codex：✅ 原生支持——技能本身即为 Codex /goal 指令设计，manifest 显式列出 openai 目标平台
Claude Code：✅ 原生支持——标准 SKILL.md 格式，manifest 与 interface.yaml 均显式列出 claude 为适配目标，并声明降级行为（“drafts structured agent goal prompts with the same labels”）
OpenClaw：❓ 未验证——manifest 另列 generic/agent-skills-compatible 目标，理论上兼容标准 SKILL.md 的 agent 均可加载，但作者未点名测试
Hermes Agent：❓ 未验证——未见任何相关信息

5. 推荐理由

多数“AI 干活失败”不是模型不会写代码，而是任务一开始就太模糊。这个技能只做一件事，但做得扎实：把口头需求收敛成一份可直接复制执行、带验证证据和暂停边界的 /goal 指令，帮初中级用户避免“agent 该验证时不验证、该停时不停”的常见翻车点。零依赖、零外联、一条命令装好即用，是低成本的效率放大器。

6. 评分

维度	分数	说明
受欢迎程度	6	799 stars（200–1k 区间），发布当天登上 GitHub Trending 每日榜单（Python 类第 20 名），另有 3 个独立用户提交的 Pull Request 与 1 个 Issue
可用性	7	一条 `npx skills add` 命令即用，零 API key、零付费依赖，文档含完整故障排查表与中英双语示例；仓库自 6 周前的首次发布提交后暂无后续提交，3 个外部 Pull Request 尚未获处理
安全性	9	纯提示词/模板类技能，唯一脚本为只读正则文本校验器（无 shell 执行、无网络请求、无文件写入）；interface.yaml 显式声明拒绝远程内联执行；MIT 许可清晰，作者身份可查实

综合评分：7.3（三项均值，≥7.0 达标线）

安全检查清单：①无 shell/系统命令执行 ②无联网外发 ③无需 API key 或凭据 ④SKILL.md 与脚本经全文核查无可疑指令 ⑤作者为可查实的独立开发者，无造假迹象 ⑥MIT 许可明确 ⑦仓库年轻（6 周），暂未见弃置迹象。

7. 跟同类 Skills 相比的优势

同类“需求收敛”技能大多走“规格-计划-任务-实现”多阶段闭环，qiaomu-goal-meta-skill 走的是“单条指令、一次产出”的轻量路线：

技能	定位	产出形态
qiaomu-goal-meta-skill	把模糊需求收敛成单条可执行 `/goal` 指令	一份带验证/边界/暂停条件的复制粘贴指令，无需多阶段人工确认
Spec Kit（GitHub 官方）	规格驱动开发工具包	`/speckit.constitution → specify → plan → tasks → implement` 五阶段闭环，每阶段落地为独立文档
spec-driven-development（Addy Osmani）	工程规格四阶段闸门	Specify → Plan → Tasks → Implement，每阶段需人工确认才进入下一阶段
planning-with-files	长任务持久化工作记忆	磁盘上维护 task_plan.md/findings.md/progress.md 三文件，配合生命周期 hook 自动读写

差异化：后三者都面向“较大工程、需要多阶段留痕”的场景，安装后会在项目里持续产出多份文档；qiaomu-goal-meta-skill 更轻——不产出额外文件，只在对话内给一段可复制指令，适合日常琐碎到中等复杂度的任务，门槛更低，但也不具备前三者的跨会话持久化/多阶段审查能力。

8. 用户评价

该技能在第三方评价平台尚无具名评分类评价。GitHub 仓库的 Issue 与 Pull Request 区可见独立用户的真实使用反馈：用户 ckizer 提出希望获得英文版本；用户 Edgardo-Ramirez-Canales 提交了两个改进型 Pull Request（文案微调与文档补充）；用户 xuenerissa-png 提交了一个修复本地校验脚本误报问题的 Pull Request。截至目前，这三个 Pull Request 均处于未合并状态。

9. 其他补充

仓库内置双语（中/英）输出能力，同一份指令会先后给出中文执行版与英文兼容镜像，字段标签保持一致，便于跨语言团队协作或复制进偏英文的 agent 环境。

10. 安装使用方式

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

安装后可用以下命令确认文件已就位：

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

触发方式：直接对 agent 说“用 qiaomu-goal-meta-skill 帮我把这个需求写成 Codex /goal”，或描述具体任务后要求“帮我写一个 goal”。技能本身不会执行任务，只生成 /goal 指令；如需附带的本地校验脚本，运行 python3 ~/.agents/skills/qiaomu-goal-meta-skill/scripts/lint_goal_command.py <文件> 检查产出的指令文本是否合规。

11. 注意事项

仓库自首次发布后 6 周内未见后续提交，3 个外部 Pull Request 尚未获处理，存在维护响应变慢的风险，建议关注后续更新节奏
技能只生成 /goal 指令本身，不会替用户绕过版权、账号、支付、生产数据或合规判断——这些场景会被直接写入“暂停条件”而非自动跳过
OpenClaw 与 Hermes Agent 的兼容性未经作者或第三方验证，实际使用前建议先小范围试用确认