compound-engineering-plugin
CLI ツールEveryInc/compound-engineering-plugin
AIコードアシスタントプラグイン、エンジニアリング知識とスキルを蓄積する。
概要
Claude Code、Cursor、CodexなどのAIコーディングツールに37のスキルと51のエージェントを提供します。深い計画、レビュー、知識の蓄積を通じて、エンジニアリング作業を毎回前回よりも簡単にし、技術的負債を継続的に削減します。
README プレビュー
# Compound Engineering\n\n[](https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.yml)\n[](https://www.npmjs.com/package/@every-env/compound-plugin)\n\nAI skills and agents that make each unit of engineering work easier than the last.\n\n## Philosophy\n\n**Each unit of engineering work should make subsequent units easier -- not harder.**\n\nTraditional development accumulates technical debt. Every feature adds complexity. Every bug fix leaves behind a little more local knowledge that someone has to rediscover later. The codebase gets larger, the context gets harder to hold, and the next change becomes slower.\n\nCompound engineering inverts this. 80% is in planning and review, 20% is in execution:\n\n- Plan thoroughly before writing code with `/ce-brainstorm` and `/ce-plan`\n- Review to catch issues and calibrate judgment with `/ce-code-review` and `/ce-doc-review`\n- Codify knowledge so it is reusable with `/ce-compound`\n- Keep quality high so future changes are easy\n\nThe point is not ceremony. The point is leverage. A good brainstorm makes the plan sharper. A good plan makes execution smaller. A good review catches the pattern, not just the bug. A good compound note means the next agent does not have to learn the same lesson from scratch.\n\n**Learn more**\n\n- [Full component reference](plugins/compound-engineering/README.md) - all agents and skills\n- [Compound engineering: how Every codes with agents](https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents)\n- [The story behind compounding engineering](https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it)\n\n## Workflow\n\n`/ce-strategy` is upstream of the loop -- it captures the product's target problem, approach, persona, metrics, and tracks as a short durable anchor at `STRATEGY.md`. Ideate, brainstorm, and plan read it as grounding when present, so strategy choices flow into feature conception, prioritization, and spec.\n\nThe co
FAQ (5)
トラブル対応--to copilot オプションが削除された後、VS Code Copilot に Compound Engineering プラグインをインストールする方法は?
VS Codeの内蔵コマンドを使用します。Cmd+Shift+P(Mac)またはCtrl+Shift+P(Windows/Linux)を押し、「Chat: Install Plugin from source」を選択し、リポジトリURLとして「EveryInc/compound-engineering-plugin」を入力し、リストから「compound-engineering-plugin」を選択してください。スキルがCopilotエージェントチャットに表示されます。これにより、古い--to copilotコンバーターを使用する必要がなくなります。
トラブル対応ce-code-review が 'scripts/resolve-base.sh not found' エラーで失敗するのはなぜですか?
明示的なbase refを渡して、不足しているヘルパースクリプトを回避してください。例:/ce-code-review base:origin/main を使用します。このバグは compound-engineering v3.7.3 に存在します。SKILL.md がプロジェクトルートに対して解決される相対パスを使用しており、スキルディレクトリに対して解決されないためです。恒久的な修正については issue #811 を追跡してください。
トラブル対応なぜce-resolve-pr-feedbackスキルは、多くのスレッドがあるPRに未回答のボットレビューがある場合でも、'No new items'と表示するのですか?
これはcompound-engineering 3.7.0における既知のバグで、scripts/get-pr-comments内のGraphQLクエリが固定の'first: N'ページサイズ(reviewThreads: 50、comments: 100、reviews: 50)を使用しており、pageInfo.hasNextPageカーソルを追従していません。50件を超えるレビュースレッドや100件を超えるコメントがあるPRでは、最初のページ以降の項目が黙って削除され、その結果スキルが作業なしと誤って報告します。回避策として、次のコマンドで未回答の指摘を手動で確認してください:npx agent-reviews --bots-only --unanswered --expanded。スクリプトにページネーションループを追加する修正が追跡されています。
トラブル対応extract-skeleton.pyがClaudeのセッション履歴を処理する際に、'TypeError: unhashable type: 'slice''でクラッシュするのはなぜですか?
クラッシュは、summarize_claude_tool内でinput.get('command')、input.get('query')、またはinput.get('prompt')から辞書型の値をスライスするときに発生します。例:dict[:80]はTypeError: unhashable type: 'slice'を引き起こします。
修正:スライスする前に型チェックを追加します。extract-skeleton.py内で、チェーンされた.get(...)[:N]を以下のようなヘルパーに置き換えます:
def _safe_slice(value, n):
return value[:n] if isinstance(value, str) else ""その後、
_safe_slice(inp.get("query"), 80)などを使用します。これにより、文字列と非文字列入力の両方を安全に処理できます。後でスライスされる可能性がある場合は、
file_path/pathにも同じガードを適用します。フルセッション抽出を復元するには、スクリプトにパッチを適用するか、タイプガード修正を含むバージョンに更新します。
トラブル対応Claude Codeで/ce-sessionsを呼び出す際の'Shell command permission check failed'エラーの修正方法
このエラーは、ce-sessionsのSKILL.mdのプリアンブル内の「Repo name (pre-resolved)」行にネストされたサブシェルが含まれているために発生します。Claude Codeの許可システムはこれを静的に解析できません。回避策: skills/ce-sessions/SKILL.mdの23行目を編集し、問題のあるコマンドを次の単一のシンプルなコマンドに置き換えてください: Repo root (pre-resolved): !git rev-parse --show-toplevel 2>/dev/null || true。これにより完全なリポジトリパスが出力されます。利用者は自身でベース名を派生させる必要があります。修正は将来のリリースで予定されています。