Skip to content

pecotcraft/pecot-w

v5.0.0

pecot-w (pecot-workflow) workflow automation plugin - skills, hooks, agents, and MCP tools for AI-assisted development

pecot-workflow plugin

Claude Code GitHub Copilot CLI Node.js TypeScript MCP GitHub Projects

GitHub Projects V2 と連携し、Issue 起票から実装・PR・リリースまでの開発ワークフローを提供します。 提供の形は、Claude Code / GitHub Copilot CLI のスキルです。 複数リポジトリを 1 つのボードで横断管理し、git worktree を使った並行開発に対応します。


スキル

区分スキル内容
起票・計画/pecot-w:w-backlogEpic を作成し Backlog に配置する
起票・計画/pecot-w:w-breakdownEpic を speckit フロー(specify → clarify → plan → tasks)でサブタスクに分解する
起票・計画/pecot-w:w-readyEpic 配下のサブタスクを 1 件作成し Ready に配置する
起票・計画/pecot-w:w-issueize実装計画の各フェーズを Issue として一括登録する
実装/pecot-w:w-activeReady のタスクを選択し、ブランチ作成から実装計画の作成まで進める
実装/pecot-w:w-quick小タスクの Issue 起票・ブランチ作成・実装計画の作成を一度に行う
PR・リリース/pecot-w:w-prPR を作成する。タイトルと説明はコミット内容から生成する
PR・リリース/pecot-w:w-revise自分の PR をエージェントがレビューし、採用した指摘を修正する
PR・リリース/pecot-w:w-mergePR をマージし、ブランチ削除と後処理を行う
PR・リリース/pecot-w:w-releaseCHANGELOG 更新・タグ作成・GitHub Release 公開までのリリースを実行する
運用/pecot-w:w-onboardingGitHub Projects ボードの作成とリポジトリ登録を行い、プロジェクトを新規セットアップする
運用/pecot-w:w-repo-addボードにリポジトリを追加登録する
運用/pecot-w:w-worktree-add / /pecot-w:w-worktree-removegit worktree を作成・削除する
運用/pecot-w:w-helppecot CLI とスキルの使い方を調べる

エージェント

スキルの実行中に、次のエージェントが起動されます。

エージェント役割
w-implementerコード実装。コード変更とテスト作成
w-tech-advisor技術調査。対象技術を解析し、計画・実装中の技術的な質問に回答する
w-e2e-plannerE2E テスト。CUJ の設計・妥当性レビューと、実際の CUJ 実行による検証

MCP サーバ

MCP サーバ pecot-workflow が、pecot CLI の 35 個のコマンドを MCP ツールとして公開します。 ツール名は、コマンドの空白と - を _ に置き換えた形です(issue create は issue_create、add-to-project は add_to_project)。 許可リストに書くツール名は、Claude Code では mcp__plugin_pecot-w_pecot-workflow__<ツール名> です。 GitHub Copilot CLI では pecot-workflow-<ツール名> です。

ブラウザ操作用に Playwright の MCP サーバ pecot-workflow-playwright と、ライブラリのドキュメントを引く context7 も登録します。 ブラウザは、端末に入っている Google Chrome を使います。 Chrome が無い端末での入れ方は、pecot-visual の README を参照してください。

Agent Plugins 1.0 に対応したクライアントが読み込むのは、スキルと MCP サーバです。 スキルの手順の一部は、クライアントの機能(質問の UI・プランモード)に頼ります。 hooks とエージェントは、Claude Code と GitHub Copilot CLI でだけ動きます。

プラグインを入れずにツールだけ使う場合は、npm のパッケージ @pecot/workflow-mcp の README を参照してください。

MCP サーバにつながらないとき

Claude Code は、プラグインの stdio のサーバの起動の失敗を 15 分覚えます。 その間に始めたセッションは、15 分が過ぎても、そのセッションの中では試し直しません。 症状は、Skipping connection (recent failure cached で始まる文言です。

直し方は、次のどちらかです。

  • /mcp でサーバを選んで Reconnect する
  • 15 分たってから新しいセッションを始める

動作要件

  • Claude Code 2.1.141 以上、または GitHub Copilot CLI 1.0.106 以上
  • gh CLI — gh auth refresh -s project で project スコープを追加してください
  • Node.js 24 系は 24.22.1 以上、26 系は 26.12.1 以上 — pecot の実行に使う。初回の実行時に、依存の導入とビルドを行う(pnpm・corepack・npx のいずれかが要る)

インストール手順はリポジトリルートの README を参照してください。


設定

環境変数内容
XDG_DATA_HOMEBash から実行する pecot の実行用の環境を $XDG_DATA_HOME/pecot/pecot-workflow に作ります(XDG_DATA_HOME が未設定か絶対パスでなければ ~/.local/share/pecot/pecot-workflow)。hook からの実行ではクライアントのデータ置き場を使います。プラグインをアンインストールしてもこの場所は残るので、不要になったら手で消してください

ライセンス

MIT License です。全文は LICENSE にあります。