AGENT SKILL

principle-state-the-claim-first

WHEN starting a task, fix or benchmark; NOT for read-only explanation or recording the pre-change state; records the falsifiable claim the work must support before the first change.

License 许可
MIT
所属仓库
mintuz/skills
最近更新
2026-11-10
Stars
★ 35
Forks
7

01 前言 Front Matter

name
principle-state-the-claim-first
description
WHEN starting a task, fix or benchmark; NOT for read-only explanation or recording the pre-change state; records the falsifiable claim the work must support before the first change.

03 SKILL.md 正文

State the claim first

Write the claim you expect to make before you work or measure, so the checks test a sentence rather than a hope.

  1. Before the first edit, run or measurement, write the claim in the words you would report: the subject, the observable result, the condition or workload, and the threshold or direction. For example: "CSV export is 30% faster at p50 on the 60k-row dataset", or "after a restart with an existing state file, the service starts and keeps its data".
  2. Make it falsifiable. Name the observation that would show it false. A goal such as "make it faster" or "improve stability" is not yet a claim; turn it into one before starting, even when asked to start immediately.
  3. Keep suspected causes separate from the claim. A hunch about the mechanism is a hypothesis to test; the claim is the outcome the work must make true.
  4. Design the checks to test that sentence. Report whether the evidence supports, narrows or refutes it.

Distinct from: principle-define-done (a checkable completion criterion for any multi-step deliverable), principle-capture-the-baseline (recording the pre-change state), principle-prove-it-works (verifying the result after the work).

Done: the falsifiable claim, with its refuting observation, is recorded before the first change.

04 同仓库更多 Skills

mintuz
mintuz/skills

xstate

WHEN React state changes in response to an external answer — async submit, in-flight or loading flags, retries, cancellation, polling, optimistic updates, stale responses — or to an interaction with an interruptible middle, such as a drag or a gesture; or WHEN building, reviewing, testing, or visualising XState 5 actors and @xstate/react integrations; NOT for a value one event sets completely, such as a text draft, a focus flag, or a plain open and closed toggle; models typed lifecycles and renders legal Mermaid stateDiagram-v2 charts.

测试与质量前端开发
★ 35
mintuz
mintuz/skills

web-design

WHEN refining UI layout, typography, color, or polish; NOT code implementation; provides concise principles for intentional, legible design.

设计师视觉设计
★ 35
mintuz
mintuz/skills

tailwind

WHEN building design systems or component libraries with Tailwind CSS; covers design tokens, CVA patterns and dark mode.

视觉设计
★ 35
mintuz
mintuz/skills

refactoring

WHEN you need a plan to refactor, restructure, or clean up working code and the test result is known, either green or a recorded failing set; NOT for new feature delivery or any behavior change; reversible-baseline safety with prioritized improvements.

代码审查
★ 35
mintuz
mintuz/skills

react

WHEN building or changing React components, pages, hooks, effects, or apps, including edits to existing components; NOT for test code (react-testing) or styling (css, tailwind); enforces scalable architecture, state management, API layer, performance patterns.

测试与质量前端开发
★ 35
mintuz
mintuz/skills

react-testing

WHEN testing React components/hooks/context with React Testing Library; NOT e2e; covers renderHook, providers, forms, and anti-patterns.

测试与质量前端开发
★ 35