Natsummerance/agents

spec-driven-development

当用户询问"我应该先写什么"、"如何明确需求"或"如何避免盲目编码"时调用此 skill。不适用于：纯信息查询、已有明确规格说明的场景、快速原型验证。关键 trigger 信号：规格说明、spec、需求明确化、先写什么、避免盲目编码。

Idioma del texto original: chino

responsive-chart-strategy

当用户需要为数据可视化产品设计多端适配策略时使用。触发场景：用户问"如何让图表在手机上也能看清？"、"Dashboard 如何适配不同屏幕尺寸？"、"移动端图表交互如何优化？"。不适用于：固定尺寸的嵌入式图表、非响应式应用场景。关键 trigger 信号：响应式 / 多端适配 / 移动端优化 / 断点定义 / 触摸交互。

Idioma del texto original: chino

tooltip-missing-unit-trap

当用户在 Tooltip 中省略数据单位时触发，用于警告这会造成歧义。触发场景：用户问"Tooltip 需要显示单位吗？"、"数值 1234 是什么意思？"、"如何避免用户对数据量级的误解？"。不适用于：无单位的纯计数数据。关键 trigger 信号：Tooltip 单位 / 数据单位 / 数值歧义 / 万/亿/元。

Idioma del texto original: chino

y-axis-non-zero-trap

当用户考虑将柱状图的 Y 轴起点设为非零值时触发，用于警告这会放大微小差异并误导用户。触发场景：用户问"如何让两个数值的差异看起来更明显？"、"Y 轴可以从 90 开始吗？"、"截断 Y 轴是不是更好的展示方式？"。不适用于：折线图（可以截断）、对数坐标轴。关键 trigger 信号：Y 轴起点 / 截断 Y 轴 / 柱状图 Y 轴 / 放大差异。

Idioma del texto original: chino

ask-matt

Router over the mattpocock/skills catalog. User describes a situation (e.g., "review this PR", "debug a flaky test", "design a new module") and this skill maps it to the correct skill or multi-skill flow. Trigger phrases: "which skill", "how do I", "what…

Idioma del texto original: inglés

code-review

Two-axis review of a git diff since a fixed point (commit, branch, tag, merge-base). Standards axis checks repo coding standards + Fowler smell baseline; Spec axis checks diff against originating issue/spec. Runs both axes as parallel sub-agents, aggregates…

Idioma del texto original: inglés

codebase-design

Shared vocabulary and principles for designing deep modules (small interface, large hidden implementation). Use when designing or improving a module's interface, finding deepening opportunities, deciding seam placement, making code more testable or…

Idioma del texto original: inglés

diagnosing-bugs

Six-phase diagnosis loop for hard bugs and performance regressions. Phase 1: build a tight, deterministic, fast feedback loop that goes red on the exact bug. Phase 2: reproduce and minimise to smallest red scenario. Phase 3: generate 3-5 ranked falsifiable…

Idioma del texto original: inglés

domain-modeling

Active discipline for building and sharpening a project's domain model. Maintains CONTEXT.md (glossary only, no implementation details) and ADRs (hard-to-reverse, surprising-without-context, genuine-tradeoff decisions). Challenges term conflicts, sharpens…

Idioma del texto original: inglés

grill-me

Stateless relentless interview to sharpen a plan, design, or piece of writing. No working directory, no CONTEXT.md, no ADRs—pure thinking. Invokes the grilling primitive (rounds, frontier, facts=agent job, decisions=user). Use when not in a repo: sharpening a…

Idioma del texto original: inglés

grill-with-docs

Stateful relentless interview (grilling primitive) that also creates durable docs: CONTEXT.md glossary and ADRs via domain-modeling. Use when working in a working directory and you want to sharpen a plan/design while leaving a paper trail. Trigger: "grill…

Idioma del texto original: inglés

grilling

The core interview primitive: relentless rounds over a design tree. Builds a tree of decisions, computes the frontier (questions whose prerequisites are settled), asks the whole frontier in numbered rounds with recommended answers. Facts = agent's job…

