К основному содержанию
скилл CX Codex

goal-framing — скилл для Claude Code: рамка задачи и установка

Скилл помогает зафиксировать цель, признаки успеха и границы задачи до начала работы. Он пригодится, когда важно согласовать, что считать результатом и когда остановиться.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add GanyuanRan/Aegis --skill goal-framing -a claude-code
Открыть на GitHub

Что делает goal-framing

По запросу пользователя скилл создаёт короткую рамку задачи: цель, подтверждение успеха, условие остановки, ограничения и область работы. Затем он выбирает маршрут — например, отладку для бага или планирование для согласованных требований — и продолжает работу в том же ответе. Если пользователь просит только сформулировать рамку или не хватает обязательной информации, скилл останавливается.

goal-framing предназначен для явного задания цели через /aegis-goal, фразу Aegis goal: или просьбу определить границы до начала работы. Для мелких правок и обычных вопросов он не включается сам по себе. Он также не принимает окончательное решение о прохождении проверок и не управляет автоматической остановкой. Для субагента скилл собирает краткий контекстный пакет; рамка сама по себе не создаёт файлы проекта.

Какие задачи решает

  • зафиксировать цель и критерии успеха до начала работы
  • задать условие остановки и границы задачи
  • направить баг или согласованные требования в подходящий рабочий процесс
  • передать субагенту краткий контекст вместо всей переписки

Примеры запросов агенту

  • Перед началом работы определи цель, критерии успеха и границы задачи: /aegis-goal исправь обновление авторизации, не переписывая всю систему.
  • Сформулируй цель и условие остановки для этой задачи, пока ничего не выполняй.
  • Определи цель работы над багом и после этого выбери подходящий маршрут отладки.

Как установить goal-framing

1Через Skills CLI (Vercel)

npx skills add GanyuanRan/Aegis --skill goal-framing -a claude-code

2Вручную: положить файлы

~/.claude/skills/goal-framing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/goal-framing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о goal-framing

Как установить goal-framing в Claude Code?

Выполните npx skills add GanyuanRan/Aegis --skill goal-framing -a claude-code. Файл скилла находится по пути ~/.claude/skills/goal-framing/SKILL.md.

Что делает goal-framing?

Он задаёт краткую рамку с целью, признаками успеха, условием остановки и границами задачи, затем направляет работу по подходящему маршруту.

Запускается ли goal-framing для мелких правок?

Нет, если пользователь явно не просит /aegis-goal или не задаёт цель через Aegis goal:. Для небольших правок скилл не включается автоматически.

Исходный текст

SKILL.md · MIT
---
name: goal-framing
description: "Use when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success evidence, stop condition, or task boundaries before work."
---

# Aegis Goal Framing

Use this skill to create a thin goal frame before execution. It is opt-in and
boundary-setting only.

Do not use it for tiny edits, one-command checks, or ordinary fast-path Q&A
unless the user explicitly asks for `/aegis-goal` or `Aegis goal:`.

## Authority Boundary

Current owner:

- Method Pack task framing

Not owned here:

- authoritative `GateDecision`
- final evidence sufficiency
- final completion authority is not owned here
- host daemon / automatic stop enforcement

## Input Forms

Treat these as equivalent:

- `/aegis-goal <task description>`
- `Aegis goal: <task description>`
- "Define the goal / stop condition before we start"

Slash commands are optional host shortcuts. The natural-language form is the
portable fallback.

Example:

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

## Output

Produce the smallest useful frame, then continue into the routed workflow in
the same turn.

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

Default behavior:

- Do not stop after `TaskIntentDraft`.
- Treat the frame as the start protocol for execution, not as the final answer.
- After the compact frame, immediately take the `Next` action for the selected
  route when the user asked to do the work.
- Keep the visible frame natural and short when the goal is clear; do not emit a
  large internal-looking card unless the user asked for a formal frame.
- Use `Aegis Visibility` to say why the goal frame constrains the route, stop
  condition, or non-goals. Do not add trace ceremony unless the user explicitly
  asks for auditability.

Frame-only behavior:

- Stop at the frame only when the user explicitly asks to only define the goal,
  only define the stop condition, not execute, not implement, not write a plan,
  or wait for confirmation before continuing.
- If required information is missing, state the missing input and stop with
  `blocked` rather than pretending to continue.

