claudeers.

🔓 unclaimed — this page was auto-generated from GitHub. Are you the creator?

Claim this page →
// Claude Skills

GoalPro

意图放大与 Goal Contract 协议,面向 Codex 和 Claude Code 的 goal Skill

Actively maintained
100/100
last commit 12 days ago
last release 12 days ago
releases 4
open issues 1
// install
git clone https://github.com/KimYx0207/GoalPro

GoalPro

意图放大与 Goal Contract 协议

简体中文

简介

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 是什么、不是什么

概念它是什么它不是什么
GoalPro Skill写出高质量 goal 提示词 / Goal Contract 的 Skill执行 goal 的工具,也不是简单的提示词润色器
Goal Contract给执行者使用的可执行、可验证、可暂停目标说明一串漂亮但无法验收的愿景
Deep Research 门槛战略和外部事实任务的证据前置要求为了显得专业而堆链接
Inventory大改前的影响面、调用方、测试入口盘点先重构再补解释
表达经济战略完整后的删空话把省字数当核心目标

好 goal 的质量门

输出 Goal Contract 前,先过这五个门:

  1. 意图对齐:不能只复述用户原话,必须说清用户真正要改变的局面;如果多种解释会改变路线、风险或验收,先问或写明默认假设。
  2. 字段互证IntentStrategic outcomeDecision standardExecution policyVerification 必须互相支撑,不能各写各的。
  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 和验证计划

使用路径

任务方法重点输出
模糊需求放大真实意图、定义成败标准Goal Contract
战略任务Deep Research、证据地图、反证Research-backed Goal Contract
执行前 goal先读上下文、分片执行、验证Codex /goal block 或 Claude Code 任务提示词
大改/重构Inventory、影响面、测试入口分片计划和暂停条件
修复跑偏找旧目标错位点、重写边界修正版 Goal Contract
验收收尾区分结构检查、本地验证、人工验收最终报告标准

联系方式

联系二维码

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

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

请老金喝杯咖啡

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

微信支付支付宝
微信收款码支付宝收款码

方法架构

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

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

主干

阶段要解决的问题不通过时的处理
Critical用户真正要改变什么?回到意图,不直接执行表面请求
Fetch哪些材料会改变判断?先读本地上下文或外部来源
Thinking哪条路线最能赢?比较取舍,标出反证和未知
Inventory执行者需要先知道哪些影响面和验证入口?大改前把盘点要求写进 goal
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 字段

字段作用常见错误
Goal一句话说明任务对象、动作和方向写成愿景
Intent放大后的真实意图复述用户原话
Strategic outcome完成后局面发生什么变化只写交付物
Decision standard路线判断、优先级、失败条件“高质量”但不可判
Evidence standard来源、验证、反证、信心等级搜到资料就算完成
Scope本轮包含什么塞未来计划
Non-goals本轮不做什么写“无”但任务很宽
Context to read first先读哪些会改变判断的材料全仓库漫游
Constraints权限、安全、兼容、语言等硬限制写成建议
Execution policy执行者直接做、先问、先 inventory 的规则仪式化提问
Checkpoints推进节点和可检查产物过程流水账
Verification执行者必须交付的完成证据命令通过 = 完成
Stop conditions必须暂停的条件风险出现还继续
Final report最后汇报形状大段复述过程

设计原则

原则原因
意图完成度优先任务真正完成,比提示词漂亮更重要
意图对齐先过门表面请求、真实意图、战略结果、执行策略和验收证据必须互相支撑
可执行性优先goal 必须让执行者知道对象、动作、边界、检查点和停止条件
证据先于战略没有 Fetch 的战略只能是草案
上下文按需读取全仓库漫游会制造噪音和误判
大改先 inventory先知道影响面,才能控制重构风险
社区信号要交叉验证GitHub、X、Reddit 能暴露失败模式,但不能替代证据
表达经济从属只删空话,不删判断、边界、证据和验收
验证分层结构检查、本地验证、线上验证、人工验收不是一回事
Prompt-only 边界GoalPro 产出 goal 后停止,执行需要用户另行授权
不增加装饰机制agent、hook、eval 只有能防真实失败时才加

文件结构

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. 不把未经验证的社区观点写成标准。

延伸阅读

// compatibility

Platformscli
Operating systems
AI compatibilityclaude
LicenseMIT
Pricingopen-source
Language

// faq

What is GoalPro?

意图放大与 Goal Contract 协议,面向 Codex 和 Claude Code 的 goal Skill. It is open-source on GitHub.

Is GoalPro free to use?

GoalPro is open-source under the MIT license, so it is free to use.

What category does GoalPro belong to?

GoalPro is listed under skills in the Claudeers registry of Claude-compatible tools.

0 views
54 stars
unclaimed
updated 15 days ago

// embed badge

GoalPro on Claudeers
[![Claudeers](https://claudeers.com/api/badge/goalpro.svg)](https://claudeers.com/goalpro)

// retro hit counter

GoalPro hit counter
[![Hits](https://claudeers.com/api/counter/goalpro.svg)](https://claudeers.com/goalpro)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/Shell249,840MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/Python117,790MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/Python159,495[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/Python77,228MIT[ claude ]
→ see how GoalPro connects across the ecosystem