Idioma del texto original: inglés

handoff

Compact the current conversation into a handoff document for another agent or developer to pick up. Use when switching sessions, forking a side task mid-phase, moving work to a new directory, or delegating to a colleague. Generates a portable markdown summary…

Idioma del texto original: inglés

implement

Implement a piece of work based on a spec or set of tickets. Drives TDD internally (one red-green slice at a time), runs typechecking and test suites, then closes with code-review before committing. Use when the user says "implement this", "build this…

Idioma del texto original: inglés

improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. Uses codebase-design vocabulary (module, interface, depth, seam, adapter, leverage, locality) and domain glossary from CONTEXT.md.…

Idioma del texto original: inglés

prototype

Build a throwaway prototype to answer a design question. Two branches: LOGIC (state model validation via interactive HTML) or UI (variation exploration via multiple UI renders). Use when the user asks "does this state model feel right?", "what should this UI…

Idioma del texto original: inglés

research

Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Delegates reading legwork to a background agent so you keep working while it reads. Use when the user wants a topic researched, docs or API…

Idioma del texto original: inglés

resolving-merge-conflicts

Resolve an in-progress git merge or rebase conflict hunk by hunk. Traces each side's intent to its primary source (commit messages, PRs, original issues), resolves by intent rather than picking lines, runs automated checks, and finishes the operation. Never…

Idioma del texto original: inglés

setup-matt-pocock-skills

Configure a repo for the engineering skills: set up its issue tracker (GitHub, GitLab, local markdown, or other), triage label vocabulary, and domain doc layout (single-context or multi-context). Run once before first use of other engineering skills.…

Idioma del texto original: inglés

tdd

Test-driven development — the red → green loop. Write failing test first, then minimal implementation to pass. Tests verify behavior through public interfaces, not implementation details. Work in vertical slices: one test → one implementation → repeat.…

Idioma del texto original: inglés

teach

