给工程师的 AI 编码工作流：一组可组合的 Agent Skills

This is a collection of lightweight, composable skills designed for coding agents like Claude Code or Codex. It’s not vibe coding. Each skill encodes battle-tested software engineering practices—grilling sessions, shared language, red-green-refactor loops—into repeatable commands so that AI-assisted development stays aligned, correct, and maintainable.

The repository identifies four fundamental failure modes in agent-assisted development: 1) misalignment between developer intent and agent output, 2) verbose, jargon-ridden communication, 3) broken code from lack of tight feedback loops, and 4) rapid codebase entropy leading to a “ball of mud”. Each skill in this repo directly targets one or more of these problems.

Two key design pillars stand out. First, /grill-me and /grill-with-docs force the agent to become a relentless interviewer, drilling into your plan until every edge case is exposed. This upfront alignment prevents costly misunderstandings. Second, /grill-with-docs captures this discussion into a CONTEXT.md file, creating a shared, domain-specific glossary. This shared language drastically reduces token waste and improves naming consistency across the project.

To ensure the code actually works, the skills enforce tight feedback loops. /tdd guides the agent through a strict red-green-refactor cycle, writing failing tests before implementation. /diagnose provides a structured debug loop: replicate → minimize → hypothesize → instrument → fix → regression-test. These steps ground the agent in concrete execution results rather than hallucinations.

These skills are not a framework, but a set of markdown files (SKILL.md) that define slash commands for the agent. The repository structure separates them into skills/engineering, skills/productivity, and skills/misc. An installer (npx skills@latest add mattpocock/skills) scaffolds them into the local agent’s directory. A first-run /setup-matt-pocock-skills command then tailors the skills to your project by asking about issue trackers, triage labels, and document storage locations.

To use these skills, first add them to your agent:

npx skills@latest add mattpocock/skills

During installation, select the skills you want and your target agents. Ensure you include /setup-matt-pocock-skills.

Next, run the setup command inside your agent:

/setup-matt-pocock-skills

This interactive command will configure the issue tracker, triage labels, and the document directory, after which all other skills are ready to use.

The skills/engineering directory contains commands for the whole development cycle. to-prd synthesizes a PRD from the conversation and files a GitHub issue. to-issues breaks it into vertical-slice issues. triage manages issues through a state machine. tdd enforces a test-first workflow, and diagnose hunts bugs systematically. A crucial maintenance command is improve-codebase-architecture, which is recommended to run every few days to find “deepening” opportunities.

These skills are ideal for disciplined, long-lived software projects where code quality, domain complexity, and maintainability are primary concerns. They are particularly effective when paired with Claude Code or Codex. Caveats: The skills are opinionated toward GitHub/Linear issue trackers and manually defined triage labels. They also assume the user is comfortable running slash commands and maintaining a CONTEXT.md. They are not a one-shot project generator; they shine in iterative, day-to-day engineering work.