goal-oriented

name	goal-oriented
version	2.0.0
description	MUST use for ANY user request. This is a rigid requirement that applies to all tasks and conversations.
category	planning
complexity	low
typical_duration	5min
dependencies	[]
benefits-from	[]
conflicts-with	[]
output_artifact	memory/artifacts/goal-oriented/
allowed-tools	["Read","Write","Edit","Bash","Glob"]
tags	["任务规划","目标管理","需求分析","项目启动"]

目标导向思维

前置协议

环境检测

# 检测当前项目信息
PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo "unknown")
BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")

echo "PROJECT: $PROJECT_ROOT"
echo "BRANCH: $BRANCH"
echo "COMMIT: $COMMIT"

# 检查是否在 Git 仓库中
if [ "$PROJECT_ROOT" = "unknown" ]; then
  echo "WARNING: Not in a Git repository"
fi

前置技能检查

dependencies 检查（无依赖）：

此技能无前置依赖，可直接执行。

工件目录初始化：

# 确保工件目录和目标目录存在
mkdir -p memory/artifacts/goal-oriented
mkdir -p memory/goals

用户意图确认

根据用户消息判断：

检查点：

• 用户请求是否包含任务特征（行动指令、多步骤需求）
• 是否需要创建新目标、更新现有目标或验证目标
• 确定是纯信息查询还是需要执行的任务

意图分类：

1. 创建目标：用户提出新任务，当前无 pending 目标
2. 调整目标：用户修改需求，当前有 pending 目标
3. 验证目标：AI 认为完成，需要验证目标达成情况
4. 查询/对话：纯信息查询或简单问答，无需创建目标

需求细化与方案探索（强制）（新增）

触发时机：创建目标文件后，执行任务前

强制动作：依次调用前置技能链

前置技能链：

1. prompt-enhancer（需求细化+方案探索）

触发条件：

• 用户需求模糊或不完整
• 复杂任务（涉及多个模块/系统）
• 需要探索多种方案

执行步骤：

创建目标后 → 调用 prompt-enhancer
    ↓
需求细化（每个关键点问3-4问题）
    ↓
方案探索（头脑风暴3-5种方案）
    ↓
用户选择方案
    ↓
生成需求方案工件

工件位置：memory/artifacts/prompt-enhancer/result-{timestamp}.json

价值：

• 避免理解偏差
• 充分论证方案
• 发现隐藏需求

---

2. planning（实施规划+plan-review）

触发时机：prompt-enhancer 完成后

强制动作：生成实施计划并经过用户确认

执行步骤：

读取需求方案工件 → planning
    ↓
步骤分解（MECE原则）
    ↓
依赖识别
    ↓
资源规划
    ↓
风险评估
    ↓
生成实施计划
    ↓
plan-review（用户确认）
    ↓
生成实施计划工件

工件位置：memory/artifacts/planning/result-{timestamp}.json

价值：

• 明确执行路径
• 识别依赖关系
• 提前评估风险
• 用户确认计划

---

经验检索（强制）

触发时机：planning 完成后

强制动作：调用 experience-manager 技能检索历史经验

执行步骤：

1. 提取关键词

   从用户原始需求中提取关键词：
   - 技术关键词：框架、库、工具名称
   - 功能关键词：核心功能描述
   - 问题关键词：错误类型、问题场景
   

2. 写入请求工件

   Write(
     file_path="memory/artifacts/goal-oriented/experience-request.json",
     content={
       "requesting_skill": "goal-oriented",
       "action": "retrieve",
       "task_keywords": ["关键词1", "关键词2"],
       "task_type": "bugfix|feature|refactor",
       "technologies": ["Technology1", "Technology2"]
     }
   )
   

3. 等待 experience-manager 处理

   • experience-manager 自动检测到请求工件
   • 执行四层级检索并生成结果工件

4. 读取结果工件

   result = Read("memory/artifacts/experience-manager/experience-result.json")
   

5. 展示给用户

   ## 📚 历史经验参考
   
   ### ⚠️ 错误预防（来自历史任务）
   ...
   
   ### 🎯 可复用模式
   ...
   
   ### 💡 改进建议
   ...
   

价值：避免重复错误，快速复用成功经验。

经验沉淀（强制）

触发时机：目标标记为 completed 后

强制动作：调用 experience-manager 技能沉淀经验

执行步骤：

1. 收集回顾数据

   从目标文件中提取：
   - 原始需求（用户表述）
   - SMART 目标（具体、可衡量）
   - 执行过程（里程碑、调整历史）
   - 验证结果（完成情况）
   

2. 生成经验总结

   - 做得好的（What Went Well）
   - 需要改进的（What Could Be Improved）
   - 错误与修复（Errors & Fixes）
   - 知识沉淀（Knowledge Gained）
   - 改进建议（Improvements）
   

