简介

GoalPro 是一个给 Codex 和 Claude Code 共用的 goalpro Skill，用来写出高质量 goal 提示词 / Goal Contract。

它要解决的问题很直接：用户给 Agent 的任务常常是模糊的、情绪化的、战略标准不清的。模型如果直接执行，很容易过度规划、乱读上下文、先改后想、命令跑通就假装完成。

GoalPro 的作用，是先把请求变成一份交给执行者使用的、可执行、可验证、可暂停的 Goal Contract：

• 真实意图是什么？
• 完成后局面应该发生什么变化？
• 什么算赢，什么算失败？
• 需要哪些证据、上下文和反证？
• 哪些事情本轮不做？
• 什么情况下必须暂停？
• 最后用什么证明真的完成？

目标不是把提示词写长，也不是替用户执行 goal，而是把 Agent 从“猜用户想要什么”拉回到“按清楚的完成契约执行”。

GoalPro 默认只输出可复制的 goal 提示词，并在输出后停住。只有用户另外明确授权执行，后续 Codex / Claude Code / 其他 Agent 才按这份 goal 开始做事。

flowchart LR
    subgraph intent["意图层"]
        A["表面请求"] --> B["真实意图"]
        B --> C["战略结果"]
    end

    subgraph contract["契约层"]
        C --> D["成败标准"]
        D --> E["证据标准"]
        E --> F["边界与非目标"]
    end

    subgraph execution["执行层"]
        F --> G["先读上下文"]
        G --> H["分片执行"]
        H --> I["验证与暂停"]
        I --> J["最终报告"]
    end

    style intent fill:#dbeafe,stroke:#2563eb,color:#000
    style contract fill:#fef3c7,stroke:#f59e0b,color:#000
    style execution fill:#dcfce7,stroke:#16a34a,color:#000
    style A fill:#93c5fd,stroke:#2563eb,color:#000,stroke-width:2px
    style B fill:#60a5fa,stroke:#2563eb,color:#000,stroke-width:2px
    style C fill:#34d399,stroke:#059669,color:#000,stroke-width:2px
    style D fill:#fbbf24,stroke:#d97706,color:#000,stroke-width:2px
    style E fill:#a78bfa,stroke:#7c3aed,color:#fff,stroke-width:2px
    style F fill:#fb923c,stroke:#ea580c,color:#000,stroke-width:2px
    style G fill:#2dd4bf,stroke:#0d9488,color:#000,stroke-width:2px
    style H fill:#86efac,stroke:#16a34a,color:#000,stroke-width:2px
    style I fill:#f87171,stroke:#dc2626,color:#fff,stroke-width:2px
    style J fill:#818cf8,stroke:#6366f1,color:#fff,stroke-width:2px

一句话总结

先放大真实意图，再锁定战略标准，然后写成 Agent 能执行、用户能验收的 goal 提示词。

GoalPro 是什么、不是什么

好 goal 的质量门

输出 Goal Contract 前，先过这五个门：

1. 意图对齐：不能只复述用户原话，必须说清用户真正要改变的局面；如果多种解释会改变路线、风险或验收，先问或写明默认假设。
2. 字段互证：Intent、Strategic outcome、Decision standard、Execution policy、Verification 必须互相支撑，不能各写各的。
3. 可执行：执行者能看出对象、动作、先读什么、做哪一片、不做什么、何时暂停。
4. 可验收：验证证据必须对应用户目标，不能用命令通过冒充真实完成。
5. 不过度：小任务不强行 deep research、inventory 或 eval；只有会改变判断、防止真实失败时才加流程。

快速示例

你说：

帮我写一个高质量 goal，让 Codex 修这个项目，别再跑偏。

GoalPro 应该输出：

Goal:
修复项目当前阻塞问题，并交付一份能证明行为恢复的变更。

Intent:
用户真正要的不是“看起来改了代码”，而是让 Agent 先搞清失败点、影响面和验收标准，再做最小必要修复。

Strategic outcome:
项目从不可判断/不可运行状态回到可验证状态；后续继续迭代时不会靠聊天记忆猜测完成度。

Decision standard:
用户目标完成度 > 证据质量 > 最小改动 > 表达经济。不能用命令通过冒充用户目标完成。

Evidence standard:
先读错误、点名文件、README/AGENTS/CLAUDE、相关测试命令；修复后区分结构检查、本地验证和人工验收。

Execution policy:
小修直接做；跨模块或重构先输出 inventory、影响面和分片验证计划。

Stop conditions:
需要删除数据、发布、处理密钥、改公共接口，或发现多条互斥路线时暂停确认。

这类输出的重点不是“格式完整”，而是让执行者知道：先读什么、做什么、不做什么、什么时候停、最后拿什么证明。

快速开始

GoalPro 同时支持 Claude Code 和 Codex。

• .claude/skills/goalpro/ 用于 Claude Code。
• .agents/skills/goalpro/ 用于 Codex。

Claude Code 个人级安装

PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force ".claude\skills\goalpro" "$env:USERPROFILE\.claude\skills\goalpro"

Bash：

mkdir -p ~/.claude/skills
cp -R .claude/skills/goalpro ~/.claude/skills/goalpro

Codex 个人级安装

PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.agents\skills" | Out-Null
Copy-Item -Recurse -Force ".agents\skills\goalpro" "$env:USERPROFILE\.agents\skills\goalpro"

Bash：

mkdir -p ~/.agents/skills
cp -R .agents/skills/goalpro ~/.agents/skills/goalpro

项目级安装

把对应目录复制到目标项目：

目标项目/
├── .claude/skills/goalpro/   # Claude Code
└── .agents/skills/goalpro/   # Codex

Skill 名称与触发

Skill 名称是 goalpro。

这里不用 goal，是为了避免和用户口头说的 goal、Goal Contract 字段，以及 slash command 语义产生混淆。Claude Code 中 Skill 可通过 /skill-name 调用，因此本 Skill 的直接入口是 /goalpro；/goal 不是本项目 Skill 名。

常见触发方式：

• 写一个高质量 goal
• 帮我优化这个任务提示词
• 把这个需求变成可执行的 Goal Contract
• 给 Claude Code 写执行任务
• 明确 done when / success criteria
• 先 deep research 再定战略
• 这个计划跑偏了，重写 goal
• 大改前先给 inventory 和验证计划

使用路径

联系方式

GitHub KimYx0207 |
X @KimYx0207 |
官网 aiking.dev |
微信公众号：老金带你玩AI

飞书知识库：
长期更新入口

请老金喝杯咖啡

如果 GoalPro 对你有帮助，欢迎请我喝杯咖啡，算是对持续维护的支持。

微信支付	支付宝

方法架构

GoalPro 的核心不是固定模板，而是一条把意图写成可执行 goal 的主干。它保障 goal 的质量，不替执行者完成 goal。

Critical -> Fetch -> Thinking -> Inventory -> Contract -> Review -> Verification

主干

Deep Research 门

战略、外部事实、高风险任务不能直接给最终 Goal。

flowchart TD
    A["用户请求"] --> B{"是否影响战略 / 外部事实 / 高风险？"}
    B -->|否| C["本地 Fetch<br/>读会改变判断的材料"]
    B -->|是| D["Deep Research<br/>来源 + 反证 + 信心等级"]
    C --> E["Goal Contract"]
    D --> F{"证据是否足够？"}
    F -->|足够| E
    F -->|不足| G["Draft Goal / Research Plan"]

    style A fill:#dbeafe,stroke:#2563eb,color:#000,stroke-width:2px
    style B fill:#7c3aed,stroke:#4c1d95,color:#fff,stroke-width:3px
    style C fill:#dcfce7,stroke:#16a34a,color:#000,stroke-width:2px
    style D fill:#fef3c7,stroke:#f59e0b,color:#000,stroke-width:2px
    style E fill:#34d399,stroke:#059669,color:#000,stroke-width:2px
    style F fill:#fb923c,stroke:#ea580c,color:#000,stroke-width:2px
    style G fill:#fee2e2,stroke:#dc2626,color:#000,stroke-width:2px

Evidence Map

战略任务必须形成证据地图，而不是只贴链接：

Evidence Map:
- Source:
  Source type:
  Claim:
  Relevance:
  Confidence:
  Counterevidence:
  Decision impact:

Inventory 门

大改、重构、跨模块任务必须先盘点：

flowchart LR
    A["大改请求"] --> B["Inventory<br/>文件 / 调用方 / 测试 / 风险"]
    B --> C{"是否有可验证切片？"}
    C -->|有| D["Slice 1<br/>最小改动"]
    D --> E["最小验证"]
    E --> F["Slice 2"]
    C -->|没有| G["暂停<br/>补验收路径"]

    style A fill:#dbeafe,stroke:#2563eb,color:#000,stroke-width:2px
    style B fill:#fef3c7,stroke:#f59e0b,color:#000,stroke-width:2px
    style C fill:#7c3aed,stroke:#4c1d95,color:#fff,stroke-width:3px
    style D fill:#dcfce7,stroke:#16a34a,color:#000,stroke-width:2px
    style E fill:#34d399,stroke:#059669,color:#000,stroke-width:2px
    style F fill:#86efac,stroke:#16a34a,color:#000,stroke-width:2px
    style G fill:#fee2e2,stroke:#dc2626,color:#000,stroke-width:2px

Goal Contract 字段

设计原则

文件结构

README.md                         # 中文项目页
docs/images/                      # 联系二维码和收款码
.agents/skills/goalpro/           # Codex 使用的 goalpro Skill
├── SKILL.md
└── references/
    ├── examples.md
    └── source-rules.md
.claude/skills/goalpro/           # Claude Code 使用的 goalpro Skill
├── SKILL.md
└── references/
    ├── examples.md
    └── source-rules.md

不提交的本机产物：

• .codex/
• .meta-kim/
• graphify-out/
• Python / Node 缓存、虚拟环境、构建输出、.env

参与贡献

如果你发现 Goal Contract 字段不够清楚、示例不够贴近真实任务，或者某条规则会导致 Agent 过度规划，可以开 Issue 或提交 PR。

贡献时请保持三条边界：

1. 不把缩短提示词当核心目标。
2. 不为了完整感增加机制。
3. 不把未经验证的社区观点写成标准。

延伸阅读

• Codex goalpro Skill
• Claude Code goalpro Skill
• 方法依据
• 示例校准