setup-james-skills

James Skills のセットアップ

コーディングエージェントが次の内容を見つけられるよう、現在のリポジトリのルートにある AGENTS.md のみを調整します。

• tech-preferences — 推奨、試験的、および回避するテクノロジー；
• engineering-principles — ローカルで推論できるように設計すること；
• verifiable-trust — 独立した検証と、制限された AI の自律性。

これはファイルを変更するセットアップスキルです。明示的な実行指示により許可されるのは、範囲を限定した AGENTS.md の変更のみであり、リポジトリをまたぐ変更、スキルのインストール、無関係なリファクタリングは許可されません。

調整手順

1. リポジトリのルートを特定し、AGENTS.md が存在する場合は読み込みます。既存の参照と、文書化されたプロジェクト固有の例外を確認し、リポジトリ固有の指示と無関係な内容を保持します。
2. 現在のエージェント環境に3つのスキルがすべてインストール済みで、検出可能か確認します。不足しているスキルを報告します。インストール済みだと偽って報告したり、黙ってインストールしたりしないでください。今後のセットアップに役立つよう、参照を記述してもかまいません。
3. 正確なマーカーペア と を探します。両方が正しい順序でそれぞれ1回だけ現れる場合、必要に応じてその管理ブロックの内容のみを、以下の正規ブロックに置き換えます。マーカーが不完全、重複、または不正な形式の場合は、推測で変更せず、ファイルを保持して曖昧さを報告します。
4. 管理ブロックが存在しない場合は、既存の同等な個人向けガイダンスセクションを探します。重複を避けるため、明確に判断できる場合はそのセクションをその場で更新します。それ以外の場合は、空行を挟んで正規ブロックを追記します。ルートの AGENTS.md が存在しない場合は作成します。
5. 無関係な指示には手を加えず、ファイル全体の再フォーマットは避けます。リポジトリの改行コード規則に従い、末尾に改行を入れます。
6. 結果を再読み込みし、差分を確認します。管理ブロックがちょうど1つあり、そのブロック内に3つのスキル参照がそれぞれ1回ずつ含まれていること、実装前にスキルの全文を読み、ワーカーにもその要件を伝える指示があることを確認します。再実行しても変更が発生しないことを確認します。作成、更新、または変更不要のいずれだったか、および利用できないスキルがあれば報告します。

正規の管理ブロック

マーカーを含め、以下のブロックをそのままコピーします。

## Personal engineering guidance

These skills are **standing constraints**, not alternatives to Matt Pocock's workflow. **Before implementing or changing code** (including through `/implement`, `/implement-spec`, `/tdd` or direct implementation), read the full installed content of all three:

- **`tech-preferences`** — Preferred technologies, exclusions and rules for existing architecture decisions.
- **`engineering-principles`** — Local reasoning, cohesive capabilities, clear boundaries and explicit dependencies.
- **`verifiable-trust`** — Independent verification, bounded authority and recoverability.

Apply their guidance throughout implementation and review. **Skill availability or a reference here does not mean the agent has read the skill.** Read each once per task, not at every test cycle; for trivial documentation-only work, apply guidance proportionately.

When delegating implementation, explicitly require each worker to read and apply these skills in its own context. Don't assume the parent's loaded skill content is inherited. If a skill is unavailable, say so rather than silently proceeding as if it were applied.

Documented project decisions take precedence over generic defaults. Flag meaningful deviations **before implementing**, recommend an approach and ask before changing established technology. When James chooses to retain a deviation, record the decision and don't reopen it without a request or material new evidence.

Source: [jamespegg/skills](https://github.com/jamespegg/skills).

境界

• 参照は簡潔に保ち、スキル本文を AGENTS.md にコピーしないでください。スキルリポジトリがその内容の正式な参照元です。
• プロジェクトのポリシー、既存の決定、ネストされた AGENTS.md ファイル、アプリケーションコード、ワークフロー、依存関係を保持します。
• 明示的に対象とされたリポジトリのみを変更します。これらの参照を除外するという文書化された選択を、対立について相談せずに覆してはいけません。
• AGENTS.md に記載しても、それだけでスキルがインストール、読み込み、または呼び出しを保証されるわけではありません。エージェント環境でスキルを検出できない場合は、明確に伝えてください。