3. 写入请求工件

   Write(
     file_path="memory/artifacts/goal-oriented/experience-save-request.json",
     content={
       "requesting_skill": "goal-oriented",
       "action": "save",
       "task_id": "2026-03-24_HHMM_task-keywords",
       "task_summary": "任务简要描述",
       "lessons_learned": [...],
       "errors_fixed": [...],
       "knowledge_gained": [...]
     }
   )
   

4. 等待 experience-manager 处理

   • experience-manager 自动检测到请求
   • 执行四层级沉淀（CLAUDE.md、AGENT.md、MEMORY.md、MCP Memory）

5. 确认沉淀完成

   result = Read("memory/artifacts/experience-manager/save-result.json")
   if result.status == "success":
       print("✅ 经验已沉淀到四层级知识库")
   

价值：积累知识资产，持续优化执行策略。

里程碑复盘（强制）（新增）

触发时机：里程碑完成时

强制动作：调用 experience-manager 技能进行复盘

目的：保留好的，改掉坏的，持续优化

执行步骤：

1. 识别里程碑完成

   当使用 Edit 工具更新里程碑记录时，检测是否为里程碑完成
   

2. 触发复盘请求

   Write(
     file_path="memory/artifacts/goal-oriented/milestone-review-request.json",
     content={
       "requesting_skill": "goal-oriented",
       "action": "review",
       "task_id": "当前目标ID",
       "milestone": "里程碑描述",
       "milestone_status": "completed",
       "review_type": "milestone"
     }
   )
   

3. 等待 experience-manager 处理

   • experience-manager 分析里程碑得失
   • 保留好的做法，改掉坏的做法
   • 更新四层级知识库

4. 读取复盘结果

   result = Read("memory/artifacts/experience-manager/review-result.json")
   
   展示给用户：
   ## 🎯 里程碑复盘结果
   
   ### ✅ 保留好的
   - 成功经验1
   - 成功经验2
   
   ### ❌ 改掉坏的
   - 改进项1
   - 改进项2
   
   ### 💡 后续优化建议
   - 建议1
   - 建议2
   

价值：阶段性复盘，及时调整策略，避免在错误方向上走太远。

整体复盘与反思（强制）（新增）

触发时机：目标整体完成后

强制动作：调用 experience-manager 技能进行深度复盘和反思

目的：深度分析得失，提炼智慧，好则加冕，错则改之

执行步骤：

1. 标记目标完成后立即触发

   当目标状态更新为 "completed" 时，自动触发复盘和反思
   

2. 发起深度复盘

   Write(
     file_path="memory/artifacts/goal-oriented/deep-review-request.json",
     content={
       "requesting_skill": "goal-oriented",
       "action": "review",
       "task_id": "当前目标ID",
       "review_type": "project_end",
       "include_reflection": true,
       "analyze_milestones": true,
       "extract_wisdom": true
     }
   )
   

3. 等待 experience-manager 深度分析

   • 分析整个任务执行过程
   • 评估每个里程碑的得失
   • 提炼可迁移的智慧
   • 识别需要反思的过时经验

4. 读取复盘反思结果

   result = Read("memory/artifacts/experience-manager/deep-review-result.json")
   
   展示给用户：
   ## 🏆 任务整体复盘与反思
   
   ### 📊 整体表现
   - 执行时长：X小时
   - 里程碑数：X个
   - 成功率：X%
   - 经验应用：X次
   
   ### ✅ 保留好的（好则加冕）
   
   #### 成功经验
   1. **经验1**
      - 应用效果：...
      - 推广建议：写入 CLAUDE.md 强制规则
   
   2. **经验2**
      - 应用效果：...
      - 推广建议：写入 AGENT.md 标准策略
   
   ### ❌ 改掉坏的（错则改之）
   
   #### 失败教训
   1. **教训1**
      - 失败原因：...
      - 改进方案：...
      - 预防措施：...
   
   2. **教训2**
      - 失败原因：...
      - 改进方案：...
      - 预防措施：...
   
   ### 🔄 需要反思的经验
   
   1. **过时经验**
      - 原经验：...
      - 失效原因：技术栈升级
      - 更新方案：...
   
   2. **不完整经验**
      - 原经验：...
      - 局限性：...
      - 完善方案：...
   
   ### 💡 智慧提炼
   
   **表层经验**：
   - 具体的技术做法
   
   **深层智慧**：
   - 方法论层面的思考
   - 可迁移的模式
   - 通用的原则
   
   ### 📋 后续行动
   
   - [ ] 更新规则（CLAUDE.md）
   - [ ] 更新策略（AGENT.md）
   - [ ] 更新知识（MEMORY.md）
   - [ ] 标记过时经验
   - [ ] 编写最佳实践指南
   

