addyosmani/agent-skills

解決する課題

AIコーディングエージェントは、シニア開発者のような厳格なエンジニアリングの規律に欠けていることが多く、テストをスキップしたり、パフォーマンスを無視したり、適切な仕様なしに直接コードの記述に取り掛かったりしがちです。本プロジェクトは、「skills」と呼ばれる構造化されたワークフローのライブラリを提供し、エージェントがソフトウェア開発ライフサイクル全体で本番環境レベルのエンジニアリングベストプラクティスに従うよう強制します。

仕組み

本プロジェクトは、AIエージェントのシステムプロンプトまたは命令セットとして機能する24のMarkdownベースのスキルで構成されています。各スキルは参照ドキュメントではなくプロセスとして設計されており、以下の特徴があります。

• ステップバイステップのワークフロー: チェックポイントと終了基準を備えた明確なアクションのシーケンス。
• 反合理化テーブル: 品質ステップをスキップするためにエージェントがよく使う言い訳（例：「後でテストを追加します」）に対する事前定義された反論。
• 検証ゲート: タスクが完了したと見なされる前に、証拠（テストの成功やランタイムデータなど）に対する厳格な要件。
• スラッシュコマンド: 特定のライフサイクルフェーズにマッピングされた事前定義されたトリガー（例：/spec、/plan、/build）。

これらのスキルは、CLIを介して、またはMarkdownファイルをエージェントの設定に追加することで、さまざまなAIエージェント（Claude Code、Cursor、Codex、Copilotなど）にインストールできます。

対象者

AI生成コードが品質、セキュリティ、保守性のプロフェッショナル基準を満たすようにしたい、AIコーディングエージェントを使用する開発者。

ハイライト

• 包括的なライフサイクルカバレッジ: 初期の要件収集（/spec）からデプロイ（/ship）までをカバーする24のスキルが含まれています。
• エージェントペルソナ: コードレビューを行うシニアスタッフエンジニアや、脆弱性監査を行うセキュリティエンジニアなどの専門家ペルソナが含まれています。
• 幅広い互換性: Claude Code、Cursor、Windsurf、GitHub Copilotを含む幅広いAIツールで動作します。
• 自律モード: /build autoコマンドにより、エージェントはテスト駆動の検証を維持しながら、自律的にタスクを計画して実装できます。