用 Cursor 老被 Agent 带偏，写了个把模糊需求转成 YAML 契约的 Skill

wz小鱼 · 2026-07-29T04:45:35.940Z

最近用 Cursor 和 Claude Code 写代码，经常卡在一个地方。跟 Agent 说「帮我重构一下」，它就开始猜范围、乱加预算，半路还撞权限。换个会话再来一遍，上下文又丢了。独立开发时间本来就碎，这种空聊成本挺高的。所以弄了个开源的 Agent Skill 叫 Goalcraft，专门干一件事：把模糊的一句话，收成一份可验证、可回滚的 /goal YAML 契约。它只写提示词，不替你执行重构或发版。复制 YAML，开新会话交给执行 agent 就行。对比一下前后的区别：以前说「帮我重构」它猜范围，现在 target_paths 写死。以前照抄别仓的测试命令，现在从 lockfile 或 scripts 推断。以前「做好就行」无法验收，现在 success_criteria 可观察。以前 CI 权限半路才发现没权限，现在开头标 needs_auth。以前 Agent 擅自加 60 分钟预算，现在默认不写时限。产物大概长这样： /goal title: Refactor src/auth without behavior change inputs: repo: . target_paths: - src/auth/ constraints: - preserve public APIs and I/O behavior success_criteria: - npm test exits 0 short_test: - shell: | npm test deliverables: - PR with move / extract / cleanup commits 安装命令： npx skills add xiaoyangtx996/goalcraft-skill 装好后说一句「写一个 /goal：把 src/auth 抽公共，行为不变」，把输出的 YAML 复制到新会话执行就行。兼容 Claude Code、Codex、Cursor 等 Agent Skills 运行时。仓库地址： https://github.com/xiaoyangtx996/goalcraft-skill （MIT 协议）说下诚实边界，它不代替执行 agent，YAML 填错下游照样会失败。缺路径、发版字段冲突、多轨顺序未定会先 CHECKPOINT 问你，而不是瞎编。桌面或云权限类步骤可能标成 manual，需要本机配合。目前字段对日常任务基本够用，后续打算补几个测试修绿和数据清洗的模板，纯开源自用，有需要的可以直接 fork。 #AI智能体