AGENT SKILL
goal
Manage the persistent thread goal from IPython. Use to read goal status and budget usage, to start a goal when the user explicitly asks for one, or to mark the active goal complete once its objective is fully achieved.
- License 许可
- MIT
- 最近更新
- 2026-08-06
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- goal
- description
- Manage the persistent thread goal from IPython. Use to read goal status and budget usage, to start a goal when the user explicitly asks for one, or to mark the active goal complete once its objective is fully achieved.
02 资源文件 2
- 其他pyproject.toml577 B
- 脚本src/goal/__init__.py2.0 KB
03 SKILL.md 正文
Goal
The thread goal is a persistent objective the harness keeps re-prompting you to pursue across turns until it is complete. Goal state (status, token budget, usage accounting) lives in the host; this skill is the kernel-side interface to it. Call it directly from IPython:
await goal.get()
await goal.create("ship the release notes", token_budget=200000)
await goal.complete()
API
await goal.get()— current goal as a dict:goal(orNonewhen no goal is set),remaining_tokens, andcompletion_budget_report. Thegoaldict carriesobjective,status,token_budget,tokens_used,time_used_seconds, and timestamps.await goal.create(objective, token_budget=None)— start a new active goal. Fails while a goal is still pending (active, paused, or budget-limited); a completed or errored goal is replaced by the new one. Only create a goal when the user or system/developer instructions explicitly ask for a persistent long-running goal; do not infer goals from ordinary tasks. Settoken_budgetonly when an explicit token budget is requested.await goal.complete()— mark the existing goal achieved. Use only when the objective has actually been achieved and no required work remains; do not call it merely because the budget is nearly exhausted or because you are stopping work. When the result includes acompletion_budget_report, report that final usage to the user.
Rules
- Goal status transitions other than completion (pause, resume, clear, budget-limiting) are controlled by the user and the host; there is no API for them here.
- When an active goal is actually complete, call
await goal.complete(); do not merely say it is done — the harness keeps continuing the goal until the completion call arrives.
04 同仓库更多 Skills
valid-skill
A valid skill for testing purposes.
★ 0
unknown-field
A skill with an unknown frontmatter field.
★ 0
nested-child
Nested skill should be ignored.
★ 0
root-skill-preferred
Root skill should win.
★ 0
python-skill
A Python-backed skill for testing.
★ 0
python-package-missing
A Python skill missing its import package.
★ 0