5. 执行改进计划

   根据复盘结果，立即执行改进：
   - 更新四层级知识库
   - 标记过时经验
   - 创建改进任务
   - 通知相关技能维护者
   

价值：

• 深度学习，持续改进
• 避免重复犯错
• 积累智慧资产
• 形成正向循环

示例：

## 🏆 任务整体复盘与反思

**任务**: 优化 methodology-skills 项目的文档结构

### ✅ 保留好的（好则加冕）

1. **三级文档目录结构**
   - 应用效果：5次应用，100%成功
   - 推广建议：写入 CLAUDE.md 强制规则
   - 行动：已完成

2. **README.md 导航文件**
   - 应用效果：提升查找效率50%
   - 推广建议：写入 AGENT.md 标准策略
   - 行动：已完成

### ❌ 改掉坏的（错则改之）

1. **文档命名规范不完善**
   - 问题：design-YYYY-MM-DD.md 排序不直观
   - 改进：改为 YYYY-MM-DD-design-{title}.md
   - 行动：已更新 CLAUDE.md

2. **缺少自动化工具**
   - 问题：手动创建文档结构
   - 改进：创建文档模板工具
   - 行动：本周完成

### 🔄 需要反思的经验

1. **假设用户熟悉 DDD**
   - 原经验：使用 DDD 思想划分文档边界上下文
   - 问题：部分用户不了解 DDD
   - 完善：提供简化的文档分类指南

### 💡 智慧提炼

**表层经验**：
- 文档按功能分类（design/guides/reference）

**深层智慧**：
- 从用户需求出发设计结构
- 简单明了优于复杂完美
- 自动化减少重复劳动

**可迁移模式**：
- 分析本质需求 → 设计分类体系 → 建立导航机制 → 自动化工具支持

Overview

目标导向思维强调以最终目标为指引，所有行动、决策都服务于达成这个目标。它关注的是"我要达到什么结果？"，并确保过程中不偏离方向。

核心原则：以终为始（Begin with the End in Mind）

关键价值：

• 避免任务偏离目标（Scope Creep）
• 确保资源投入在关键路径上
• 快速识别无关工作
• 保持团队方向一致

When to Use

适用场景：

• 需要实现新需求、新想法、新任务
• 执行中长期任务（周期 > 1分钟 或者 步骤>1）
• 项目规划和管理
• 容易偏离目标的复杂任务
• 多任务并行，需要优先级判断
• 资源受限，需要聚焦
• 用户明确要求"目标导向地执行"

不适用场景：

• 简单的、明确的小任务，比如计算1+1=？
• 探索性工作，目标本身不明确

⚠️ 强制执行规则（Iron Law）

⚡ 核心原则：持续触发

每个用户消息都必须触发 goal-oriented 检查，无论之前是否已创建目标。

触发后，根据当前状态执行相应动作：

• 无目标 → 创建目标
• 有 pending 目标 → 检查用户意图（补充/调整/重新开始）
• 有 completed 目标 → 检查是否新任务

---

任务开始时（强制创建目标）

检测标准：

• 用户消息包含行动指令（实现、修复、重构、优化、分析、设计、review等）
• 多步骤需求（需要 1+ 步骤完成）
• 涉及代码编写、文件修改、系统设计、代码审查
• 当前无 pending 目标

强制动作：使用 Write 工具创建目标文件（见"目标文件操作指南"）

无需询问用户，立即执行。

例外情况：

• 纯信息查询（"什么是XXX"、"XXX怎么用"）
• 简单问答（是/否问题、知识咨询）
• 用户明确表示"只是问问"、"随便聊聊"
• 已存在 pending 目标（转到"任务执行中"规则）

如果对话中途演变成任务，必须补创建目标。

---

任务执行中（强制调整目标）

触发条件：

• 已存在 pending 目标
• 用户继续提供需求细节
• 用户明确修改需求（"算了"、"改成"、"加一个"、"另外还要"）
• 用户补充新的要求或约束
• 环境变化导致目标不可行

强制动作：使用 Edit 工具调整目标文件（见"目标文件操作指南"）

调整原则：

• 立即同步用户的新意图
• 保留完整的调整历史（版本记录）
• 后续验证使用最新版本目标

用户说"重新实现"、"从头开始"时的处理：

1. 检查现有目标的进展
2. 如果目标未开始执行（无代码、无进度）→ 直接调整现有目标
3. 如果目标已开始执行 → 询问用户：
   • "现有目标已有进展，是创建新目标还是调整现有目标？"
   • 提供：创建新目标 / 调整现有目标 / 取消两个选项

---

任务完成时（强制验证目标）

触发时机：

• AI 认为"完成了"、"做好了"、"实现了"
• 准备提交代码、创建 PR
• 准备结束会话

强制动作：使用 Read 工具读取目标文件并验证（见"目标文件操作指南"）

