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.
- 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.
- 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.
- 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.
- 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
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.
web-design
WHEN refining UI layout, typography, color, or polish; NOT code implementation; provides concise principles for intentional, legible design.
tailwind
WHEN building design systems or component libraries with Tailwind CSS; covers design tokens, CVA patterns and dark mode.
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.
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.
react-testing
WHEN testing React components/hooks/context with React Testing Library; NOT e2e; covers renderHook, providers, forms, and anti-patterns.