Communityコーディング&開発github.com

mattpocock/implement-spec

仕様書に基づいてコードを実装します。

implement-spec とは?

このスキルは、仕様書とそれに関連付けられたチケット群に基づいて、コードベースに変更を加えるためのPR(プルリクエスト)を作成します。チケットはブロッキング関係を持つタスクグラフとして定義されており、依存関係のないチケットから順に並行して実装を進めることができます。実装サブエージェントはバックグラウンドで並列実行され、各チケットを個別のワークツリーで処理した後、マージサブエージェントがメインのPRブランチに統合します。最終的にコードレビューを実行し、指摘事項を修正した上でPRをレビュー可能な状態にします。このスキルはClaude CodeやCodexのようなマルチエージェントシステムに対応しており、仕様書の実装を効率的かつ構造的に進めるのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/in-progress/implement-spec

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

あなたには仕様書が与えられています。この仕様書には、仕様書の実装方法を説明するチケットが関連付けられているはずです。

目標は、単一のブランチ上で仕様全体を実装するPRを作成することです。

チケットはステップのリストではありません。チケット間にはブロッキング関係を持つタスクグラフです。つまり、常にフロンティアと呼ばれる、すぐに着手可能なチケット群が存在します。

サブエージェントとの間の通信は控えめにしてください。主にコンテキストポインタ(仕様書、チケット、調査ノート、以前のコミットへの参照)を介して通信し、ポインタで既に利用可能な情報を重複して伝えないようにしてください。

実装サブエージェントは、可能な限りバックグラウンドで最大限の並行性をもって実行してください。

手順

  1. 仕様書とチケットを読みます。タスクグラフを理解するのに十分な量を読んでください。

  2. (省略可能) 調査サブエージェントを使用して、チケットに必要な調査(関連するコードベースのファイルや外部ドキュメント)を実施します。調査サブエージェントがファイルを保存できるようにしてください。調査結果のMarkdownノートは、リポジトリ外のすべての将来のサブエージェントがアクセス可能なディレクトリに保存します。これにより、実装サブエージェントは調査ではなく実装に集中できます。

  3. ブランチとドラフトPRを作成します。PRは、仕様のIssueとチケットを「クローズする」ものとしてマークしてください。

  4. 実装サブエージェントを使用して、各チケットを実装します。各実装サブエージェントは、自身のワークツリーと独自のブランチで作業する必要があります。

  5. 実装サブエージェントが完了したら、マージサブエージェントを使用して、その作業をPRブランチにマージします。

  6. これにより利用可能なチケットのフロンティアが変わった場合は、さらに実装サブエージェントを起動して新しいチケットに取り組みます。これにより最大限の並行性を実現します。

  7. すべてのチケットが完了したら、PRブランチに対して /code-review を実行します。コードレビューで指摘されたすべての問題を、単一の実装サブエージェントで修正します。

  8. PRをレビュー可能な状態にします。

  9. すべての実装サブエージェントのワークツリーをクリーンアップします。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

関連スキル