验证结果处理：

• ✅ 目标达成 → 可标记完成，准备结束会话
• ❌ 目标未达成 → 必须继续执行缺失部分，不得声称"基本完成"

---

违规行为（不可接受）

• ❌ 执行任务但未创建目标
• ❌ 用户调整需求但未更新目标
• ❌ 自称"完成"但未验证
• ❌ 验证失败但声称"基本完成"

任何违反上述规则的行为都是不可接受的。

The Process

digraph goal_oriented_with_tools {
    rankdir=TB;

    "用户首条消息" [shape=box, style=filled, fillcolor="#c8e6c9"];
    "AI 判断：是否包含任务？" [shape=diamond, style=filled, fillcolor="#bbdefb"];
    "使用 Write 工具创建目标文件" [shape=box, style=filled, fillcolor="#fff9c4"];
    "明确最终目标" [shape=box, style=filled, fillcolor="#c8e6c9"];
    "定义成功标准" [shape=box, style=filled, fillcolor="#bbdefb"];
    "识别关键路径" [shape=box, style=filled, fillcolor="#fff9c4"];
    "执行与监控" [shape=box, style=filled, fillcolor="#f8bbd0"];
    "里程碑完成检查" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "使用 Edit 工具更新里程碑" [shape=box, style=filled, fillcolor="#ffccbc"];
    "用户提出调整？" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "使用 Edit 工具调整目标" [shape=box, style=filled, fillcolor="#ffccbc"];
    "AI 判断任务完成？" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "使用 Read 工具验证目标" [shape=box, style=filled, fillcolor="#ffccbc"];
    "目标达成验证" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "继续执行缺失部分" [shape=box, style=filled, fillcolor="#f8bbd0"];
    "使用 Edit 工具标记完成" [shape=box, style=filled, fillcolor="#81c784"];
    "保存工件到 memory/artifacts/" [shape=box, style=filled, fillcolor="#81c784"];
    "可结束会话" [shape=doublecircle, style=filled, fillcolor="#81c784"];
    "正常对话" [shape=box, style=filled, fillcolor="#f8bbd0"];

    "用户首条消息" -> "AI 判断：是否包含任务？";
    "AI 判断：是否包含任务？" -> "使用 Write 工具创建目标文件" [label="是"];
    "AI 判断：是否包含任务？" -> "正常对话" [label="否"];
    "使用 Write 工具创建目标文件" -> "明确最终目标";
    "明确最终目标" -> "定义成功标准";
    "定义成功标准" -> "识别关键路径";
    "识别关键路径" -> "执行与监控";
    "执行与监控" -> "里程碑完成检查";
    "里程碑完成检查" -> "使用 Edit 工具更新里程碑" [label="是"];
    "使用 Edit 工具更新里程碑" -> "用户提出调整？";
    "里程碑完成检查" -> "用户提出调整？" [label="否"];
    "用户提出调整？" -> "使用 Edit 工具调整目标" [label="是"];
    "用户提出调整？" -> "AI 判断任务完成？" [label="否"];
    "使用 Edit 工具调整目标" -> "执行与监控";
    "AI 判断任务完成？" -> "使用 Read 工具验证目标" [label="是"];
    "AI 判断任务完成？" -> "执行与监控" [label="否"];
    "使用 Read 工具验证目标" -> "目标达成验证";
    "目标达成验证" -> "继续执行缺失部分" [label="未达成"];
    "目标达成验证" -> "使用 Edit 工具标记完成" [label="达成"];
    "使用 Edit 工具标记完成" -> "保存工件到 memory/artifacts/";
    "保存工件到 memory/artifacts/" -> "可结束会话";
    "继续执行缺失部分" -> "执行与监控";
}

步骤详解

步骤 1: AI 判断是否包含任务

• 分析用户首条消息
• 检测任务特征（行动指令、多步骤需求）
• 决定是否触发目标追踪

步骤 2: 使用 Write 工具创建目标文件（强制）

• 自动创建目标文件
• 记录用户原始需求
• 提取 SMART 目标

步骤 3: 明确最终目标

• 用一句话陈述最终目标
• 确保目标符合 SMART 原则
• 区分"目标"和"手段"

步骤 4: 定义成功标准

• 如何判断目标达成？
• 设置可衡量的指标
• 明确验收条件

步骤 5: 识别关键路径

• 找出达成目标的必经之路
• 识别阻塞任务和依赖关系
• 确定优先级

步骤 6: 执行与监控

• 按照关键路径执行
• 持续监控进度
• 记录偏差和问题

步骤 7: 里程碑完成检查

• 识别阶段性成果
• 触发里程碑更新

步骤 8: 使用 Edit 工具更新里程碑（可选）

• 更新里程碑进展
• 保持进度透明

步骤 9: 用户提出调整？（强制）

