mcpField
G
goal-framing

goal-framing

github.com/ganyuanranAgent 工作流1.4k52 次安装3 天前更新
代码仓库

关于 goal-framing

goal-framing 是一项可选的 Aegis 技能,用于在开始工作前建立简洁的目标与边界框架。它适合需要明确成功证据、停止条件、范围和非目标的任务,随后将工作导向相应流程。

主要功能

  1. 01起草简洁的任务意图框架
  2. 02定义成功证据与停止条件
  3. 03记录范围、约束和非目标
  4. 04将目标框架导向相应流程
  5. 05为委派任务提供上下文包
  6. 06跟踪目标与范围的变化

适用场景

  1. 01为多步骤任务设定边界
  2. 02明确任务何时算完成
  3. 03在实施前列出排除事项
  4. 04向子 Agent 传递精简任务背景

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ganyuanran/aegis --skill goal-framing

安装后在 Claude Code 中输入/goal-framing确认已加载。

详细介绍

Aegis 目标界定

使用此技能在执行前建立精简的目标框架。此操作为可选项,仅用于设定边界。

除非用户明确要求 /aegis-goal 或 Aegis goal:,否则不要将其用于微小编辑、单命令检查或常规快速问答。

权限边界

当前负责:

  • Method Pack 任务界定

不负责:

  • 权威的 GateDecision
  • 最终证据是否充分
  • 最终完成权限不在此范围内
  • 主机守护进程/自动停止强制执行

输入形式

以下形式视为等同:

  • /aegis-goal <task description>
  • Aegis goal: <task description>
  • “在开始前定义目标/停止条件”

斜杠命令是可选的主机快捷方式。自然语言形式是可移植的备用方式。

示例:

Aegis goal: Fix the auth refresh bug without rewriting the auth system.

输出

生成最精简且有用的框架,然后在同一轮中继续进入路由后的工作流。

TaskIntentDraft:
- Requested outcome:
- Goal:
- Success evidence:
- Stop condition:
- Non-goals:
- Constraints:
- Scope:
- Risk hints:
- Aegis Visibility:
- Route:
- Next:

默认行为:

  • 不要在 TaskIntentDraft 后停止。
  • 将框架视为执行的启动协议,而非最终答案。
  • 用户要求执行工作时,在简明框架之后,立即对所选路由采取 Next 操作。
  • 目标明确时,保持框架自然简短;除非用户要求正式框架,否则不要输出看起来像内部文档的大型卡片。
  • 使用 Aegis Visibility 说明目标框架为何会约束路由、停止条件或非目标。除非用户明确要求可审计性,否则不要添加繁琐的追踪记录。

仅输出框架时的行为:

  • 只有当用户明确要求仅定义目标、仅定义停止条件、不执行、不实施、不编写计划,或在继续前等待确认时,才仅停留在框架阶段。
  • 如果缺少必要信息,指出缺少的输入并以 blocked 状态停止,不要假装继续。

停止条件必须区分以下状态:

状态集:done、blocked、needs-verification、scope-exceeded。

  • done:已满足成功证据要求
  • blocked:缺少必要的依赖项、权限或信息
  • needs-verification:已完成实施,但证据不足
  • scope-exceeded:继续将超出目标或非目标范围

路由

界定目标后:

  • 低风险、单一负责人任务按常规快速路径或 TDD 继续
  • 含糊的产品/架构/契约工作转至 brainstorming
  • 已批准的需求转至 writing-plans
  • 多步骤、易受上下文压缩影响、涉及交接或子 Agent 的工作转至 long-task-continuation
  • Bug 诊断转至 systematic-debugging
路由矩阵
目标信号路由
单一负责人、低风险、验证方式明确快速路径或 test-driven-development
Bug、故障、回归、意外行为systematic-debugging
含糊的产品、架构、契约或跨模块行为brainstorming
已批准的规范、稳定的需求、实施拆分writing-plans
多步骤、易受上下文压缩影响、涉及交接或子 Agent 的工作long-task-continuation
完成、发布、交接、“这算完成了吗?”verification-before-completion

只有在路由后的工作流需要持久化证据时,才创建 docs/aegis/ 记录。仅界定目标不会创建项目文件。

子 Agent 上下文包

委派工作时,传递精简上下文包,而不是完整对话:

SubagentContextPacket:
- Task:
- Goal:
- Stop condition:
- Relevant baseline refs:
- Relevant files:
- Known facts:
- Unknowns:
- Non-goals:
- Expected output:
- Verification expected:
- Must-read excerpts:
- Unsafe assumptions:

此上下文包可减少重复读取文件,但不能替代证据。子 Agent 仍应读取验证关键事实所需的最小原始文件/日志/测试摘录。

不要将完整聊天记录、完整会话历史或无界日志粘贴到上下文包中。如果某项事实很重要,请提供文件引用、行号/范围提示或精简的必读摘录。

目标漂移规则

如果任务中途目标发生变化,不要悄悄覆盖原目标。记录旧目标、新目标、范围变化和新风险;如果存在长期任务记录,则通过 DriftCheckDraft 路由处理。

评论

支持 Markdown