setup-leandrocfe-skills

leandrocfe スキルのセットアップ

エンジニアリングスキルが前提とする、リポジトリごとの設定をひな形として作成します。

• イシュートラッカー — issue の保存先です（デフォルトは GitHub です。ローカルの Markdown もそのままサポートされています）
• トリアージラベル — トリアージの標準的な 5 つのロールに使用する文字列です
• ドメインドキュメント — CONTEXT.md と ADR の保存場所、およびそれらを読み込む際のルールです

これはスクリプトで処理する決定論的なスキルではなく、プロンプト駆動型のスキルです。調査し、見つかった内容を提示して、ユーザーに確認してから書き込みます。

プロセス

1. 調査

現在のリポジトリを確認し、初期状態を把握します。既存の内容を読み、決めつけないでください。

• git remote -v と .git/config — GitHub のリポジトリですか？どのリポジトリですか？
• リポジトリルートの AGENTS.md と CLAUDE.md — どちらかはありますか？すでに ## Agent skills セクションがあるファイルはありますか？
• リポジトリルートの CONTEXT.md と CONTEXT-MAP.md
• docs/adr/ と、src/*/docs/adr/ にあるすべてのディレクトリ
• docs/agents/ — このスキルを以前実行した際の出力はありますか？
• .scratch/ — ローカルの Markdown を使うイシュートラッカー規約がすでに使用されている兆候はありますか？
• triage スキルがインストールされていますか？（このスキルと並ぶ triage スキルのフォルダー、または利用可能なスキルの中に triage があるかどうか。）これにより、セクション B を実行するかどうかが決まります。
• モノレポの兆候 — pnpm-workspace.yaml、package.json の workspaces フィールド、または独自の src/ を持つ packages/* が存在するかどうかです。これらが存在するのは、真に大規模なマルチパッケージリポジトリの場合に限られます。これらがなければ、ほとんどのリポジトリと同様に、単一コンテキストです。

2. 調査結果を提示して質問する

何があり、何が不足しているかを要約します。その後、セクションを順番に進めます。1つのセクションにつき回答を1つ受け取ってから、次に進みます。

各セクションは推奨する回答から始め、ユーザーが一言で受け入れられるようにします。選択によって実質的に分岐する場合に限り、1行の説明を加えます。調査で解決済みのセクションは丸ごと省略します（triage がインストールされていない場合はセクション B、モノレポでない場合はセクション C）。

セクション A — Issue トラッカー。

説明：Issue トラッカーは、このリポジトリの issue を管理する場所です。to-tickets、triage、to-spec などのスキルはそこから読み書きするため、gh issue create を呼び出すのか、.scratch/ 配下に Markdown ファイルを書き込むのか、あるいは説明してもらった別のワークフローに従うのかを把握する必要があります。このリポジトリの作業を実際に追跡している場所を選んでください。

デフォルトの方針：これらのスキルは GitHub 向けに設計されています。git remote が GitHub を指している場合は、GitHub を提案します。git remote が GitLab（gitlab.com またはセルフホストのホスト）を指している場合は、GitLab を提案します。それ以外の場合（またはユーザーが希望する場合）は、次を提示します。

• GitHub — issue はリポジトリの GitHub Issues で管理します（CLI gh を使用）
• GitLab — issue はリポジトリの GitLab Issues で管理します（CLI glab を使用）
• ローカル Markdown — issue はこのリポジトリの .scratch/<feature>/ 配下にファイルとして保存します（個人プロジェクトやリモートのないリポジトリに適しています）
• その他（Jira、Linear など）— ワークフローを1段落で説明してもらいます。スキルは自由記述の文章として記録します

選択内容を docs/agents/issue-tracker.md に記録します。GitHub および GitLab のテンプレートには「PR をリクエストの受付場所にする」フラグがあり、デフォルトは オフ です。オフのままにし、このフラグについては話題にしないでください。外部の PR をトリアージ待ちキューに入れたいユーザーは、後からファイル内のフラグを切り替えられます。

セクション B — トリアージラベルの語彙。 スキル triage がインストールされていない場合（調査で判明しています）は、このセクション全体を省略します。インストールされていないスキルにラベルは不要です。

インストールされている場合は、質問を1つだけします。

デフォルトのトリアージラベルを使いますか？（推奨：はい）

デフォルトは5つの標準ロールで、ラベル文字列はそれぞれの名前と同じです：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。「はい」の場合は、そのまま記録します。ユーザーが「いいえ」と答えた場合に限り、既存のラベルを新たに重複作成せず適用するために、triage が使うラベルの上書きを集めます。通常は、トラッカーですでに別の名前（例：needs-triage に対して bug:triage）を使っていることが理由です。

セクション C — ドメインドキュメント。 デフォルトは 単一コンテキスト です。リポジトリのルートに CONTEXT.md 1つと docs/adr/ を置きます。これはほとんどのリポジトリに適しています。質問せずに書き込みます。

複数コンテキスト は、調査でモノレポの兆候が見つかった場合に限り提示します。リポジトリのルートに CONTEXT-MAP.md を置き、コンテキストごとの CONTEXT.md ファイルを参照させます。その場合は、希望するレイアウトを確認します。

3. 内容を確認して編集する

次の内容のドラフトをユーザーに提示します。

• 編集対象の CLAUDE.md または AGENTS.md に追加する ## Agent skills ブロック（選択ルールについてはステップ 4 を参照）
• docs/agents/issue-tracker.md、docs/agents/domain.md、docs/agents/triage-labels.md の内容（最後のファイルは triage がインストールされている場合のみ）

書き込む前に、ユーザーが編集できるようにします。

4. 作成

編集するファイルを選択します。

• CLAUDE.md が存在する場合は、編集します。
• そうでなく、AGENTS.md が存在する場合は、編集します。
• どちらも存在しない場合は、どちらを作成するかユーザーに尋ねます。代わりに選ぶことはしません。

CLAUDE.md がすでに存在する場合（またはその逆の場合）は、AGENTS.md を決して作成しないでください。既存のファイルを必ず編集します。

選択したファイルに ## Agent skills ブロックがすでに存在する場合は、重複して追加せず、その場で内容を更新します。周囲のセクションにあるユーザーの編集内容は上書きしないでください。

ブロック：

## Agent skills

### Issue tracker

[resumo de uma linha de onde issues são rastreadas]. Veja `docs/agents/issue-tracker.md`.

### Triage labels

[resumo de uma linha do vocabulário de labels]. Veja `docs/agents/triage-labels.md`.

### Domain docs

[resumo de uma linha do layout — "single-context" ou "multi-context"]. Veja `docs/agents/domain.md`.

triage がインストールされており、セクション B が実行された場合に限り、### Triage labels サブブロックを含め、docs/agents/triage-labels.md を作成します。該当しない場合は、どちらも省略します。

次に、このスキルのフォルダーにあるシードテンプレートを出発点として、ドキュメントファイルを作成します。

• issue-tracker-github.md — GitHub イシュートラッカー
• issue-tracker-gitlab.md — GitLab イシュートラッカー
• issue-tracker-local.md — ローカルの Markdown イシュートラッカー
• triage-labels.md — ラベルのマッピング（triage がインストールされている場合のみ）
• domain.md — ドメインドキュメントの利用者向けルールとレイアウト

「other」のイシュートラッカーの場合は、ユーザーの説明を使って docs/agents/issue-tracker.md を一から作成します。

5. 完了

セットアップが完了したことと、これらのファイルを読み込むようになった engineering skills をユーザーに伝えます。以降は docs/agents/*.md を直接編集でき、イシュートラッカーを変更する場合や、最初からやり直す場合にのみ、このスキルを再実行する必要があることも伝えます。