AGENTS.md git:20260916.8e7653fA

Immutable. This exact content is served forever at /api/v1/blob/ec622f94aae39701.

# リポジトリ運用の指針

このリポジトリは、日本の就職活動と転職のための可搬な Agent Skills を管理する。キャリア相談、応募書類の添削、面接対策、企業研究、内定判断、おためし転職の体験・業務設計を対象とする。**公開リポジトリであり、求職者本人が自分の Claude にインストールして使う。`trial` カテゴリでは求人企業の採用担当者も対象とし、それぞれの立場で使うスキルを分ける。**

## 構成

- スキルは `skills/<category>/<skill-name>/SKILL.md` に置く。
- カテゴリは `career`、`documents`、`interview`、`research`、`offer`、`trial` のいずれか。定義は `scripts/_repo.py` の `CATEGORIES` だけにあるので、新設するときはそこを更新する。
- `scripts/`、`references/`、`assets/` は、そのスキルの手順が実際に必要とする場合だけ追加する。
- スキル同梱の `scripts/_common.py` は生成物であり、直接編集しない。入力検証とCLIの定型は `scripts/_common_source.py` だけを編集し、`python3 scripts/sync_common.py` で配り直す。スキルは単独でインストールされ、`skills/<category>/<skill-name>/` より上の階層は利用者の環境に届かないため、リポジトリ共通のモジュールを import できない。
- スキルを追加・改名・削除したら `.claude-plugin/marketplace.json`、READMEの収録スキル表、`skills.sh.json` の表示グループを更新する。検証スクリプトが3箇所すべての不一致を落とす。
- `PLACEHOLDER` や `TODO` が残った雛形をコミットしない。

## 執筆

- 名前は小文字とハイフンのみ、64文字以内、親ディレクトリ名と一致させる。
- `description` は「何をするか」と「いつ使うか」の両方を英語で書く（エージェントの検索用）。本文と参照資料は日本語で書く。
- `SKILL.md` は簡潔に保ち、条件分岐する詳細は `references/` に逃がす。
- `## 個人情報と権限境界` の節を置き、外部への行為を勝手に実行しないことを本文で約束する。検証スクリプトが節の有無と約束の記載を確認する。文面はスキルごとに変えてよく、注意すべき点が違うので揃えない。
- 手順を固定しすぎない。妥当なやり方が複数ある場面では、判断基準と確認できる成果物で書く。
- 制度・法令・給与相場・採用慣行など時点に依存する事実は、必要なときに一次情報を確認する。記憶で断定しない。

## 個人情報（最優先）

- 実在する求職者の応募書類、氏名、連絡先、学歴・職歴、選考状況をコミットしない。公開リポジトリなので、一度入れば取り消せない。例示は明らかに架空の内容にする。
- スキルは、作業に必要な範囲を超えた個人情報を収集・保存・出力しない設計にする。
- 検証スクリプトはメールアドレス、電話番号、12桁数字らしき文字列を検出して落とす。回避せず、内容を架空のものに置き換える。
- 開発中の添削作業の入出力は `private/` 以下（`.gitignore` 済み）か、リポジトリ外で扱う。
- スキル自体も、利用者が明示的に求めない限り、原稿や添削結果をファイルに残さない設計にする。

## 権限境界

すべてのスキルは、応募の送信、企業・採用担当者・エージェントへの連絡、求人サイトや ATS の登録・更新、面接日程の確定、退職手続きを自動実行してはならない。実行直前に、対象・内容・時期・影響を示して利用者の明示的な承認を得る。

`trial` の初版は相談・原稿作成・運用準備のみを行う。企業側から候補者への連絡も含め、掲載・応募・送信・日程確定などの外部操作は利用者本人が行う。

合否や通過率の予測、労働法・税務の専門的判断を断定的に示さない。

## 検証

スキルを変更したら次を実行する。

```bash
python3 scripts/validate_skills.py && python3 scripts/run_tests.py
```

`validate_skills.py` は配布した `_common.py` が単一ソースと一致するかも調べる。ズレたら `python3 scripts/sync_common.py` で配り直してコミットする。

新規または大幅に変更したスキルは、現実的な依頼で実際に動かし、見出しや文言だけでなく出力を確認する。