Stop condition must distinguish:

State set: `done`, `blocked`, `needs-verification`, `scope-exceeded`.

- `done`: success evidence is satisfied
- `blocked`: required dependency, permission, or information is missing
- `needs-verification`: implementation exists but evidence is insufficient
- `scope-exceeded`: continuing would exceed the goal or non-goals

## Routing

After framing:

- Low-risk single-owner work continues through the normal fast path or TDD
- Ambiguous product / architecture / contract work routes to `brainstorming`
- Approved requirements route to `writing-plans`
- Multi-step, compaction-prone, handoff, or subagent work routes to
  `long-task-continuation`
- Bug diagnosis routes to `systematic-debugging`

### Route Matrix

| Goal signal | Route |
| --- | --- |
| single-owner, low-risk, clear verification | fast path or `test-driven-development` |
| bug, failure, regression, unexpected behavior | `systematic-debugging` |
| ambiguous product, architecture, contract, cross-module behavior | `brainstorming` |
| approved spec, stable requirements, implementation slicing | `writing-plans` |
| multi-step, compaction-prone, handoff, subagent work | `long-task-continuation` |
| completion, release, handoff, "is this done?" | `verification-before-completion` |

Only create `docs/aegis/` records when the routed workflow needs persistent
evidence. Goal framing alone does not create project files.

## Subagent Context Packet

When delegating work, pass a compact packet instead of the full conversation:

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

The packet reduces repeated file reading, but it does not replace evidence.
Subagents should still read the smallest raw file/log/test excerpt needed to
verify critical facts.

Do not paste full chat transcripts, full session history, or unbounded logs into
the packet. If a fact matters, include a file ref, line/window hint, or compact
must-read excerpt.

## Drift Rule

If the goal changes mid-task, do not silently overwrite it. Record old goal,
new goal, changed scope, new risks, and route through `DriftCheckDraft` when a
long-task record exists.

© GanyuanRan · MIT · GanyuanRan/Aegis

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. 1 052 851установок ask-matt Matt Pocock Помогает выбрать подходящий скилл или рабочий поток из набора Matt Pocock. Пригодится, когда непонятно, с чего начать задачу: от идеи до разбора бага. 766 587установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. CX Codex 282 859установок caveman-review JuliusBrussee Пишет замечания к коду одной строкой: место, проблема, исправление. Пригодится, когда ревью диффа или PR надо пройти быстро и без воды. CX Codex +1 411 800установок caveman-compress JuliusBrussee Сжимает CLAUDE.md, списки задач и другие текстовые файлы в краткий формат, сохраняя читаемую резервную копию. CX Codex +1 411 500установок

Из того же набора11

ui-ux-governance Скилл задаёт агенту рамки при работе с интерфейсами: как выбирать решения по потокам, состояниям и доступности. CX Codex +1 ★ 1 388звёзд репо systematic-debugging Скилл помогает разбирать ошибки, сбои тестов и неожиданное поведение до правок. Он прослеживает причину до места, которое действительно нужно исправить. CX Codex +1 ★ 1 388звёзд репо subagent-driven-development Скилл ведёт выполнение плана: на каждую задачу запускается свежий субагент, после чего идут две проверки — соответствие спецификации и качество кода. CX Codex +1 ★ 1 388звёзд репо recording-architecture-decisions Скилл помогает решать, нужен ли ADR, выбрать действие и синхронизировать описание текущей архитектуры после значимых изменений. CX Codex +1 ★ 1 388звёзд репо first-principles-review Лёгкая проверка решения по первому принципу и бритве Оккама перед тем, как агент зафиксирует направление. Обычные багфиксы она не трогает. CX Codex +1 ★ 1 388звёзд репо establishing-project-context Ведёт словарь доменных терминов в CONTEXT.md, чтобы человек и агент называли одни и те же вещи одинаково. Нужен, когда термин переименовали, устарели или он оброс смыслами. CX Codex +1 ★ 1 388звёзд репо communicating-concisely Скилл сокращает ответы агента по просьбе пользователя и сохраняет точность технических деталей. Режим действует до команды на отключение. CX Codex +1 ★ 1 388звёзд репо brainstorming Скилл для Claude и других агентов: помогает довести сырую идею до спеки и не даёт писать код, пока дизайн не одобрен. CX Codex +1 ★ 1 388звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой