feat(skill): add goal-driven-loop SKILL.md with core loop instructions

2026-06-10 17:32:48 +08:00
parent 49e581247b
commit bb4434cd73
1 changed files with 59 additions and 0 deletions
@@ -0,0 +1,59 @@
+---
+name: goal-driven-loop
+description: Use when the user sets a current goal with phrases like "设定当前目标为", "当前目标是", "current goal is", or "my goal is", and the task is not a trivial fix, hotfix, tweak, or quoted text
+---
+
+# Goal-Driven Loop
+
+Keep the current session focused on a user-defined goal with explicit acceptance criteria. Iterate until all criteria pass, or genuine stagnation is detected.
+
+## When to Activate
+
+**Trigger phrases (any language, semantic variants):**
+- Chinese: 设定当前目标为 / 当前目标是 / 把当前目标设为 / 我的目标是
+- English: set current goal to / current goal is / my goal is / the goal is
+- Other: semantically equivalent phrasings + concrete deliverable
+
+**Do NOT activate when:**
+- Trigger phrase inside markdown quote (`>`) or code block, or same sentence as reported speech (he said / 他说)
+- Message contains trivial-task keywords: hotfix, tweak, quick fix, 修个bug, 小改
+- Goal description ≤ 10 chars without architectural keywords, or agent estimates < 5 min without architectural keywords
+- `.agents/goal/GOAL.md` exists → extension prompts: continue / replace / abandon (10s timeout → continue)
+
+**Granularity:** Coarse (file count > 5, multi-module, architectural) → extension invokes `comet-open`. Fine (single concern, ≤ 5 files) → this skill. Fallback: if comet unavailable, auto-split into phases.
+
+## Core Loop
+
+1. **Initialize** — If `GOAL.md` exists, extension prompts with timed default. If no criteria provided, auto-generate (verifiability red line). Write `GOAL.md`.
+
+2. **Execute** — Read `GOAL.md`, pick next unpassed criterion (least dependent), implement, verify, record in Progress Log.
+
+3. **Verify** — Check each criterion against fresh evidence. Update checkboxes, iteration counter, timestamp.
+
+4. **Loop** — All ✅ → exit. Stagnation → extension auto-injects strategy change (2x before user notification). Otherwise → step 2.
+
+5. **Exit** — Deslop pass on modified files (failure doesn't block). Delete `GOAL.md`. Output summary.
+
+## Acceptance Criteria Verifiability
+
+Auto-generated criteria must be verifiable. Examples:
+- ❌ "Implement rate limiting" → not verifiable
+- ✅ "Rate limiter middleware mounts on auth routes, excess requests return 429" → verifiable
+- ❌ "Code quality is good" → not verifiable
+- ✅ "Related files lint clean, typecheck passes" → verifiable
+
+Agent cannot unilaterally delete or skip criteria. Material modifications require logged reason; safe adjustments (typos, splitting compounds) may be auto-applied.
+
+## Goal State File
+
+Path: `.agents/goal/GOAL.md` — frontmatter with `goal`, `created`, `updated`, `iteration`, `status` (in-progress | blocked | complete). Body has Acceptance Criteria (checkboxes), Progress Log (per-iteration), Blocked section.
+
+## Error Handling
+
+See `references/error-handling.md` for retry strategy, exception classification, stagnation rules, and red flags.
+
+**Context tension:** Extension detects via `ctx.getContextUsage() > 0.8`. Auto-injects "save progress now" directive into next turn.
+
+**Mid-loop granularity upgrade:** If execution reveals the goal is more complex than estimated, extension auto-invokes `comet-open` with `GOAL.md` state. User is informed via UI notification, not asked for confirmation.
+
+**Explicit abandon:** User says "abandon / cancel / 不要了" → extension deletes `GOAL.md`, outputs brief summary, terminates.