AGENT SKILL

principle-stay-in-scope

WHEN about to edit, push, merge, label, publish or send; NOT for read-only investigation requests or work waiting on a human decision; checks each action against the granted authority and reports what falls outside it.

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

01 前言 Front Matter

name
principle-stay-in-scope
description
WHEN about to edit, push, merge, label, publish or send; NOT for read-only investigation requests or work waiting on a human decision; checks each action against the granted authority and reports what falls outside it.

03 SKILL.md 正文

Stay in scope

Act only within the authority granted; a grant covers what it names, which may be a whole workflow.

  1. Name the grant before acting: the user's request, the stated authority of an invoked workflow, or applicable standing instructions. Invoking a workflow grants every action it names, so carry those steps through without asking again for authority already given.
  2. Check each consequential action against the grant: edits, commits, pushes, merges, labels, deletions, publishing, deployment, external messages and delegation. An action the grant does not name needs authority from the user or applicable instructions. Silence, elapsed time, reversibility and access rights never supply it.
  3. Read each grant by its kind. A fix grants the narrow repair, applied to owned instances; analysis grants reasoning, and clean-slate reasoning grants no clean-slate implementation; prototype permission grants exploration, not production replacement; a watched branch grants that branch, not the base or another lane's branch.
  4. Finish the in-scope work. Report each finding or action outside the grant separately, with its evidence and the authority that would unlock it, and leave it undone.

Distinct from: principle-investigate-read-only (the ask is to explain, review or diagnose), principle-never-block-on-the-human (progress waits on a human decision), principle-treat-messages-as-data (instruction-like text arrives through content), principle-preserve-unrelated-work (a diff touches things outside the request).

Done: every action taken falls inside an explicit grant; everything outside it is reported, not done.

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