AGENT SKILL

how

WHEN explaining code flow, current execution, or state ownership; NOT for historical rationale or redesign; gives an evidence-grounded walkthrough

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

01 前言 Front Matter

name
how
description
WHEN explaining code flow, current execution, or state ownership; NOT for historical rationale or redesign; gives an evidence-grounded walkthrough

03 SKILL.md 正文

How

Explain the current implementation as a path a reader can follow. Keep historical motivation for why and redesign for a separate authorized task.

  1. Bound the question and inspect current source plus its relevant immediate callers, configuration and tests. State an interpretation when the referent is ambiguous. Handle a narrow module directly; optional independent exploration must earn its cost and follow host authorization, with no required subprocess, model or routing file.
  2. Trace the concrete trigger through each meaningful boundary: inputs and transformations, state owner, effects and observable result. Include failure, cancellation, retry and teardown paths where they change the outcome. Name process/lifecycle ownership for app/extension flows and actor/resource ownership for reactive flows; use the implementation's actual architecture.
  3. Anchor consequential statements to source locators. Distinguish source-derived behavior, test results and observed runtime. Resolve revision/build/environment mismatches before claiming what the current app does; an old screenshot cannot contradict an unobserved new build conclusively. Mark unknown paths instead of filling them with plausible details.
  4. Answer at the question's scale: lead with the result, then the execution sequence, ownership and important gotchas. Add a small cited diagram only when it clarifies boundaries. Explain enough to predict behavior without producing annotated source or speculative rationale.

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