Multi-session teaching workspace. Learn a concept over multiple sessions using the current directory as a stateful workspace. Produces lessons (self-contained HTML), reference documents (quick-reference cheat sheets), learning records (decision-like…

Idioma del texto original: inglés

to-questionnaire

Turn a decision you can't fully answer into a questionnaire for someone else to fill in. Grills the *send* (who it goes to, what you need back), not the *subject*. Produces a structured Markdown document aimed at the knowledge gap between recipient and…

Idioma del texto original: inglés

to-spec

Turn the current conversation into a spec and publish it to the project issue tracker. No interview — just synthesis of what you've already discussed. Produces structured spec with: Problem Statement, Solution, User Stories (extensive list), Implementation…

Idioma del texto original: inglés

to-tickets

Break a plan, spec, or conversation into tracer-bullet tickets, each declaring its blocking edges. Tickets are vertical slices through every layer (schema, API, UI, tests) that are demoable on their own. Wide refactors use expand-contract pattern instead. Use…

Idioma del texto original: inglés

triage

Move issues and external PRs through a state machine of triage roles. Categorise (bug/enhancement), verify claims, grill if needed, write agent-ready briefs. Five state roles: needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix. Use when the…

Idioma del texto original: inglés

wait-what

Stop — that last message did not land. Re-pitch it with more context, using ASD-STE100 Simplified Technical English and the ubiquitous language from CONTEXT.md. Use mid-conversation inside any other skill when the user says "wait, what?", "I don't…

Idioma del texto original: inglés

wayfinder

Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker. Resolves them one at a time until the way to the destination is clear. Produces decisions, not deliverables. The map is an index, not a…

Idioma del texto original: inglés

wizard

Generate an interactive bash wizard that walks a human through steps only they can perform. Opens URLs, captures values, writes to .env and GitHub secrets, confirms at each stage. Use when provisioning infrastructure, setting up credentials or CI secrets,…

Idioma del texto original: inglés

writing-for-agents

Reference for writing documents agents consume: skills, AGENTS.md/CLAUDE.md, pointed-at docs. Covers context pointers, the two loads (context load vs cognitive load), information hierarchy (in-file steps → in-file reference → disclosed reference), steps and…

Idioma del texto original: inglés

auto-build-mode

当用户询问"如何平衡自动化与安全性"、"能否一次性实现所有任务"或"如何提高开发效率"时调用此 skill。不适用于：需要频繁人工干预的场景、高风险项目、需求不明确的场景。关键 trigger 信号：auto-build、自动化、一次性实现、效率提升、自主运行。

Idioma del texto original: Varios idiomas

faster-is-safer

当用户询问"应该频繁部署还是批量部署"、"如何降低部署风险"或"快速迭代的价值是什么"时调用此 skill。不适用于：纯理论讨论、不需要部署的场景、严格变更管理的场景。关键 trigger 信号：部署、ship、快速迭代、频繁发布、降低风险、faster is safer。

Idioma del texto original: chino

no-progress-tracking

当用户完成多个技能但仍不知道自己是否真正进步、无法量化工程能力成长，或缺乏反馈循环导致动力下降时调用此 skill。不适用于：已有明确评估标准的用户、只需要单个技能建议的场景。关键 trigger 信号：进步、技能成长、反馈循环、量化成长、完成技能但不确定。

Idioma del texto original: chino

no-systematic-methodology

当用户安装了多个技能但仍感到迷茫、不知道如何系统提升工程能力，或随机选择技能缺乏连贯学习路径时调用此 skill。不适用于：已有明确学习计划的用户、只需要单个技能建议的场景。关键 trigger 信号：迷茫、不知道下一步、随机选择、缺乏系统性、完成技能但没进步。

Idioma del texto original: chino

no-team-collaboration-guidance

当用户完成个人技能后不知道如何在团队中协作、缺乏 Git 工作流知识，或在真实团队环境中不知所措时调用此 skill。不适用于：纯个人练习、不需要团队协作的场景。关键 trigger 信号：团队协作、Git worktree、版本控制、协作开发、团队环境、多人项目。

Idioma del texto original: chino

one-size-fits-all

当用户在不需要生产级标准的项目上过度工程化、缺乏灵活性，或不知道如何根据项目类型调整技能应用时调用此 skill。不适用于：纯生产环境项目、已有明确工程标准的场景。关键 trigger 信号：过度工程化、原型验证、内部工具、实验性项目、差异化需求、一刀切。

Idioma del texto original: chino

test-driven-development

当用户询问"如何证明代码正确"、"测试应该什么时候写"或"如何确保代码质量"时调用此 skill。不适用于：纯理论讨论、不需要验证的场景、探索性编程。关键 trigger 信号：测试、TDD、证明、验证、RED-GREEN-REFACTOR、tests are proof。

Idioma del texto original: chino

incomplete-coverage-anti-pattern

当需要识别和避免不完整覆盖反模式时使用此 skill。适用于：大变更集审查、多文件 PR 审查等场景。不适用于：小型单一文件修改。关键 trigger 信号：用户提到"遗漏文件"、"偷工减料"、"覆盖不全"等问题。

Idioma del texto original: chino

position-drift-anti-pattern

当需要识别和避免位置漂移反模式时使用此 skill。适用于：代码审查报告生成、问题定位等场景。不适用于：不需要精确定位的场景。关键 trigger 信号：用户提到"位置不准"、"行号漂移"、"文件引用错误"等问题。

Idioma del texto original: chino

unstable-quality-anti-pattern

当需要识别和避免质量不稳定反模式时使用此 skill。适用于：代码审查质量波动、提示微调导致结果变化等场景。不适用于：质量稳定的场景。关键 trigger 信号：用户提到"质量波动"、"提示微调"、"难以调试"等问题。

Idioma del texto original: chino

no-collaboration-guidance

当用户完成个人项目后不知道如何在团队中协作、缺乏 Git 工作流知识，或在真实团队环境中不知所措时调用此 skill。不适用于：纯个人练习、不需要团队协作的场景。关键 trigger 信号：团队协作、Git worktree、版本控制、协作开发、团队环境、多人项目。

Idioma del texto original: chino