ai-coding-collaboration は何をしますか？
タスク評価、最小差分コーディング、検証、簡潔な引き継ぎサマリーのためのCodexスキル。
概要
このスキルは、AIエージェントと人間の開発者間、またはAIエージェント間のコラボレーションを円滑にします。具体的には以下の機能を提供します。
- タスク評価: 与えられたタスクが適切に完了したかを評価します。
- 最小差分コーディング: 変更を最小限に抑え、既存のコード構造を尊重します。
- 検証: 変更後のコードが正しく動作するか、構文エラーがないかを検証します。
- 引き継ぎサマリー: 次の担当者（人間またはAI）に対して、現在の状況、変更点、未解決の問題を簡潔にまとめます。
使用方法
- タスクを明確に定義します。
- エージェントにこのスキルを適用するよう指示します。
- エージェントはタスク評価、コーディング、検証を実行します。
- エージェントは引き継ぎサマリーを生成します。
スキル詳細
タスク評価基準
- タスクの完了条件がすべて満たされているか。
- コードのスタイルと規約に準拠しているか。
- 既存のテストを壊していないか。
コーディング規約
- 最小差分: 変更が必要な行のみを修正し、不要な空白行やコメントの変更は避けます。
- 一貫性: 既存のコードベースのスタイル（命名規則、インデントなど）を尊重します。
- テスト: 可能な限り、変更に対応するテストを追加または更新します。
検証手順
- 構文チェック（例:
python -m py_compile <file>） - リンターの実行（例:
ruff check .） - 既存テストの実行（例:
pytest）
引き継ぎサマリーの構成
## 引き継ぎサマリー
### 完了したタスク
- [タスク1の説明]
- [タスク2の説明]
### 変更したファイル
- `path/to/file1`: [変更の簡単な説明]
- `path/to/file2`: [変更の簡単な説明]
### 未解決の問題
- [問題点や注意点]
### 次のアクション
- [次に行うべきこと]
プラットフォームサポート
このスキルは、Codex APIを利用する以下のプラットフォームで動作することを想定しています。
- Claude Code
- Cursor
- GitHub Copilot (Chat機能を含む)
- その他、Codexベースのエージェント
注意点
- このスキルは、明確に定義されたタスクに最も効果的です。
- 大きなリファクタリングよりも、段階的な改善に適しています。
- AIエージェントの能力範囲を超える複雑な判断は、人間の開発者に委ねる必要があります。