• 监听用户需求变更
• 立即调整目标

步骤 10: 使用 Edit 工具调整目标（强制）

• 更新 SMART 目标
• 保留历史版本
• 同步新意图

步骤 11: AI 判断任务完成？

• AI 自我评估
• 触发强制验证

步骤 12: 使用 Read 工具验证目标（强制）

• 对比原始目标 vs 实际完成
• 识别缺失项
• 输出验证结果

步骤 13: 目标达成验证

• 判断是否完全达成
• 决定后续行动

步骤 14: 继续执行缺失部分（如果未达成）

• 补充缺失功能
• 不得声称"基本完成"

步骤 15: 使用 Edit 工具标记完成

• 更新目标文件状态
• 记录完成时间
• 准备结束会话

步骤 16: 保存工件到 memory/artifacts/

• 生成工件 JSON 文件
• 创建 latest.json 符号链接
• 记录后续建议技能

Goal Decomposition Tool

使用以下清单确保目标清晰且可执行：

• 目标陈述: 用一句话清晰描述最终目标
• 成功标准（SMART）:
  • Specific（具体的）: 明确要达成什么
  • Measurable（可衡量）: 有量化指标
  • Achievable（可实现）: 资源和能力可行
  • Relevant（相关性）: 与大局目标一致
  • Time-bound（时限）: 有明确的截止时间
• 关键里程碑: 分解为 3-5 个关键节点
• 潜在干扰因素: 识别可能偏离目标的风险
• 偏离预警信号: 设置触发调整的阈值

目标分解示例：

目标: 重构用户认证模块，提升安全性

成功标准:
- [x] Specific: 重构认证模块，消除安全隐患
- [x] Measurable: 测试覆盖率 > 90%，无高危漏洞
- [x] Achievable: 2人周，技术栈不变
- [x] Relevant: 降低安全事故风险
- [x] Time-bound: 2周内完成

关键里程碑:
- M1: 完成现有代码审计（Day 3）
- M2: 实现核心重构（Day 7）
- M3: 测试通过并上线（Day 10）

潜在干扰因素:
- 新需求插入
- 依赖服务变更
- 团队成员抽调

偏离预警信号:
- 里程碑延期 > 20%
- 新增非核心功能
- 讨论偏离认证安全主题

目标文件操作指南

目标文件位置

存储路径：memory/goals/YYYY-MM-DD_HHMM_目标关键词.md

关键词提取规则：从 smart_specific 中提取前20个非空格字符作为文件名

目录创建：如果 memory/goals/ 目录不存在，需先创建

---

操作1：创建目标（create）

触发时机：任务开始时（强制）

执行步骤：

1. 提取时间戳

   timestamp = "2026-03-23_2005"  # 格式：YYYY-MM-DD_HHMM
   

2. 提取关键词

   keywords = smart_specific.replace(" ", "")[:20]
   # 示例："修复英文页面404错误，确保路由正常工作" → "修复英文页面404错误，确保路由"
   

3. 组装文件路径

   file_path = f"memory/goals/{timestamp}_{keywords}.md"
   

4. 使用 Write 工具创建文件，填充以下模板：

# 目标追踪记录

## 原始需求
{用户原始表述}

## 目标提取（SMART）
- **Specific（具体）**: {具体目标}
- **Measurable（可衡量）**: {衡量标准}
- **Achievable（可实现）**: 待评估
- **Relevant（相关）**: 待说明
- **Time-bound（时限）**: 本次会话

## 创建信息
- 创建时间：{YYYY-MM-DD HH:MM}
- 会话ID：当前会话
- 当前版本：1

## 目标调整历史

### 版本 1（{时间}）
- **SMART-Specific**: {具体目标}
- **SMART-Measurable**: {衡量标准}

## 验证记录
（待填写）

## 最终状态
- 状态：pending
- 完成时间：-
- 备注：-

完整示例：

用户消息："现在在中文时候跳转一切正常，但是英文时候全是404，和最开始中文的bug一样"

AI 执行：
1. 提取时间戳："2026-03-23_2005"
2. 提取关键词："修复英文页面404错误，确保路由"
3. 文件路径："memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md"

Write(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  content="""
# 目标追踪记录

## 原始需求
现在在中文时候跳转一切正常，但是英文时候全是404，和最开始中文的bug一样

## 目标提取（SMART）
- **Specific（具体）**: 修复英文页面的404错误，确保路由正常工作
- **Measurable（可衡量）**: 所有英文页面可正常访问，无404错误
- **Achievable（可实现）**: 待评估
- **Relevant（相关）**: 待说明
- **Time-bound（时限）**: 本次会话

## 创建信息
- 创建时间：2026-03-23 20:05
- 会话ID：当前会话
- 当前版本：1

## 目标调整历史

### 版本 1（2026-03-23 20:05）
- **SMART-Specific**: 修复英文页面的404错误，确保路由正常工作
- **SMART-Measurable**: 所有英文页面可正常访问，无404错误

## 验证记录
（待填写）

## 最终状态
- 状态：pending
- 完成时间：-
- 备注：-
"""
)

