principle-write-cold-handovers
WHEN delegating, pausing, or writing a brief or specification another agent will execute; NOT for resuming from an existing handover or bounding reads within a session; produces a handover a fresh agent can act on with nothing more.
- License 许可
- MIT
- 所属仓库
- mintuz/skills
- 最近更新
- 2026-11-13
- Stars
- ★ 35
- Forks
- 7
01 前言 Front Matter
- name
- principle-write-cold-handovers
- description
- WHEN delegating, pausing, or writing a brief or specification another agent will execute; NOT for resuming from an existing handover or bounding reads within a session; produces a handover a fresh agent can act on with nothing more.
02 资源文件 6
- 参考文档references/cli-options-and-variables.md21.2 KB
- 参考文档references/meta-commands-core.md17.9 KB
- 参考文档references/meta-commands-formatting.md6.9 KB
- 参考文档references/meta-commands-inspection.md7.1 KB
- 参考文档references/tips-advanced.md8.1 KB
- 参考文档references/tips-workflows.md10.3 KB
03 SKILL.md 正文
Write cold handovers
Write every handover, brief or specification so a reader with no shared history can act on it alone.
- Assume the reader has never seen this conversation, your shorthand or your hypotheses. Replace every reference to shared context ("as discussed", "the second idea", "same as last time", "see above") with the content itself or an exact locator.
- Before continuity is at risk, save a concise durable handover in an allowed location: accepted goal and scope, current artifact or branch identity, completed changes, exact checks and outcomes, remaining uncertainty, and one concrete next executable step.
- When delegating, make the brief stand alone: goal, scope, the exact slice and the revisions it covers, how to verify it, and what to report back, including the revisions and method used.
- Record what was ruled out and why. Keep a plan, a static check or an unavailable runtime check visibly separate from completed proof.
- Reread the handover as its cold reader: every term defined, every path, revision and command exact, nothing left to recall.
Distinct from: principle-refresh-before-resuming (the reader re-checks live state when picking up), principle-guard-the-context-window (bounding reads within a session), principle-label-the-evidence (marking each claim's status in findings).
Done: a cold reader can continue without further context, without redoing the investigation, and without mistaking a plan or static check for completed proof.
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
USE WHEN writing, fixing or reviewing styling in a project that uses Tailwind CSS, even a one-class change or a request that does not name Tailwind: colours, focus rings, spacing, class names chosen by a prop, map or CVA variants, theme tokens and dark mode in the Tailwind stylesheet or tailwind.config, setup or upgrades (if unsure whether the project uses Tailwind, check package.json or the main stylesheet first); NOT WHEN writing plain CSS or Sass in a project without Tailwind; produces class names Tailwind can find, syntax for the installed major version, visible focus indicators, and no unrequested dependency or invented brand value.
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
USE WHEN changing the logic, data, props, state, Effects or rendered text of a React component, hook or page, even a one-line change; NOT WHEN the request is styling only (class names, Tailwind, CSS, dark mode, spacing, shadows) or tests only, or when it models submit, in-flight, loading, retry or failure states, even for a named React form (xstate covers that, including its React wiring); applies React 19 composition, state, Effect, structure, API and performance rules with only the project's installed libraries.
react-testing
USE WHEN writing, fixing or reviewing a React Testing Library test for a component, hook or context provider, even one small test, or when asked for an end-to-end journey inside a Vitest or React Testing Library suite; NOT WHEN changing the component itself (react), testing XState actors or @xstate/react (xstate), or writing a Playwright or Cypress test; covers renderHook, providers, async results, forms and false-pass anti-patterns, and declines end-to-end journeys with the testable slices.