aifactory-drivelisted
Install: claude install-skill akkijp-oss/aifactory
# aifactory-drive — aifactory で開発を前に進める運転法(PJ 非依存)
aifactory 自体の仕様(workflow / kb / sandbox / ADR)は aifactory の repo が正本(このスキルはその `skills/aifactory-drive/` に同梱されている)。
本スキルは**その上で管理役がどう運転するか**(手順・判断表・機械化スクリプト)だけを固める。
**動かし方は 2 つ、スキルは 1 本**(ADR-0109 / ADR-0111):
| | 外部モード(手元の管理役) | 自動モード(制御系の運転役) |
|---|---|---|
| 誰が起こすか | 人が手元の Claude Code で起こす | 制御系の常駐が、PJ ごとに 1 つ起こして周を回し続ける |
| 見分け方 | `AIF_DRIVER` が無い | `AIF_DRIVER=auto`(Bash で `printf '%s\n' "${AIF_DRIVER:-external} ${AIF_PJ:-}"`) |
| 読む順 | この SKILL.md を §0 から | **先に §A を読む**。§0〜§9 はそのまま有効で、§A が「人が居ない・待たない」ための読み替えを定める |
**構成**(読む順): この SKILL.md(原則と 5 段の手順)→ 必要なときだけ `references/`:
| ファイル | 中身 | いつ読む |
|---|---|---|
| `references/landing.md` | PR 着地の手作業: mergeable の読み方・競合解決の作法・合流後にだけ出る赤・CI ログの読み方 | §6 で `pr-land.sh` が READY / MANUAL / CI 赤で止まったとき |
| `references/traps.md` | 判断の罠(実測で踏んだもの)と aifactory 機構の罠・退役済み一覧 | 迷ったとき・§9 で罠を足すとき |
| `references/tooling.md` | 道具の罠(zsh / bash 3.2 / BSD sed / git show / tsc / node_modules …) | スクリプトや手作業の結果が「空」「0 件」「赤」のとき、まず疑う |
| `references/project-setup.md` | 手元の設定(`~/.config/aifactory/drive.env`)・新 PJ の立ち上げ・`drive.conf` の各キーの意味・プール未構築の判定 | 初めて使うとき・drive.conf が無い PJ・drive.conf を書き換えるとき |
| `<AIF_PROJECTS_DIR>/<pj>/drive.conf` / `drive.md` | PJ 固有値(機械が読む)/ PJ 固有の補足(人と AI が読む)。どの 1 枚を読んだかは `aif-status.sh` が出す | PJ 確定直後(§0-0) |
★**SKILL.md と references に PJ 名を書かない**(オーナーの決定 2026-09-12「汎用的なスキルにしたい」)。
PJ 固有の事実(所要目安・台帳・CI の集合・デプロイ経路・その PJ で踏んだ罠)は `<pj>/drive.md` へ、
機械が読む値は `<pj>/drive.conf` へ。