✅ 输出："目标已创建：memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md"

---

操作2：更新里程碑（update）

触发时机：阶段性完成时

执行步骤：

1. 使用 Read 工具读取目标文件（可选，确认当前内容）

2. 使用 Edit 工具追加里程碑内容，在 ## 验证记录 前插入：

Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="## 验证记录",
  new_string="""### 里程碑：{里程碑描述}
更新时间：{YYYY-MM-DD HH:MM}

## 验证记录"""
)

完整示例：

里程碑描述："诊断完成，发现英文路由配置问题"
时间："2026-03-23 20:10"

Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="## 验证记录",
  new_string="""### 里程碑：诊断完成，发现英文路由配置问题
更新时间：2026-03-23 20:10

## 验证记录"""
)

✅ 输出："已更新里程碑：诊断完成，发现英文路由配置问题"

---

操作3：调整目标（adjust）

触发时机：用户修改需求时（强制）

执行步骤：

1. 使用 Read 工具读取目标文件，提取当前版本号

2. 使用 Edit 工具依次更新：

   • 更新版本号
   • 更新 SMART 目标
   • 追加调整历史

完整示例：

用户消息："对了，还要优化路由架构，不只是修复404"

AI 执行：

# 步骤1：读取文件，当前版本号为 1
Read(file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md")

# 步骤2：更新版本号（1 → 2）
Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="当前版本：1",
  new_string="当前版本：2"
)

# 步骤3：更新 SMART-Specific
Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="- **Specific（具体）**: 修复英文页面的404错误，确保路由正常工作",
  new_string="- **Specific（具体）**: 修复英文页面404错误，并优化路由架构"
)

# 步骤4：更新 SMART-Measurable
Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="- **Measurable（可衡量）**: 所有英文页面可正常访问，无404错误",
  new_string="- **Measurable（可衡量）**: 所有英文页面正常访问，路由架构清晰，无冗余路由"
)

# 步骤5：追加调整历史
Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="## 验证记录",
  new_string="""### 版本 2（2026-03-23 20:15）
- **调整原因**: 用户要求优化路由架构
- **SMART-Specific**: 修复英文页面404错误，并优化路由架构
- **SMART-Measurable**: 所有英文页面正常访问，路由架构清晰，无冗余路由

## 验证记录"""
)

✅ 输出：
"目标已调整"
"调整原因：用户要求优化路由架构"
"新版本：2"

---

操作4：验证目标（verify）

触发时机：AI 认为任务完成时（强制）

执行步骤：

1. 使用 Read 工具读取目标文件

2. 提取 SMART 目标：

   • Specific（具体）
   • Measurable（可衡量）

3. 对比 AI 自评完成情况

4. 输出验证结果：

   • ✅ 目标达成
   • ❌ 目标未达成 + 缺失项列表

完整示例：

AI 自评："已修复英文路由配置，优化了路由架构，所有测试通过"

AI 执行：

Read(file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md")

提取目标：
- Specific: 修复英文页面404错误，并优化路由架构
- Measurable: 所有英文页面正常访问，路由架构清晰，无冗余路由

对比分析：
✅ 修复了英文页面404错误
✅ 优化了路由架构
✅ 所有测试通过

验证结果：
📋 原始目标：修复英文页面404错误，并优化路由架构
🔍 实际完成情况：已修复英文路由配置，优化了路由架构，所有测试通过
✅ 目标达成验证通过

---

操作5：标记完成（complete）

触发时机：目标验证通过后

执行步骤：

使用 Edit 工具更新状态和完成时间：

完整示例：

完成时间："2026-03-23 20:20"

# 步骤1：更新状态
Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="状态：pending",
  new_string="状态：completed"
)

# 步骤2：更新完成时间
Edit(
  file_path="memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md",
  old_string="完成时间：-",
  new_string="完成时间：2026-03-23 20:20"
)

✅ 输出：
"目标已完成"
"完成时间：2026-03-23 20:20"

---

操作6：列出所有目标（list）

触发时机：查看项目所有目标时

执行步骤：

