关于 goal-framing
goal-framing 是一项可选的 Aegis 技能,用于在开始工作前建立简洁的目标与边界框架。它适合需要明确成功证据、停止条件、范围和非目标的任务,随后将工作导向相应流程。
主要功能
- 01起草简洁的任务意图框架
- 02定义成功证据与停止条件
- 03记录范围、约束和非目标
- 04将目标框架导向相应流程
- 05为委派任务提供上下文包
- 06跟踪目标与范围的变化
适用场景
- 01为多步骤任务设定边界
- 02明确任务何时算完成
- 03在实施前列出排除事项
- 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