Communityライティング&編集github.com

troels-im/agent-skills-playbook-template

プログレッシブなドキュメント・アズ・コードのテンプレート。AIエージェントスキル、AGENTS.md、プレイブック、作業トレース、そしてjustテストポリシーを統一的に管理します。

agent-skills-playbook-template とは?

このスキルは、リポジトリフローを低トークンで実行するためのコマンドサーフェスを提供します。開発者は「/lets」コマンドを使用して、AGENTS.mdやindex.md、flowsディレクトリ内のフローファイルを逐次読み込み、最適なワークフローを選択・実行できます。各フローにはチェックリストが生成され、進捗状況は所定のフォーマット(例:XX% / YY% / ZZ%)で報告されます。また、コミット前の「just turn-test」やPRテストの「just pr-test」を自動的に実行し、テストがパスするまで修正を繰り返します。このスキルはClaude CodeやCursorなどのAIエージェントプラットフォームで利用可能で、人間の介入が必要なステップではユーザーに明示的に問い合わせ、不要な推測を防ぐ設計になっています。

対応~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

/lets

このスキルを、リポジトリフロー向けの低トークンコマンドサーフェスとして使用します。

ワークフロー

  1. AGENTS.md を読む。
  2. ルートの index.md を読む。
  3. flows/index.md を読む。
  4. 最も小さくマッチするフローを選択する。
  5. 選択したフローファイルを読み込む。
  6. そのフローにちなんだフロー実行チェックリストを作成または更新する。 生成される実行名にはUTCタイムスタンプのスラッグを使用する: run-YYYYMMDDTHHMMSSZ-short-slug.md
  7. フローで指定され、現在のステップで必要なプレイブックのみに従う。
  8. 進捗更新の先頭に、フローで要求されるフォーマットを付与する: XX% / YY% / ZZ%: メッセージ
  9. コミットごとに just turn-test を実行する。
  10. フローの最終ステップで just pr-test を実行し、失敗したPRテストを修正し、PRテストがパスするか実際のブロッカーが記録されるまで繰り返す。

ユーザー入力ゲート

フローのステップでユーザーの入力、承認、プロダクト上の決定、またはフィードバックが必要な場合、ループを一時停止して質問する。不足している判断を推測したり、推測された要件に基づいて続行したりしてはならない。

ユーザーが明示的に邪魔をしないように指示したり、質問しないように指示したり、最善の判断で進めるように指示したり、同等の指示を与えた場合にのみ、質問せずに続行する。その際、前提条件を実行チェックリストに記録し、可能な限り元に戻せる状態を維持する。

マッチするフローがない場合は、その旨を明確に伝え、playbooks/repository/choose-workflow.md にルーティングする。

/goal や /loop をこのテンプレートのユーザーコマンドとして扱わないこと。ユーザー向けコマンドには /lets を使用し、永続的なリポジトリレイヤーとして flows/ を使用する。

関連スキル