本文へ移動
cccskills
無料GitHub で公開日本語紹介

implement-spec

仕様書と関連チケットの依存関係を読み取り、複数エージェントで実装・統合・コードレビューを進め、全体を一つの統合ブランチにまとめるスキルです。

原文原文の説明を見る

在代码中实现 /to-spec 和 /to-tickets 的产出。

インストール方法を見る

こんなときに便利

  • 仕様書と関連チケットを実装したいとき
  • 依存関係のある作業を進めたいとき
  • 別々のworktreeで並行実装したいとき
  • 変更を統合してPRのレビューを依頼したいとき

日本語での紹介

できること

/to-specと/to-ticketsで作った仕様書とチケットを基に、コードへの実装を進めます。チケットを単なる手順の一覧ではなく、着手条件や依存関係のある作業として読み取り、取り掛かれるものを複数のエージェントに割り当てます。各担当は独立した作業場所であるworktreeとブランチを使い、成果を一つの統合ブランチに集めます。

こんなときに便利

仕様は決まっているものの、複数のチケットに分かれた実装をまとめて進めたいときに向いています。必要に応じて事前調査のメモを共有し、担当ごとの調査の重複を避けながら作業を進めます。全チケットの実装後にはコードレビューを行い、指摘された問題も修正します。

使い方の例

  • 「この仕様書と関連チケットを、依存関係に沿って実装して」
  • 「実装を統合してコードレビューを行い、draft PRをレビュー可能な状態にして」

注意点

仕様書、関連チケット、設定済みの課題管理先が前提です。課題管理先が未設定なら/setup-matt-pocock-skillsの実行を案内します。手順内でtddとcode-reviewを呼び出します。PRの作成やチケットの完了処理は課題管理先の運用に従います。

この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル(2)

  • SKILL.md2.7 KB
  • agents/openai.yaml164 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

你已经获得一份 spec。这份 spec 应该有与之关联的 tickets,说明如何实现它。

Issue tracker 应当已经提供给你。如果没有,就告诉用户运行 /setup-matt-pocock-skills。

目标是在单个 integration branch 上实现整个 spec,并按 issue tracker 关闭工作的方式解决每一个 ticket。

tickets 不是步骤清单,而是一个 task graph,其中包含 blocking relationships。这意味着始终存在一个由可领取 tickets 组成的 frontier。

与 subagents 的通信应当简洁。主要通过 context pointers 通信:指向 spec、tickets、research notes 和之前的 commits。不要重复 pointers 已经提供的信息。

在可能的情况下,implementer subagents 应当在 background 中运行,以获得最大并发度。

步骤

  1. 阅读 spec 和 tickets,理解 task graph。

  2. (可选)使用一个 exploration subagent 完成 tickets 所需的探索,即相关的 codebase files 或 external documentation。确保 exploration subagent 能够保存文件:它应当把 Markdown notes 保存到 repo 外、所有后续 subagents 都能访问的目录。这样 implementer subagents 就能专注于实现,而不必重复探索。

  3. 创建 integration branch。如果 issue tracker 通过 PRs 关闭工作,或用户要求开 PR,就在第 5 步的首次合并之后打开一个 draft PR(不领先于 main 的 branch 无法开 PR),并标记它会关闭 spec 和 tickets。

  4. 使用 implementer subagents 实现每个 ticket,每个 subagent 都在自己的 worktree 和 branch 上工作。每个 implementer subagent:

    • 开始前确认其 worktree 基于 integration branch,若不是则 reset 到它上面;
    • 调用 Skill 工具并指定 tdd 来构建 ticket;
    • 在报告完成前,把 integration branch 的 tip 合并进自己的 branch
  5. 每个 implementer subagent 完成后,使用一个 merger subagent 把它的工作合并到 integration branch。

  6. 如果这改变了可用 tickets 的 frontier,就启动更多 implementer subagents 处理新的 tickets。这样可以获得最大并发度。

  7. 所有 tickets 完成后,在 integration branch 上调用 Skill 工具并指定 code-review。在单个 implementer subagent 中修复 code review 提出的所有问题。

  8. 如果存在 draft PR,把它标记为 ready for review。否则,按 issue tracker 关闭工作的方式解决每个 ticket,并报告 integration branch。

  9. 清理所有 implementer subagent 的 worktrees。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

ask-matt

無料概要あり

アイデアの具体化、実装、不具合調査など、今の状況に合う関連スキルと使う順番を案内し、仕様作成や作業の引き継ぎを含めて開発の進め方を選ぶためのスキル。

  • アイデアから実装までの進め方選び
  • 難しい不具合調査の入口を探したいとき
  • 複数セッションの仕様と作業計画
vinvcn/mattpocock-skills-zh-CN5,1942026年10月20日 更新

claude-handoff

無料概要あり

現在の会話を引き継ぎ用に要約し、新しいバックグラウンドエージェントを起動します。既存資料への参照や推奨スキルを添えて、次の作業へ引き継ぎます。

  • 新しいエージェントで作業を続けたいとき
  • 次のセッションの作業を絞りたいとき
  • 既存資料を参照して引き継ぎたいとき
vinvcn/mattpocock-skills-zh-CN5,1942026年10月20日 更新

code-review

無料概要あり

指定したコミットやブランチからの差分を、コード規約と仕様への適合という二つの観点で並行レビューし、それぞれの指摘と重要な問題を分けて報告するスキル。

  • ブランチやPRをレビューしたいとき
  • 特定コミット以降を確認したいとき
  • 仕様の実装漏れや範囲外の変更の確認
vinvcn/mattpocock-skills-zh-CN5,1942026年10月20日 更新

codebase-design

無料概要あり

少ない利用ルールで多くの処理を扱えるモジュール設計を支援し、共通の用語と原則を使って、インターフェースや処理の差し替え位置、テストのしやすさを検討するスキル。

  • モジュールの使い方を簡単にしたいとき
  • リファクタリング時の構造検討
  • 処理を差し替える位置の検討
vinvcn/mattpocock-skills-zh-CN5,1942026年10月20日 更新

diagnosing-bugs

無料概要あり

不具合や性能低下を繰り返し再現できる検証手順を作り、原因の仮説を絞って修正します。最小の再現例づくりから再発防止テスト、一時的な調査コードの片付けまで進めます。

  • 解消しないエラーや誤出力の調査
  • 断続的な不具合の再現率を上げたいとき
  • 性能低下の測定と原因調査
vinvcn/mattpocock-skills-zh-CN5,1942026年10月20日 更新

domain-modeling

無料概要あり

プロジェクトの用語や概念の境界を具体例とコードで確かめ、合意した定義を用語集に、重要な設計判断を記録に残して認識をそろえるスキルです。

  • プロジェクトの曖昧な用語を整理したいとき
  • GLOSSARY.mdを作成・更新したいとき
  • 概念の境界をコードや例外で確かめたいとき
vinvcn/mattpocock-skills-zh-CN5,1942026年10月20日 更新

vinvcn のスキルをすべて見る

このスキルの問題を報告する