Communitygithub.com

leonhoffmann86/team-sprint

🏃 スプリント — すべてのTODO項目が完全なミニスプリントを実行します。自律的な計画→実装→レビューを、Gitフックエージェントチェイン、隔離されたワークツリー、決定論的ゲート及びフェイルクローズレビューによりClaude Code向けに提供します。

team-sprint とは?

このスキルは、Claude Code上で動作する洗練されたタスクリファインメントワークフローです。ユーザーが大まかなアイデアを入力すると、それを構造化されたTODO項目に変換し、自律的な「計画→実装→レビュー」のチェインを開始します。主な機能として、プロジェクトの憲法ファイル(`AGENTS.md`、`CLAUDE.md`、`sprint.conf`で指定されたファイル)の読み取りと遵守、コードグラフまたはgrep/globによる実際のコードベースへのグラウンディング、リスク階層に基づいたアイデアの検証、そして決定論的ゲートとフェイルクローズレビューによる安全な実装が含まれます。このスキルは特に、複数の開発者が関わるプロジェクトや、自律的なエージェントアクションに対する厳格なガバナンスが必要な環境で有用です。TODO.mdへの項目追加、実装ブランチへの分離、そして人間による承認が必要なハイリスクタスクの自動実装抑制など、安全で追跡可能なプロセスを提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

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

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

ドキュメント

あなたは大まかなアイデアを TODO.md の1つの適切に形成されたタスクに変換します。大まかなアイデア:

$ARGUMENTS

これはリファインメントワークフローであり、実装ではありません。コードを書かないでください。 タスクが明確になり、ユーザーが承認するまで TODO.md に書き込まないでください。以下の手順に従って作業します:

1. 憲法を読む

プロジェクトの憲法ファイルを見つけて読んでください。その規則、特にリスク階層と自律エージェント/TODOライフサイクルルールに従います。

  • sprint.conf が存在する場合、SPRINT_CONSTITUTION_FILES にリストされているファイルを(順番に)読み込みます。
  • そうでなければ、存在する AGENTS.md、CLAUDE.md(およびそれらが参照するプロジェクト固有のガイド、例:フロントエンドの CLAUDE.md)を読み込みます。
  • .githooks/README.md が存在する場合は軽く読み、ダウンストリームへの影響を正しく説明できるようにします。

これらのファイルがどれも存在しない場合、リポジトリがまだブートストラップされていないことをユーザーに伝え、/sprint:bootstrap を提案します。

2. アイデアを実際のコードに基づいて検証する(推測しない)

アイデアが触れる実際のシンボル/ファイルとその影響範囲を見つけます:

  • コードグラフ(推奨、利用可能な場合): mcp__codegraph__* ツール(codegraph_search、…_callers、…_callees、…_impact、…_context)、またはCLI(codegraph context "<the idea>"、codegraph callers <symbol>、codegraph impact <symbol>)。インデックスが古そうな場合は、最初に codegraph sync . を実行します。
  • フォールバック(コードグラフなし): Grep/Globを使用して関連するシンボルとその呼び出し元を特定します。

実際に重要なファイルをいくつか読んでください。具体的な関数/ファイル名と、変更がどこに入るかを指定します。

3. 検証する(このスキルの中核)

コードが既に行っていることに対して、アイデアに疑問を投げかけます。以下の点を明らかにします:

  • 質問かタスクか? 本当に質問(「…それとも何か見落としている?」)であれば、まずコードから答えてください。既存のロジックがすでにその一部をカバーしている可能性があります。
  • 実際のスコープと、価値を提供する最小の変更。
  • リスク階層(憲法/ AGENTS.md に従う)。ハイリスクの場合は、そのように述べてください。自動実装はされません。チェインは人間に委ねます。
  • ユーザーが決定すべき事項(製品/UX/ポリシーの選択)であり、あなたが決定すべき事項ではありません。

AskUserQuestion を使用して、それらのいくつかの決定事項をユーザーに質問します。真の製品決定に対する答えをでっち上げないでください。コードベースからの証拠を使用して誤った仮定を修正します。

4. 1つの構造化された項目をドラフトする(4つの要素)

以下の内容でドラフトを作成します:

  1. 明確な命令形のタスク(疑問形ではない)、
  2. リスク階層、
  3. 具体的な完了基準(どのターゲットテストが成功する必要があるか/どの動作が検証可能か)、
  4. ステップ2からのファイル/関数のヒント。

最小の価値ある変更に絞ります。ドラフトを表示し、ユーザーが満足するまで調整します。

5. TODO.md に書き込み、引き継ぐ

  • 承認された項目を TODO.md の上部近くに - [ ] エントリとして追加します。
  • それを単一のアクティブ項目にするかどうかを質問します。もし yes の場合、スキップ規則に従って、他の現在アクティブな項目を <!-- … --> ブロック(または ## 🚧 Deferred の下)に移動し、チェインがこの項目のみを取得するようにします。
  • 自動的にコミットしないでください。 ユーザーに伝えます: TODO.md をコミットすると、plan→implement→reviewチェインが開始されます(実装は impl ブランチに配置され、自動マージは行われません)。プロセスを今すぐ開始したい場合は、コミットするように提案します。

対話は簡潔に保ちます: まず根拠を示し、重要な決定事項のみを質問し、その後書き込みます。

関連スキル