skills

Skills for Real Engineersは、Matt Pocockによるリポジトリで、AIコーディングエージェントを使った日常的なソフトウェアエンジニアリングに用いるエージェントスキルを収録している。著者の.agentsディレクトリから共有されており、小さく、適応可能で、組み合わせ可能、かつモデル非依存になるよう設計されている。著者はこれらを、GSD、BMAD、Spec-Kitのようなより大きなプロセスを所有するアプローチとは区別している。それらは開発者から制御を奪うと主張し、これらのスキルは既存のワークフローに適合することを目指している。 インストールには2つの方法がある。Claude Codeプラグインは全セットを管理された読み取り専用バンドルとしてインストールし、自動的に更新される。一方、skills.shインストーラーは編集可能なスキルファイルをプロジェクトにコピーするため、ユーザーが変更できる。インストール後、セットアップスキル（setup-matt-pocock-skills）をリポジトリごとに一度実行し、イシュートラッカー（GitHub、Linear、またはローカルファイル）、トリアージラベル、ドキュメントの場所を設定する。 このリポジトリの明示された動機は、コーディングエージェントにおける一般的な失敗モードを修正することである。 - ユーザーが望むものとエージェントが構築するものとの不一致。これは作業開始前に計画を問いただすグリリングセッション（grill-me、grill-with-docs）で対処する。 - 冗長なエージェント出力。これはCONTEXT.mdとADRに文書化された共有ドメイン言語を構築することで対処し、エージェントがより簡潔に推論しコミュニケーションできるようにする。 - 動作しないコード。これはフィードバックループ、すなわち静的型、ブラウザアクセス、自動テストを通じて対処する。これにはレッド・グリーン・リファクタリングのTDDスキルと、段階的なdiagnosing-bugsループが含まれる。 - アーキテクチャの劣化。これは深いモジュールと定期的なコードベースアーキテクチャ調査を促す設計重視のスキルで対処する。 スキルは2つの主要カテゴリに整理されている。 エンジニアリングスキルには、ask-matt（スキル上のルーター）、grill-with-docs、triage、improve-codebase-architecture、to-spec、to-tickets、implement、wayfinderなどのユーザー呼び出しコマンドが含まれる。モデル呼び出しエンジニアリングスキルには、prototype、diagnosing-bugs、research、tdd、domain-modeling、codebase-design、code-review、resolving-merge-conflicts、wizardが含まれる。モデル呼び出しスキルは、適切な場合にエージェントが自動的に呼び出すことがある。ユーザー呼び出しスキルはワークフローを編成し、モデル呼び出しスキルを呼び出すことがある。 生産性スキルはコーディング以外でも使用でき、grill-me、handoff、teach、to-questionnaire、wait-whatなどのユーザー呼び出しコマンドに加え、再利用可能なインタビューのプリミティブであるgrillingと、AGENTS.mdやCLAUDE.mdのようなエージェント可読ドキュメントを生成するためのwriting-for-agentsが含まれる。 著者はスキルの変更を最新の状態に保つためのニュースレターを提供している。このリポジトリは設計上の決定も文書化しており、その1つはClaude Codeプラグインとして出荷することに関するもので、ADRディレクトリにある。全体として、これはスラッシュコマンドとエージェント呼び出し可能なスキルとして符号化された、反復可能なエンジニアリング実践の実用的なライブラリであり、AIエージェントがソフトウェアを書く方法をより制御したい開発者を対象としている。