1. 使用 Glob 工具查找 memory/goals/*.md 文件
2. 使用 Read 工具读取每个文件的状态和目标
3. 按状态过滤（可选）

完整示例：

查看所有 pending 状态的目标：

Glob(pattern="memory/goals/*.md")

输出：
1. memory/goals/2026-03-23_2005_修复英文页面404错误，确保路由.md (pending)
2. memory/goals/2026-03-22_1015_重构用户认证模块.md (completed)

Examples

案例 1: 完善 goal-oriented 的完整流程

用户消息： "完善 goal-oriented 的触发条件；只要用户下达了什么任务，这个 goal-oriented skills 就要记录..."

步骤 1: AI 检测到任务，使用 Write 工具创建目标

Write(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  content="""
# 目标追踪记录

## 原始需求
完善 goal-oriented 的触发条件；只要用户下达了什么任务，这个 goal-oriented skills 就要记录...

## 目标提取（SMART）
- **Specific（具体）**: 实现自动目标追踪和验证机制
- **Measurable（可衡量）**: 任务记录,会话结束前验证,未达成继续执行
- **Achievable（可实现）**: 待评估
- **Relevant（相关）**: 待说明
- **Time-bound（时限）**: 本次会话

## 创建信息
- 创建时间：2026-03-18 09:30
- 会话ID：当前会话
- 当前版本：1

## 目标调整历史

### 版本 1（2026-03-18 09:30）
- **SMART-Specific**: 实现自动目标追踪和验证机制
- **SMART-Measurable**: 任务记录,会话结束前验证,未达成继续执行

## 验证记录
（待填写）

## 最终状态
- 状态：pending
- 完成时间：-
- 备注：-
"""
)

✅ 输出：目标已创建：memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md

步骤 2: AI 执行任务，使用 Edit 工具更新里程碑

Edit(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  old_string="## 验证记录",
  new_string="""### 里程碑：Write/Update 「功能」开发完成
更新时间：2026-03-18 10:00

## 验证记录"""
)

✅ 输出：已更新里程碑：Write/Update 「功能」开发完成

步骤 3: 用户补充需求，使用 Edit 工具调整目标

用户消息： "对了，还要支持实时调整目标，防止用户在后续会话中改变主意"

# 更新版本号
Edit(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  old_string="当前版本：1",
  new_string="当前版本：2"
)

# 更新 SMART 目标
Edit(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  old_string="- **Specific（具体）**: 实现自动目标追踪和验证机制",
  new_string="- **Specific（具体）**: 实现自动目标追踪、验证和动态调整机制"
)

# 追加调整历史
Edit(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  old_string="## 验证记录",
  new_string="""### 版本 2（2026-03-18 10:15）
- **调整原因**: 用户补充：需要实时调整目标
- **SMART-Specific**: 实现自动目标追踪、验证和动态调整机制
- **SMART-Measurable**: 任务记录,会话结束前验证,未达成继续执行,实时调整目标

## 验证记录"""
)

✅ 输出：目标已调整，新版本：2

步骤 4: AI 认为完成，使用 Read 工具验证目标

Read(file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md")

提取目标：
- Specific: 实现自动目标追踪、验证和动态调整机制
- Measurable: 任务记录,会话结束前验证,未达成继续执行,实时调整目标

AI 自评："已完成脚本开发、文档更新、支持动态调整"

验证结果：
📋 原始目标：实现自动目标追踪、验证和动态调整机制
🔍 实际完成情况：所有功能已实现并测试通过
✅ 目标达成验证通过

步骤 5: 使用 Edit 工具标记完成

Edit(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  old_string="状态：pending",
  new_string="状态：completed"
)

Edit(
  file_path="memory/goals/2026-03-18_0930_完善goal-oriented触发条件.md",
  old_string="完成时间：-",
  new_string="完成时间：2026-03-18 11:00"
)

✅ 输出：目标已完成

结果：最终交付与最初承诺完全一致，无目标偏离。

案例 2: 产品开发项目的目标管理

目标: 在 3 个月内上线一个 MVP

成功标准:

• 核心功能完整
• 用户测试满意度 > 4.0/5.0
• 无 P0 级 Bug
• DAU > 1000

关键路径:

1. 需求确认（Week 1）
2. 核心功能开发（Week 2-8）
3. 测试与优化（Week 9-10）
4. 上线与推广（Week 11-12）

执行与监控:

• 每周五检查进度
• 发现 Week 6 偏离：团队在优化非核心功能
• 立即调整: 移除非核心功能，聚焦 MVP

结果: 按时上线，达成目标

案例 3: 技术债务清理的目标导向执行

目标: 降低代码复杂度 30%

成功标准:

• 圈复杂度 < 15（原 22）
• 测试覆盖率 > 70%（原 45%）
• 文档完整

执行过程:

• 每天检查: "这次重构是否降低复杂度？"
• 发现偏离: 团队在优化性能（非目标）
• 调整: 提醒聚焦复杂度，性能优化后续专项处理

结果: 复杂度降至 13，覆盖率 75%

Common Pitfalls

误区 1: 目标模糊，无法衡量

• 表现: "把代码写好一点"、"提升用户体验"
• 正确做法: 使用 SMART 原则，明确量化指标

误区 2: 过度关注手段，忘记目的

• 表现: 纠结技术选型 2 周，忘记目标只是"快速上线"
• 正确做法: 定期问"这个手段是否必要？"

误区 3: 忽视环境变化，僵化执行

• 表现: 目标已不现实，但仍然按原计划执行
• 正确做法: 定期重新评估目标的合理性

误区 4: 沉没成本谬误

• 表现: "已经做了 3 周，不能放弃"
• 正确做法: 如果方向错误，立即调整，不考虑沉没成本

误区 5: 未验证就声称完成

• 表现: AI 说"完成了"、"做好了"，但没有使用 Read 工具验证目标
• 正确做法: AI 认为完成时，必须使用 Read 工具读取目标文件并验证

误区 6: 验证失败但跳过缺失项

• 表现: 验证发现目标未完全达成，但 AI 说"基本完成"、"核心功能都有了"
• 正确做法: 必须继续执行缺失部分，直到目标完全达成

误区 7: 用户调整需求但未更新目标

• 表现: 用户说"算了，改成 XXX"，AI 继续按原目标执行
• 正确做法: 立即使用 Edit 工具调整目标文件，同步用户新意图

误区 8: 执行任务但未创建目标

• 表现: AI 开始执行多步骤任务，但没有在开始时创建目标文件
• 正确做法: 会话开始时检测到任务，立即使用 Write 工具创建目标文件

后置协议

工件输出

保存目标创建/调整结果到工件文件：

# 生成工件文件名
TIMESTAMP=$(date +%Y%m%d-%H%M%S)
ARTIFACT_FILE="memory/artifacts/goal-oriented/result-$TIMESTAMP.json"

# 读取目标文件信息
GOAL_FILE=$(ls -t memory/goals/*.md 2>/dev/null | head -1)

if [ -n "$GOAL_FILE" ]; then
  # 提取目标信息
  SMART_SPECIFIC=$(grep "^\*\*Specific" "$GOAL_FILE" | sed 's/.*: *//')
  SMART_MEASURABLE=$(grep "^\*\*Measurable" "$GOAL_FILE" | sed 's/.*: *//')
  GOAL_STATUS=$(grep "状态：" "$GOAL_FILE" | awk '{print $2}')

  # 写入工件
  cat > "$ARTIFACT_FILE" <<EOF
{
  "skill": "goal-oriented",
  "version": "2.0.0",
  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
  "project": "$PROJECT_ROOT",
  "branch": "$BRANCH",
  "commit": "$COMMIT",
  "input": {
    "user_request": "用户的原始请求"
  },
  "output": {
    "goal_file": "$GOAL_FILE",
    "smart_specific": "$SMART_SPECIFIC",
    "smart_measurable": "$SMART_MEASURABLE",
    "status": "$GOAL_STATUS"
  },
  "next_skills": [
    "first-principles",
    "mvp-first",
    "pdca-cycle"
  ]
}
EOF

  echo "ARTIFACT SAVED: $ARTIFACT_FILE"

  # 创建 latest.json 符号链接
  ln -sf "$ARTIFACT_FILE" memory/artifacts/goal-oriented/latest.json
