parallel-agent-contracts について
並行するコード実装エージェントに既存の型を再利用させ、完了前に TypeScript を検証するためのスキルです。複数エージェントを調整する TypeScript チーム向けです。
主な機能
- 01TypeScript 検証の必須化
- 02型を定義する前の検索
- 03標準型の所有元マップ
- 04再利用できるエージェント用プロンプト
活用シーン
- 01並行タスクでの型定義の重複防止
- 02エージェントの完了報告前の TypeScript 検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/parallel-agent-contractsを入力して読み込まれたか確認します。
詳細
並列エージェントの型コントラクト
コード実装のために並列エージェントを起動する際は、型の重複を防いでください。
すべてのエージェントプロンプトに必須の項目
1. 検証コマンド（必須）
## Before Marking Complete
Run verification:
\`\`\`bash
npx tsc --noEmit 2>&1 | head -20
\`\`\`
If ANY type errors exist, fix them before completing.
2. 作成前の grep
## Before Creating Any Type/Interface
First check if it exists:
\`\`\`bash
grep -r "interface YourTypeName\|type YourTypeName" src/
\`\`\`
If found, import it. NEVER duplicate existing types.
3. 正規の型マップ
このマップから関連する項目をエージェントプロンプトに含めてください。
| 型 | 管理ファイル | インポート元 |
|---|---|---|
NormalizedTool | src/sdk/agent.ts | './agent' |
ToolCall | src/sdk/agent.ts | './agent' |
ToolResult | src/sdk/agent.ts | './agent' |
ToolDefinition | src/sdk/agent.ts | './agent' |
Message | src/sdk/types.ts | './types' |
ContentBlock | src/sdk/types.ts | './types' |
TokenUsage | src/sdk/types.ts | './types' |
ProviderAdapter | src/sdk/providers/index.ts | './providers' |
RiggClient | src/sdk/client.ts | './client' |
プロンプトのテンプレート
実装エージェントを起動するときは、次を使用してください。
# Task: [Description]
## Type Ownership (DO NOT recreate)
- [List relevant types from canonical map]
## Before Creating New Types
Run: `grep -r "interface TypeName" src/` - if exists, import it.
## Before Marking Complete
Run: `npx tsc --noEmit 2>&1 | head -20`
Fix all type errors before completing.
## Your Implementation
[Actual task description]
これが機能する理由
- 型チェッカーが契約です - tsc が競合を自動的に検出します
- grep は高速です - 型が存在するかどうかを1秒で確認できます
- 所有者が明確です - 型の定義場所に曖昧さがありません
- 早期に失敗します - 型が壊れたままエージェントが「完了」と主張することはできません
コメント
Markdown 対応