diff --git a/skills/goalpro/CHANGELOG.md b/skills/goalpro/CHANGELOG.md index 6f286bb..4a11254 100644 --- a/skills/goalpro/CHANGELOG.md +++ b/skills/goalpro/CHANGELOG.md @@ -1,5 +1,19 @@ # Changelog +## Unreleased + +### Changed + +- Make one-shot requests return only `Goal Prompt`; append `Loop Prompt` only when the user explicitly requests iteration or post-delivery evidence will determine another cycle. +- Split intent into `User-stated intent`, `AI-inferred potential intent`, and `Value judgments requiring confirmation`. +- Keep research, workflow, repair, and automation guidance inside the applicable prompt instead of adding default explanatory output. + +### Benefits + +- Reduces unnecessary output and avoids turning finite tasks into artificial recurring workflows. +- Makes AI inference auditable and prevents inferred motives or value choices from being presented as user-confirmed intent. +- Preserves the existing evidence-bound Loop protocol for tasks that genuinely need continued iteration. + ## Kim Service V1.0 - 2026-07-15 - Imported `KimYx0207/GoalPro` revision `39adc8db765e0e4ad4df8d4ce02e7059fed69f26` as a self-contained Kim Service component. diff --git a/skills/goalpro/README.md b/skills/goalpro/README.md index 114057f..1fc6a90 100644 --- a/skills/goalpro/README.md +++ b/skills/goalpro/README.md @@ -1,7 +1,7 @@
意图放大、Goal Prompt 与 Loop Prompt 协议
+意图区分、Goal Prompt 与按需 Loop Prompt 协议
简体中文
@@ -18,18 +18,20 @@
## 简介
-**GoalPro** 是一个给 Codex 和 Claude Code 共用的 `goalpro` Skill,用来写出高质量 Goal Prompt,并附带交付后继续进化用的 Loop Prompt。
+**GoalPro** 是一个给 Codex 和 Claude Code 共用的 `goalpro` Skill,用来写出高质量 Goal Prompt;只有存在真实后续迭代需求时,才附带交付后继续进化用的 Loop Prompt。
它要解决的问题很直接:用户给 Agent 的任务常常是模糊的、情绪化的、战略标准不清的。模型如果直接执行,很容易过度规划、乱读上下文、先改后想、命令跑通就假装完成。
-GoalPro 的作用,是先把请求变成两段交给执行者使用的、可复制、可验证、可暂停的提示词:
+GoalPro 的作用,是先把请求变成一段交给执行者使用的、可复制、可验证、可暂停的 Goal Prompt;若交付后还会出现决定下一轮动作的新证据,再追加 Loop Prompt:
- **Goal Prompt**:启动本轮执行,核心是可执行的 **Goal Contract**。
-- **Loop Prompt**:在本轮执行结果出来之后使用,引导复盘、差距修复和持续进化;开头先给 `时间参数`,让用户直接填写下一轮什么时候继续,如“手动贴入结果后”或“每天早上 09:00”。
+- **Loop Prompt(按需)**:仅在真实后续迭代需求存在时使用,引导复盘、差距修复和持续进化;开头先给 `时间参数`,让用户直接填写下一轮什么时候继续,如“手动贴入结果后”或“每天早上 09:00”。
Goal Prompt 要回答:
-- 真实意图是什么?
+- 用户明确表达了什么意图?
+- 哪些只是 AI 推断的潜在意图?
+- 哪些价值判断必须由用户确认?
- 完成后局面应该发生什么变化?
- 什么算赢,什么算失败?
- 需要哪些证据、上下文和反证?
@@ -52,13 +54,13 @@ Loop Prompt 要回答:
> 目标不是把提示词写长,也不是替用户执行 goal,而是把 Agent 从“猜用户想要什么”拉回到“按清楚的完成契约执行”。
-GoalPro 默认只输出可复制的 Goal Prompt + Loop Prompt,并在输出后停住。两个提示词必须用代码块外的 `Goal Prompt:` / `Loop Prompt:` 标签分开,不额外包一层 prompt rewrite 解释。只有用户另外明确授权执行,后续 Codex / Claude Code / 其他 Agent 才按 Goal Prompt 开始做事;Loop Prompt 只在拿到执行结果后用于持续进化。Loop Prompt 开头必须先给一个可填写的 `时间参数`,但写了时间不等于已经创建后台任务;如果用户要真正定时或后台运行,需要单独设置自动化。
+GoalPro 默认只输出可复制的 Goal Prompt,并在输出后停住,不额外包一层 prompt rewrite 解释。只有用户明确要求持续迭代,或交付后会出现决定下一轮动作的新证据时,才追加独立的 Loop Prompt。只有用户另外明确授权执行,后续 Codex / Claude Code / 其他 Agent 才按 Goal Prompt 开始做事;Loop Prompt 只在拿到执行结果后用于持续进化。Loop Prompt 开头必须先给一个可填写的 `时间参数`,但写了时间不等于已经创建后台任务;如果用户要真正定时或后台运行,需要单独设置自动化。
```mermaid
flowchart LR
subgraph intent["意图层"]
- A["表面请求"] --> B["真实意图"]
- B --> C["战略结果"]
+ A["表面请求"] --> B["三类意图区分"]
+ B --> C["已确认战略结果"]
end
subgraph contract["契约层"]
@@ -104,32 +106,33 @@ flowchart LR
### 一句话总结
-> 先放大真实意图,再锁定战略标准,然后写成 Agent 能执行、用户能验收、结果能继续进化的双提示词。
+> 先区分用户意图、AI 推断和价值判断,再锁定战略标准,默认交付 Goal Prompt;真实需要迭代时再追加 Loop Prompt。
## GoalPro 是什么、不是什么
| 概念 | 它是什么 | 它不是什么 |
|---|---|---|
-| **GoalPro Skill** | 写出 Goal Prompt + Loop Prompt 的 Skill | 执行 goal 的工具,也不是简单的提示词润色器 |
+| **GoalPro Skill** | 默认写出 Goal Prompt,并按真实迭代需求追加 Loop Prompt 的 Skill | 执行 goal 的工具,也不是简单的提示词润色器 |
| **Goal Prompt** | 给执行者启动本轮任务的可执行提示词,核心是 Goal Contract | 一串漂亮但无法验收的愿景 |
| **Loop Prompt** | 给执行结果之后使用的持续循环协议,开头给 `时间参数`,每轮产出 `Next LOOP packet` | 当前回合的自动执行授权、一次性返工提示词、后台调度器本身,或无限循环的借口 |
| **Goal Contract** | Goal Prompt 里的可执行、可验证、可暂停目标说明 | 空泛愿景或待办清单 |
-| **Workflow lens** | 生成 Goal Prompt / Loop Prompt 时使用的判断层:识别重复工作,并把必要的 Trigger / Checkpoint / Brief 写进这两段提示词 | 第三个输出、Workflow Prompt、执行器、流程图交付物,或后台自动化 |
+| **Workflow lens** | 识别重复工作,并把必要的 Trigger / Checkpoint / Brief 写进 Goal Prompt;存在真实循环时再写进 Loop Prompt | 第三个输出、Workflow Prompt、执行器、流程图交付物,或后台自动化 |
| **Deep Research 门槛** | 战略和外部事实任务的证据前置要求 | 为了显得专业而堆链接 |
| **Inventory** | 大改前的影响面、调用方、测试入口盘点 | 先重构再补解释 |
| **表达经济** | 战略完整后的删空话 | 把省字数当核心目标 |
-## 好 Goal + Loop 的质量门
+## 好 Goal / 可选 Loop 的质量门
-输出 Goal Prompt + Loop Prompt 前,先过这七个门:
+输出 Goal Prompt / 可选 Loop Prompt 前,先过这八个门:
-1. **意图对齐**:不能只复述用户原话,必须说清用户真正要改变的局面;如果多种解释会改变路线、风险或验收,先问或写明默认假设。
-2. **字段互证**:`Intent`、`Strategic outcome`、`Decision standard`、`Execution policy`、`Verification` 必须互相支撑,不能各写各的。
+1. **意图区分**:分别写清 `User-stated intent`、`AI-inferred potential intent`、`Value judgments requiring confirmation`,不把推断或价值判断冒充用户原意。
+2. **字段互证**:三类意图字段、`Strategic outcome`、`Decision standard`、`Execution policy`、`Verification` 必须互相支撑,不能各写各的。
3. **可执行**:执行者能看出对象、动作、先读什么、做哪一片、不做什么、何时暂停。
4. **可验收**:验证证据必须对应用户目标,不能用命令通过冒充真实完成;完成后必须展示一个实际样例、案例片段、截图说明或改后输出片段,让用户能判断是否通过。
-5. **Workflow lens**:看到每天、每周、自动、持续、发布、运营、监控、队列、复盘等信号时,先判断是不是重复工作;只有重复工作才在 Goal Prompt / Loop Prompt 里补 Trigger、Checkpoint、Brief,不新增第三段输出。
-6. **可进化**:Loop Prompt 必须先给 `时间参数`,再要求读取上一轮真实结果和证据,指出剩余差距,给出 Done / Continue / Pause 判断,在 Continue 时输出 `Next LOOP packet`,并用 guardrails 防止无限循环。
-7. **不过度**:小任务不强行 deep research、inventory、workflow lens 或 eval;只有会改变判断、防止真实失败时才加流程。
+5. **Loop 按需**:复杂、多步骤或多文件本身不触发 Loop;只有用户明确要求,或交付后会出现决定下一轮动作的新证据时才生成。
+6. **Workflow lens**:看到每天、每周、自动、持续、发布、运营、监控、队列、复盘等信号时,先判断是不是重复工作;只有重复工作才补 Trigger、Checkpoint、Brief,不新增第三段输出。
+7. **可进化**:若生成 Loop Prompt,必须先给 `时间参数`,再要求读取上一轮真实结果和证据,指出剩余差距,给出 Done / Continue / Pause 判断,在 Continue 时输出 `Next LOOP packet`,并用 guardrails 防止无限循环。
+8. **不过度**:小任务不强行 deep research、inventory、workflow lens、Loop 或 eval;只有会改变判断、防止真实失败时才加机制。
## 快速示例
@@ -137,7 +140,7 @@ flowchart LR
> 帮我写一个高质量 goal,让 Codex 修这个项目,别再跑偏。
-**GoalPro 应该输出两段:**
+**GoalPro 默认只输出 Goal Prompt:**
Goal Prompt:
@@ -145,8 +148,14 @@ Goal Prompt:
Goal:
修复项目当前阻塞问题,并交付一份能证明行为恢复的变更。
-Intent:
-用户真正要的不是“看起来改了代码”,而是让 Agent 先搞清失败点、影响面和验收标准,再做最小必要修复。
+User-stated intent:
+修复项目,并避免 Codex 再次跑偏。
+
+AI-inferred potential intent:
+用户可能更在意可验证的行为恢复,而不只是“看起来改了代码”;这是基于“别再跑偏”的推断,可由用户修正。
+
+Value judgments requiring confirmation:
+是否优先最小改动而非更彻底重构;若该选择会改变修复路线,先确认。
Strategic outcome:
项目从不可判断/不可运行状态回到可验证状态;后续继续迭代时不会靠聊天记忆猜测完成度。
@@ -164,6 +173,8 @@ Stop conditions:
需要删除数据、发布、处理密钥、改公共接口,或发现多条互斥路线时暂停确认。
```
+若用户明确要求交付后继续根据运行结果迭代,再追加:
+
Loop Prompt:
```markdown
@@ -277,12 +288,12 @@ Skill 名称是 `goalpro`。
| 任务 | 方法重点 | 输出 |
|---|---|---|
-| **模糊需求** | 放大真实意图、定义成败标准 | Goal Prompt + Loop Prompt |
-| **战略任务** | Deep Research、证据地图、反证 | Research-backed Goal Prompt + Loop Prompt |
-| **执行前 goal** | 先读上下文、分片执行、验证 | Codex `/goal` block 或 Claude Code 任务提示词 + Loop Prompt |
+| **模糊需求** | 区分三类意图、定义成败标准 | Goal Prompt |
+| **战略任务** | Deep Research、证据地图、反证 | Research-backed Goal Prompt;真实需要迭代时追加 Loop |
+| **执行前 goal** | 先读上下文、分片执行、验证 | Codex `/goal` block 或 Claude Code 任务提示词 |
| **大改/重构** | Inventory、影响面、测试入口 | 分片计划和暂停条件 |
-| **修复跑偏** | 找旧目标错位点、重写边界 | 修正版 Goal Prompt + Loop Prompt |
-| **重复工作/自动化** | 判断是否是可委托 workflow,写清 Trigger / Checkpoint / Brief / source of truth | Goal Prompt + Loop Prompt,必要时给自动化设置说明 |
+| **修复跑偏** | 找旧目标错位点、重写边界 | 修正版 Goal Prompt |
+| **重复工作/自动化** | 判断是否是可委托 workflow,写清 Trigger / Checkpoint / Brief / source of truth | Goal Prompt + Loop Prompt |
| **交付后进化** | 复盘上一轮结果、定位差距、收敛验证 | Loop Prompt |
| **验收收尾** | 区分结构检查、本地验证、人工验收 | 最终报告标准 |
@@ -316,10 +327,10 @@ X @KimYx0207 |
## 方法架构
-GoalPro 的核心不是固定模板,而是一条把意图写成可执行 Goal Prompt、再给出交付后 Loop Prompt 的主干。它保障提示词质量,不替执行者完成任务。遇到持续、自动、发布、运营、监控、队列、复盘类请求时,先用 workflow lens 判断哪些信息应该写进这两段提示词;workflow lens 自己不成为第三个交付物。
+GoalPro 的核心不是固定模板,而是一条先区分三类意图、再写成可执行 Goal Prompt,并按真实后续迭代需求决定是否追加 Loop Prompt 的主干。它保障提示词质量,不替执行者完成任务。遇到持续、自动、发布、运营、监控、队列、复盘类请求时,先用 workflow lens 判断哪些信息应该写进 Goal;真实循环存在时再写进 Loop。workflow lens 自己不成为第三个交付物。
```text
-Critical -> Fetch -> Thinking -> Workflow lens -> Inventory -> Contract -> Review -> Verification -> Loop
+Critical -> Fetch -> Thinking -> Workflow lens -> Inventory -> Contract -> Review -> Verification -> Loop gate
```
### 主干
@@ -329,12 +340,12 @@ Critical -> Fetch -> Thinking -> Workflow lens -> Inventory -> Contract -> Revie
| **Critical** | 用户真正要改变什么? | 回到意图,不直接执行表面请求 |
| **Fetch** | 哪些材料会改变判断? | 先读本地上下文或外部来源 |
| **Thinking** | 哪条路线最能赢? | 比较取舍,标出反证和未知 |
-| **Workflow lens** | 这是一件一次性任务,还是可委托的重复工作? | 重复工作才把 Trigger、Checkpoint、Brief 写进 Goal Prompt / Loop Prompt;一次性任务不加流程包袱 |
+| **Workflow lens** | 这是一件一次性任务,还是可委托的重复工作? | 重复工作才把 Trigger、Checkpoint、Brief 写进 Goal;一次性任务不加流程包袱 |
| **Inventory** | 执行者需要先知道哪些影响面和验证入口? | 大改前把盘点要求写进 goal |
| **Contract** | 如何写成执行者能照着做的契约? | 补齐目标、边界、暂停条件 |
| **Review** | 有没有空话、越界、假完成? | 删掉装饰性流程,保留判断 |
| **Verification** | 执行者最后要拿什么证明完成? | 区分未验证、结构检查、本地验证、人工验收 |
-| **Loop** | 执行结果回来后如何继续进化? | 写清复盘证据、剩余差距、迭代上限和停止条件 |
+| **Loop gate** | 交付后是否会出现决定下一轮动作的新证据? | 是才写 Loop;复杂或多步骤本身不触发 |
### Deep Research 门
@@ -345,7 +356,7 @@ flowchart TD
A["用户请求"] --> B{"是否影响战略 / 外部事实 / 高风险?"}
B -->|否| C["本地 Fetch
读会改变判断的材料"]
B -->|是| D["Deep Research
来源 + 反证 + 信心等级"]
- C --> E["Goal Prompt + Loop Prompt"]
+ C --> E["Goal Prompt
按需追加 Loop Prompt"]
D --> F{"证据是否足够?"}
F -->|足够| E
F -->|不足| G["Draft Goal / Research Plan"]
@@ -401,7 +412,9 @@ flowchart LR
| 字段 | 作用 | 常见错误 |
|---|---|---|
| `Goal` | 一句话说明任务对象、动作和方向 | 写成愿景 |
-| `Intent` | 放大后的真实意图 | 复述用户原话 |
+| `User-stated intent` | 用户明确表达或已经确认的意图 | 把 AI 猜测写成用户原意 |
+| `AI-inferred potential intent` | AI 基于上下文推断的潜在意图,并标注依据与不确定性 | 省略推断标签或过度心理揣测 |
+| `Value judgments requiring confirmation` | 会改变优先级、质量线、风险容忍或取舍的待确认判断 | 静默替用户做价值决定 |
| `Strategic outcome` | 完成后局面发生什么变化 | 只写交付物 |
| `Decision standard` | 路线判断、优先级、失败条件 | “高质量”但不可判 |
| `Evidence standard` | 来源、验证、反证、信心等级 | 搜到资料就算完成 |
@@ -439,7 +452,7 @@ flowchart LR
| 原则 | 原因 |
|---|---|
| 意图完成度优先 | 任务真正完成,比提示词漂亮更重要 |
-| 意图对齐先过门 | 表面请求、真实意图、战略结果、执行策略和验收证据必须互相支撑 |
+| 意图区分先过门 | 用户明确意图、AI 推断、待确认价值判断必须分开,战略结果和验收证据只绑定已确认意图 |
| 可执行性优先 | goal 必须让执行者知道对象、动作、边界、检查点和停止条件 |
| 证据先于战略 | 没有 Fetch 的战略只能是草案 |
| 上下文按需读取 | 全仓库漫游会制造噪音和误判 |
@@ -449,7 +462,7 @@ flowchart LR
| 验证分层 | 结构检查、本地验证、线上验证、人工验收不是一回事 |
| 完成后给样例 | 改完必须给用户看实际样例/案例片段,否则用户无法判断是否通过 |
| Prompt-only 边界 | GoalPro 产出 goal 后停止,执行需要用户另行授权 |
-| 输出永远是两段提示词 | 默认只交付 `Goal Prompt` 和 `Loop Prompt`;workflow lens、inventory、deep research 都只是生成这两段提示词的判断规则 |
+| 默认只交付 Goal Prompt | 一次性交付不附送 Loop;只有存在真实后续迭代需求时才追加 `Loop Prompt` |
| Loop 不是执行授权 | Loop Prompt 只供交付后粘贴使用,不能让 GoalPro 当前回合继续执行 |
| Loop 有时间入口 | 开头先给 `时间参数`;定时/后台执行属于自动化设置,需要显式授权 |
| Loop 必须可持续且可停止 | 每轮结束要输出 `Next LOOP packet` 或明确 Done / Pause,同时保留 guardrails,不能只修一轮也不能无限循环 |
diff --git a/skills/goalpro/SKILL.md b/skills/goalpro/SKILL.md
index cea2aeb..17f8635 100644
--- a/skills/goalpro/SKILL.md
+++ b/skills/goalpro/SKILL.md
@@ -1,13 +1,13 @@
---
name: goalpro
-description: 当用户要写出高质量 Goal Prompt 和交付后继续进化用的 Loop Prompt,把模糊、战略性、多步骤、证据不足、持续/自动化或容易跑偏的请求整理成可执行、可验证、可暂停且带时间参数的目标契约时使用。适用于写 goal、优化任务提示词、明确 done/success criteria、deep research 后定战略、大改前 inventory、修复跑偏计划、识别可委托的重复 workflow、为 Codex 或 Claude Code 准备执行任务;默认只生成提示词,不执行 goal 或 loop,也不创建自动化。
+description: 当用户要写出高质量 Goal Prompt,把模糊、战略性、多步骤、证据不足、持续/自动化或容易跑偏的请求整理成可执行、可验证、可暂停的目标契约时使用。适用于写 goal、优化任务提示词、明确 done/success criteria、deep research 后定战略、大改前 inventory、修复跑偏计划、识别可委托的重复 workflow、为 Codex 或 Claude Code 准备执行任务;默认一次性交付只生成 Goal Prompt,只有存在真实后续迭代需求时才追加 Loop Prompt,不执行 goal 或 loop,也不创建自动化。
---
-# Goal Prompt + Loop Prompt
+# Goal Prompt
-目标:先把真实意图、战略判断、证据标准和成败边界讲清楚,再写成 Codex / Claude Code 能执行、能验收、少跑偏的 Goal Prompt;同时产出一个交付后继续进化用的 Loop Prompt。
+目标:先区分用户明确表达的意图、AI 推断的潜在意图和需要用户确认的价值判断,再把战略判断、证据标准和成败边界写成 Codex / Claude Code 能执行、能验收、少跑偏的 Goal Prompt。只有存在真实后续迭代需求时,才追加交付后使用的 Loop Prompt。
-GoalPro 的交付物是可复制的提示词,不是任务执行结果。默认输出两段:`Goal Prompt` 用于启动执行,`Loop Prompt` 用于执行结果出来后的复盘、差距修复和持续进化。Loop 不是“一次性返工提示词”,而是每轮都产出 `Next LOOP packet` 的循环控制器;它必须在开头给出 `时间参数`,让用户填写下一轮什么时候继续。除非用户明确说“按这个 goal 执行 / 开始改 / 写入文件 / 提交 / 创建自动化”,否则输出两段提示词后必须停止。
+GoalPro 的交付物是可复制的提示词,不是任务执行结果。默认一次性交付只输出 `Goal Prompt`。只有用户明确要求持续迭代 / LOOP,或任务在本次交付后会持续产生新证据并需要下一轮动作时,才追加 `Loop Prompt`。Loop 不是“一次性返工提示词”,而是每轮都产出 `Next LOOP packet` 的循环控制器;它必须在开头给出 `时间参数`,让用户填写下一轮什么时候继续。除非用户明确说“按这个 goal 执行 / 开始改 / 写入文件 / 提交 / 创建自动化”,否则输出适用的提示词后必须停止。
这不是“让提示词更短”的 Skill。表达经济只在战略完整后处理:删空话,不删判断、边界、证据和验收。
@@ -18,15 +18,16 @@ GoalPro 的交付物是可复制的提示词,不是任务执行结果。默认
- `Execution`:用户要给 agent 一份按 goal 开始做的执行提示词。
- `Repair`:之前输出跑偏、太粗糙、太复杂、问太多、假完成。
- `Governed`:高风险、多文件、发布、外部事实、生产相邻或会影响真实用户的任务。
-- `Workflow`:用户提到每天、每周、自动、持续、发布、运营、监控、队列、复盘等重复性工作时,先判断哪些 Trigger / Checkpoint / Brief 信息应写进 Goal Prompt / Loop Prompt。
+- `Workflow`:用户提到每天、每周、自动、持续、发布、运营、监控、队列、复盘等重复性工作时,先判断哪些 Trigger / Checkpoint / Brief 信息应写进 Goal Prompt;这类任务通常存在真实后续迭代需求,可再追加 Loop Prompt。
用能诚实验收的最轻模式;但战略性任务必须先过证据门槛。
## Prompt-only 闸门
- Skill mention 不等于执行授权。用户只说 `goalpro`、`写 goal`、`优化提示词`、`帮我做个目标` 时,只生成可复制的 goal 提示词。
-- 新版默认生成两段提示词:`Goal Prompt` 和 `Loop Prompt`。Loop 只是交付后可粘贴的继续进化提示词,不授权当前回合执行。
-- Workflow lens 不改变输出形态:默认仍然只输出 `Goal Prompt` 和 `Loop Prompt`,不新增第三个 `Workflow Prompt`,不把 GoalPro 变成执行器或自动化平台。
+- 默认一次性交付只生成一段 `Goal Prompt`,不为了显得完整而附送 Loop。
+- 只有通过“Loop 需求判断门”时才追加 `Loop Prompt`。Loop 只是交付后可粘贴的继续进化提示词,不授权当前回合执行。
+- Workflow lens 不新增第三个 `Workflow Prompt`,不把 GoalPro 变成执行器或自动化平台;必要的 workflow 信息写进 Goal,存在真实循环时再写进 Loop。
- Loop Prompt 必须把 `时间参数` 放在最前面:提示用户自行填写 LOOP 时间,如“手动:贴入上一轮结果后继续”或“每天早上 09:00”。
- 定时/自动 Loop 只是自动化设置说明,除非用户明确授权创建或修改自动化;写了时间不等于已经创建后台任务。
- 生成的 goal 必须能指导后续执行者:对象、动作、上下文、范围、非目标、检查点、暂停条件和验收证据都要清楚。
@@ -35,15 +36,27 @@ GoalPro 的交付物是可复制的提示词,不是任务执行结果。默认
- 不要因为 loop 里写了 Review evidence、Cycle action、Verification delta,就在当前回合开始复盘或修复。
- 只有用户额外明确授权执行、保存、修改文件、提交或发布时,才进入独立的执行任务;那已经不是 GoalPro 的默认输出模式。
+## Loop 需求判断门
+
+先判断本次是一次性交付,还是存在真实后续迭代需求:
+
+- `只生成 Goal Prompt`:用户只要 goal / prompt / spec;任务虽复杂或多步骤,但可以在一次执行合同内完成和验收;所谓“后续优化”没有明确的新输入、新证据、触发条件或下一轮动作。
+- `Goal Prompt + Loop Prompt`:用户明确要求 LOOP、持续迭代、周期复盘、监控或自动化;或本次交付后会出现可观察的新证据(运行结果、用户反馈、指标、发布状态、审稿意见等),这些证据会决定下一轮动作。
+- 复杂、多文件、需要多个 checkpoint、一次执行内反复验证,不自动构成真实后续迭代需求。
+- 不确定时默认一次性交付,只生成 Goal Prompt;不要凭 AI 对“持续进化”的偏好擅自追加 Loop。
+- 若只要求 Loop,则只输出 Loop Prompt,并要求用户提供上一轮结果或 `Next LOOP packet`。
+
## 意图对齐质量门
-输出任何 Goal Prompt + Loop Prompt 前,先做一次短自检:
+输出任何提示词前,先做一次短自检:
-- 对齐链路:表面请求 -> 真实意图 -> 战略结果 -> 可执行动作 -> 验收证据;链路断开的字段必须重写。
-- `Intent` 不能只复述用户原话;必须说明用户真正要改变的局面、当前不满和最大误伤点。
+- 对齐链路:用户明确表达的意图 -> AI 推断的潜在意图 -> 待确认价值判断 -> 战略结果 -> 可执行动作 -> 验收证据;链路断开的字段必须重写。
+- `User-stated intent` 只记录用户明确说过或上下文中已确认的意图,不替用户补充动机。
+- `AI-inferred potential intent` 单独列出基于上下文的推断及依据,明确标记为可修正假设,不冒充用户原意。
+- `Value judgments requiring confirmation` 单独列出会影响优先级、质量线、风险容忍、范围或取舍的价值判断。若它会改变路线,先问一个阻塞问题;不得把未确认判断静默写进 Goal。
- `Strategic outcome` 和 `Decision standard` 必须解释为什么这个 goal 符合用户意图,而不是只描述交付物。
- 如果换掉项目名、文件名或用户场景后仍然成立,就太泛;补对象、边界、先读材料、检查点或暂停条件。
-- `Loop Prompt` 必须绑定上一轮交付物和验证证据,不能写成一个不看结果的新 goal;它必须先给可填写的时间参数,再包含可继承的 loop state 和下一轮 LOOP 生成规则。
+- 仅在通过 Loop 需求判断门时检查:`Loop Prompt` 必须绑定上一轮交付物和验证证据,不能写成一个不看结果的新 goal;它必须先给可填写的时间参数,再包含可继承的 loop state 和下一轮 LOOP 生成规则。
- 如果不同解释会改变路线、风险、权限、范围或验收,先问一个阻塞问题,并给出推荐答案;能通过读取上下文解决的问题,不要丢给用户。
## Workflow lens
@@ -52,7 +65,7 @@ GoalPro 的交付物是可复制的提示词,不是任务执行结果。默认
- 触发信号:每天、每周、自动、持续、发布、运营、监控、队列、复盘、提醒、审核、同步、巡检、内容日历。
- 先判断这是不是一个可委托的重复模式:是否有稳定输入、触发时机、执行步骤、人工确认点、输出记录和复盘证据。
-- 如果是重复 workflow,只把必要信息写进 `Goal Prompt` 和 `Loop Prompt`:在 Goal 的 `Decision standard` / `Execution policy` 或可选 `Workflow lens` 段里写清判断,在 Loop 里写清 Trigger、Checkpoint、Brief、source of truth、非目标。
+- 如果是重复 workflow,只把必要信息写进适用的提示词:在 Goal 的 `Decision standard` / `Execution policy` 或可选 `Workflow lens` 段里写清判断;存在真实循环时,再在 Loop 里写清 Trigger、Checkpoint、Brief、source of truth、非目标。
- `Trigger` 说明每轮何时开始:事件触发通常优先于固定时间;固定时间只是时间参数,不等于已创建后台任务。
- `Checkpoint` 要尽量后移:先让执行者把材料准备好,再让用户确认一次关键判断,而不是开头问一串问题。
- `Brief` 是给用户看的决策摘要:做了什么、为什么、证据在哪、推荐动作是什么;不要把原始草稿或日志直接丢给用户审。
@@ -77,8 +90,8 @@ Deep Research 执行顺序:
5. 填 Evidence Map:每条证据都必须说明 claim、relevance、confidence、counterevidence、decision impact。
6. 反证检查:主动找能推翻当前路线的证据;冲突保留,不强行合并。
7. 定信心等级:high / medium / low,并说明依据。
-8. 选输出形态:证据足够才输出 `Research-backed Goal Prompt + Loop Prompt`;不足输出 `Draft Goal + Draft Loop` 或 `Research Plan`。
-9. 写回 Goal / Loop:研究结果必须改变 Decision standard、Evidence standard、Scope、Non-goals、Execution policy、Verification、Stop conditions 或 Loop 的时间参数、Review evidence、Gap diagnosis、Verification delta、自动化设置边界、Continuation protocol、Next LOOP packet;否则不算 deep research。
+8. 选输出形态:证据足够才输出 `Research-backed Goal Prompt`;不足输出 `Draft Goal` 或 `Research Plan`。仅在通过 Loop 需求判断门时追加相应 Loop。
+9. 写回 Goal / 可选 Loop:研究结果必须改变 Decision standard、Evidence standard、Scope、Non-goals、Execution policy、Verification、Stop conditions;若生成 Loop,还必须改变其时间参数、Review evidence、Gap diagnosis、Verification delta、自动化设置边界、Continuation protocol 或 Next LOOP packet,否则不算 deep research。
`Evidence Map` 格式:
@@ -100,11 +113,11 @@ Evidence Map:
1. Critical:先指出用户真正不满、要推进的局面、最大误伤点。
2. Fetch:只读取会改变战略、边界、验收或执行路线的材料;战略任务先做 deep research。
3. Thinking:比较路线,写清取舍;把反例、未知和信心等级放进判断。
-4. Workflow lens:如果请求是重复性工作,先判断它配不配变成 workflow;需要时把 Trigger、Checkpoint、Brief 和 source of truth 写进 Goal Prompt / Loop Prompt。
+4. Workflow lens:如果请求是重复性工作,先判断它配不配变成 workflow;需要时把 Trigger、Checkpoint、Brief 和 source of truth 写进 Goal Prompt。
5. Inventory:涉及代码库、文档库或复杂系统时,先列会受影响的文件、调用方、测试和验证入口,再允许执行。
6. Contract:写 Goal Prompt,让执行者知道做什么、不做什么、先读什么、何时停。
7. Review:用成败标准反查合同,删掉装饰性流程,保留关键判断。
-8. Loop:写 Loop Prompt,让交付结果回来后能按证据复盘、收敛差距、输出下一轮 LOOP 包,直到 Done 或 Pause。
+8. Loop gate:只有存在真实后续迭代需求时,才写 Loop Prompt,让交付结果回来后能按证据复盘、收敛差距、输出下一轮 LOOP 包,直到 Done 或 Pause。
9. Expression economy:最后才压缩表达;不得牺牲意图完成度、执行边界或 Loop 的停止条件。
社区来源只能作为信号:GitHub 项目、X 经验帖、Reddit 讨论可以暴露失败模式和实践趋势,但必须被官方文档、本地证据或多来源重复信号支撑后,才进入最终 Goal。
@@ -113,7 +126,9 @@ Evidence Map:
一个 Goal 达标,必须回答清楚:
-- `真实意图`:用户真正要改变的局面,不是复述原话。
+- `用户明确表达的意图`:只写用户明确提出或已确认的目标、限制和不满。
+- `AI 推断的潜在意图`:写清推断、依据与不确定性,不冒充已确认事实。
+- `需要用户确认的价值判断`:明确哪些优先级、质量线、风险容忍或取舍仍需用户决定。
- `战略结果`:完成后什么会变好,为什么值得做。
- `成败标准`:什么算赢,什么算没做到,必须可判断。
- `可执行性`:后续执行者是否能照着 goal 开始工作、知道先读什么、做到哪一步、何时暂停。
@@ -125,15 +140,17 @@ Evidence Map:
## 字段标准
-默认输出两个 fenced `markdown` 代码块:先 `Goal Prompt`,再 `Loop Prompt`。每个代码块前必须有代码块外的可见标签 `Goal Prompt:` / `Loop Prompt:`;标签不能放进 fenced block 内,不要只靠字段名暗示;不要把两个提示词合并到同一个代码块里,也不要新增第三个 `Workflow Prompt`。如果用户只明确要求 LOOP,则只输出 Loop Prompt,并要求用户贴入上一轮结果或 `Next LOOP packet`。
+默认输出一个 fenced `markdown` 代码块,并在代码块外显示标签 `Goal Prompt:`。只有通过 Loop 需求判断门时,才在其后追加第二个独立代码块,并显示标签 `Loop Prompt:`。标签不能放进 fenced block 内;不要合并两个提示词,也不要新增第三个 `Workflow Prompt`。
-不要输出 `原始输入 / 优化后的理解 / 优化后的完整提示词` 这类 meta prompt rewrite 包装,除非用户明确要求做 meta-theory 改写;GoalPro 的默认正文就是可复制的 Goal Prompt + Loop Prompt。
+不要输出 `原始输入 / 优化后的理解 / 优化后的完整提示词` 这类 meta prompt rewrite 包装,除非用户明确要求做 meta-theory 改写;GoalPro 的默认正文就是可复制的 Goal Prompt,以及满足条件时的 Loop Prompt。
Goal Prompt:
```markdown
Goal:
-Intent:
+User-stated intent:
+AI-inferred potential intent:
+Value judgments requiring confirmation:
Strategic outcome:
Decision standard:
Evidence standard:
@@ -168,7 +185,9 @@ Next LOOP packet:
| 字段 | 写什么 | 合格标准 | 常见错误 |
|---|---|---|---|
| `Goal` | 一句话任务 | 有对象、有动作、有方向,执行者能立即知道要做什么 | 写成愿景 |
-| `Intent` | 放大后的真实意图 | 说清用户真正要改变的局面 | 复述原话 |
+| `User-stated intent` | 用户明确表达的意图 | 仅包含用户说过或已确认的目标、限制和不满 | 把 AI 猜测写成用户原意 |
+| `AI-inferred potential intent` | AI 推断的潜在意图 | 标注推断依据、不确定性和可修正性 | 省略“推断”标签或过度心理揣测 |
+| `Value judgments requiring confirmation` | 需要用户确认的价值判断 | 列出会改变优先级、质量线、风险容忍、范围或取舍的判断;无则明确写无 | 静默替用户决定“更重要”“更好”或“可接受” |
| `Strategic outcome` | 最终战略结果 | 能解释为什么这次工作值得做 | 只写交付物 |
| `Decision standard` | 路线判断标准 | 明确优先级、取舍和失败条件 | “高质量”但不可判 |
| `Evidence standard` | 证据要求 | 区分来源、验证、人工验收和信心等级 | 搜到资料就算完成 |
@@ -204,34 +223,35 @@ Next LOOP packet:
## 输出位置规则
- 默认位置:聊天窗口。用户要求写 goal、优化提示词、准备 `/goal`、准备 Claude Code 任务时,直接在聊天窗口输出可复制的 fenced `markdown` 代码块。
-- 文件位置:只有用户明确要求保存、写入文件、生成文档、提交 git、更新项目资料,才把 Goal Prompt / Loop Prompt 写入文件。
-- 双输出:一旦写入文件,聊天窗口仍必须同步输出同一份可复制的 Goal Prompt / Loop Prompt 代码块,并说明文件路径。
+- 文件位置:只有用户明确要求保存、写入文件、生成文档、提交 git、更新项目资料,才把适用的 Goal Prompt / Loop Prompt 写入文件。
+- 双输出:一旦写入文件,聊天窗口仍必须同步输出同一份可复制提示词代码块,并说明文件路径。
- 不确定时:默认聊天窗口输出,不要为了“完整”自动创建文件。
- 文件建议路径:目标文档优先用 `docs/goals/