else
  echo "No goal file found, skipping artifact generation"
fi

目标文件更新

如果目标文件存在，记录技能执行：

# 检查是否有 pending 目标
GOAL_FILE=$(ls -t memory/goals/*.md 2>/dev/null | head -1)

if [ -n "$GOAL_FILE" ]; then
  # 检查目标状态
  GOAL_STATUS=$(grep "状态：" "$GOAL_FILE" | awk '{print $2}')

  if [ "$GOAL_STATUS" = "pending" ]; then
    echo "GOAL STATUS: $GOAL_STATUS"
    echo "GOAL FILE: $GOAL_FILE"

    # 可选：使用 Edit 工具添加里程碑记录
    # 例如："goal-oriented 技能执行完成 - {时间}"
  fi
fi

建议后续技能

根据目标类型，推荐后续技能：

推荐格式：

## 后续建议

基于当前目标，建议继续执行：

**推荐技能链**：
1. /first-principles - 从本质思考问题，找到最优解
2. /mvp-first - 如果是复杂系统，进行 MVP 规划
3. /pdca-cycle - 进入 PDCA 循环执行阶段

**根据目标类型选择**：
- **创新问题** → /first-principles
- **复杂系统** → /ddd-strategic-design → /ddd-tactical-design → /mvp-first
- **优化任务** → /pdca-cycle
- **战略分析** → /swot-analysis

是否继续执行？
- A) 执行推荐的技能链
- B) 只执行第一个技能
- C) 不继续，结束当前任务

References

• 《高效能人士的七个习惯》- 以终为始，不忘初心，方得始终
• SMART Goals - Peter Drucker
• OKR 工作法 - John Doerr