跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

boil

Activates Standard of Excellence enforcement for the current session. Load before starting any task to apply completion standards: finish the whole thing, fix the root cause, ship the complete working result. Blocks partial solutions, workarounds, deferred threads, and invented content limits when the permanent solve is within reach. Triggers: 'do the whole thing', 'boil the ocean', 'standard of excellence', 'finish it completely', before starting any implementation, refactoring, or multi-step task where partial output is a risk. Does NOT apply to: read-only queries, one-line typo fixes, pure knowledge questions, or single-output summarize requests.

Jamie-BitFlight · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Jamie-BitFlight/claude_skills --skill boil

技能说明


name: boil description: "Activates Standard of Excellence enforcement for the current session. Load before starting any task to apply completion standards: finish the whole thing, fix the root cause, ship the complete working result. Blocks partial solutions, workarounds, deferred threads, and invented content limits when the permanent solve is within reach. Triggers: 'do the whole thing', 'boil the ocean', 'standard of excellence', 'finish it completely', before starting any implementation, refactoring, or multi-step task where partial output is a risk. Does NOT apply to: read-only queries, one-line typo fixes, pure knowledge questions, or single-output summarize requests." argument-hint: "[task-description]" model: sonnet user-invocable: true allowed-tools: "Read, Grep, Glob, Bash, Edit, Write, Agent" tags: "completion, excellence, quality, anti-patterns, enforcement" version: "1.1.0"

Standard of Excellence — Boil the Ocean

Outcome: A task is complete only when all output is delivered (no prohibited exits taken, no workarounds), the Dangling Thread Checklist has no open items, and no PENDING threads remain.

Full source extracts: ./references/standard-of-excellence.md Invented limit patterns: ./references/invented-limit-patterns.md BLOCKED declaration contract: ./references/blocked-declaration-contract.md

Workflow

flowchart TD
    Start(["Task received"]) --> P1
    P1["Read task-description argument<br>Scan affected files for TODO / FIXME / PENDING"] --> P2
    P2{"Scope determinable?<br>Affected files, expected behavior, and<br>success criteria identifiable from request?"}
    P2 -->|No| P2a["State assumption explicitly — then proceed"]
    P2 -->|Yes| E1
    P2a --> E1

    E1{"About to build without searching?"}
    E1 -->|Yes| E1a["Search first — confirm prior art before implementing"]
    E1a --> E2
    E1 -->|No — search done| E2

    E2{"Considering a prohibited exit?<br>workaround / deferral / truncation<br>partial delivery / 'leave as exercise'"}
    E2 -->|No| E3
    E2 -->|Yes| E2a{"Permanent solve reachable?"}
    E2a -->|Yes| E2b["Apply permanent solve — return to work"]
    E2b --> E3
    E2a -->|"No — named external constraint"| Blocked

    E3{"Pre-existing issue found during work?"}
    E3 -->|No| C1
    E3 -->|Yes| E3a["'I found N pre-existing X.<br>Address now or add to backlog?'"]
    E3a --> E3b{"User: address now?"}
    E3b -->|Yes| E3c["Scope fix into current task — continue"]
    E3b -->|No or no response| E3d["Create backlog record — continue"]
    E3c --> C1
    E3d --> C1

    C1["Answer Dangling Thread Checklist"] --> C2
    C2{"Open thread?<br>TODO / FIXME / partial impl /<br>untested behavior / invented limit?"}
    C2 -->|Yes — thread unaddressed| P1
    C2 -->|No — all clear| Done

    Blocked["BLOCKED declaration:<br>reason + completed + remains<br>+ unblocking condition"]
    Done(["Task complete"])

Preparation

Before applying any task, inspect the input:

  1. Read the [task-description] argument if provided.
  2. Identify whether prior partial work exists — check for TODO, FIXME, or PENDING markers in affected files.
  3. Confirm the task scope is understood: what files, what behavior, what "complete" looks like.
  4. If affected files, expected behavior, or success criteria cannot be determined from the request and context, state the assumption explicitly before proceeding.

This inspection takes under 60 seconds and prevents the most common failure mode: starting in the middle of something already broken.

The Standard

The marginal cost of completeness is near zero. Complete the whole thing.

  • Search before building. Check whether the solution already exists before implementing.
  • Test before shipping. Verify observable behavior, not just syntax correctness.
  • Ship the complete thing. The answer is the finished product, not a plan to build it.

Time, fatigue, and complexity are not valid reasons to stop short.

Prohibited Exits

NEVER use the following exits when the permanent solve is reachable:

Prohibited formWhy it failsRequired action
"We could table this for later"Defers solvable workIf reachable now, solve it now
"As a workaround you could..."Leaves root cause intactFind and apply the real fix
"Here's a partial implementation"Delivers incomplete valueComplete it, or declare BLOCKED (see below)
content[:500], MAX_LEN = 1024Silent data lossOutput full content; let caller control the window
"I'll leave the rest as an exercise"Delegates responsibility backDo it

The One Legitimate Exit — BLOCKED Declaration

When the permanent solve is genuinely unreachable due to an external constraint, use this form. Copy ./assets/blocked-declaration-template.md verbatim into your response and fill in every field. Full contract: ./references/blocked-declaration-contract.md

# WRONG — workaround instead of BLOCKED
The build fails because the dependency is missing. As a workaround,
comment out the import for now.

# RIGHT — specific constraint with actionable path
BLOCKED: fastmcp[tasks] is not in pyproject.toml and the file is read-only in CI.
- What was completed: identified failing import at src/runner.py:14
- What remains: add fastmcp[tasks] to pyproject.toml; run uv lock; re-run pytest tests/ -x
- Unblocking condition: pyproject.toml is writable and fastmcp[tasks] is in dependencies

No Invented Limits

NEVER introduce hard-coded truncation or length limits. Full taxonomy: ./references/invented-limit-patterns.md

Rules:

  • Output full content by default.
  • When pagination is genuinely needed, provide --offset / --limit parameters.
  • If conten
阅读完整来源 ↗