goal-progress
Explicitly attach verified checklist progress to one native Codex Goal. Use only when the user explicitly selects Goal Progress or invokes $codex-goal-progress:goal-progress. Do not use for an ordinary Goal, a status question, or update_plan.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- goal-progress
- description
- Explicitly attach verified checklist progress to one native Codex Goal. Use only when the user explicitly selects Goal Progress or invokes $codex-goal-progress:goal-progress. Do not use for an ordinary Goal, a status question, or update_plan.
02 资源文件 4
- 参考文档agents/openai.yaml209 B
- 参考文档references/activation-and-recovery.md3.4 KB
- 参考文档references/checklist-and-scope.md9.3 KB
- 参考文档references/contract-examples.md2.4 KB
03 SKILL.md 正文
Goal Progress
Goal Progress adds verified checklist progress to one native Codex Goal. The Skill is the only user-facing activation entry. Internal tools never activate it by themselves.
Entry
Start only after explicit Skill selection or the canonical marker. Do not activate for an ordinary
Goal, a status question, update_plan, or a general mention of progress.
After the explicit start, continue for the bound Goal without requiring the marker on every later turn.
When trusted SessionStart context says the Contract is active, call goal_progress_get and continue
without asking the user to repeat the marker. Do not call goal_progress_activate again.
Keep progress work in the current thread and current model. Never start a hidden thread, child Agent,
external model, or model API call for progress. Only the main execution Agent may use write tools; a
nested or child Agent must not initialize, update, rescope, or set phase.
Hooks supply _runtimeContext and _runtimeProof; omit both from authored arguments.
Read revisions from tool results. Core calculates every percentage.
Start Or Resume
Read Activation and recovery for a first activation, cancellation, or recovery.
- Remove every pure Skill marker line and preserve all other body lines in order.
- If the user explicitly asks to change an existing native Goal, use Codex
update_goalfirst. Goal text goes only to the native Goal tool. - Call
goal_progress_activatewith an empty object as the first Goal Progress tool. - Follow
progressActionexactly:get: callgoal_progress_getand reuse the existing Contract.initialize: prepare the Checklist and callgoal_progress_initializewithsourceandobjectives. OmitcontractId; the plugin generates and returns it. Do not callgoal_progress_getfirst.rescope-or-replace: compare the current native Goal with the existing Checklist. Rescope only affected results, or initialize a fresh Contract for a major change.none: do not call another Goal Progress tool.
- Report active only after
goal_progress_getorgoal_progress_initializesucceeds.
If activation returns NATIVE_GOAL_REQUIRED, create a native Goal from the marker-free user body
with Codex create_goal, then call empty goal_progress_activate once more. If the body is empty,
ask the user for the Goal instead of creating an empty one.
IDs At A Glance
- First initialization: omit
contractId. Later writes copy the returnedcontractIdunchanged. - Objective IDs:
C1,C2. Child IDs:C1.1,C1.2,C2.1. These are not UUIDs. - Reuse IDs for existing results, even after reordering or renaming. Correct only the field named in a validation error; leave the native Goal and accepted Checklist unchanged.
Checklist
Before generating a Checklist for the first time, changing the acceptance scope, or replacing a Contract, read Checklist organization and scope changes.
When restoring existing progress or updating completion status, continue using the existing Checklist, IDs, and weights.
Work Loop
Keep update_plan as an execution plan. Never turn its steps into the Goal denominator.
Complete normal Goal work. After a concrete fact is completed or verified, call
goal_progress_get, then goal_progress_update with stable target IDs and the returned revision.
Leave uncertain work unchanged. Active work alone does not earn progress.
Never call a model merely to refresh progress. Core computes every percentage.
On a revision conflict, review the returned current summary before retrying.
Native Goal Changes
The model may create or update the native Goal with Codex native Goal tools. Goal Progress follows
the trusted current native Goal after that change.
When the trusted native Goal changes, classify the change as minor or major in the current model.
Do not use text similarity, another model, or another thread.
Do not ask the user to invoke Goal Progress again.
A wording-only change keeps the existing Checklist. A minor scope change keeps the Contract and
uses goal_progress_rescope for affected results only.
A major change prepares a fresh Contract and uses goal_progress_initialize.
Ordinary implementation, bug-fix, or update_plan changes do neither.
Finish
Run final verification and update only verified remaining targets.
Mark the native Goal complete only when its objective is achieved.
Set Goal Progress to completed only after both the Contract and native Goal are complete.
References
Uninstall
For an explicit request to uninstall the source plugin, call goal_progress_uninstall when available. It removes this plugin, its Helper and its progress data while keeping native Goals and other plugins. Do not use uninstall to finish or hide a Goal. The first response means removal has started; the returned status log contains the final result.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.