| name | add-drone |
| description | Borg drone（lib/ 配下の git submodule として管理される Emacs パッケージ）を追加する。「パッケージを導入して」「〜.el を追加して」「drone 追加」等のリクエストで使う。 |
新しい Emacs パッケージを Borg drone として追加する手順。
1. drone 名を決める
GitHub リポジトリ名ではなく、(require 'X) する Emacs の feature/package 名を使う。
この2つはしばしば異なる（例: リポジトリ akermu/emacs-libvterm → 名前は vterm、
リポジトリ xenodium/acp.el → 名前は acp）。迷ったらパッケージの主要な .el
ファイル末尾の (provide 'X) を確認する。
2. Epkg データベースで正規リポジトリを確認する
.claude/skills/add-drone/scripts/lookup.sh <name>
borg-assimilate が参照するのと同じ Epkg データベース（emacsmirror の
パッケージ定義、var/epkgs）から、正規の upstream URL・summary・必須依存を
引く。リポジトリ URL を Web 検索で探してはいけない。 同名の別パッケージや
fork を正規リポジトリと取り違える事故の元になる。
-
出力の url: をそのまま手順 3 に渡す
-
class が wiki / orphaned の場合は供給元の信頼性に注意が必要なので、
進める前にユーザーに確認する
-
必須依存に「未登録」があれば、その依存パッケージも本手順（1〜3）で追加する
-
見つからない場合は、まずデータベース自体を更新して再確認する:
.claude/skills/add-drone/scripts/update-epkgs.sh
（emacs --batch から epkg-update を実行し、パッケージリストと定義を
最新化する。）それでも見つからない新しすぎる・マイナーなパッケージに
限り、upstream リポジトリを自力で特定し、URL をユーザーに確認してから
手順 3 に進む。
3. スクリプトで追加する
.claude/skills/add-drone/scripts/add-drone.sh <name> <url>
内部で emacs --batch から borg-assimilate を呼ぶ。submodule の登録・
.gitmodules の整列・git dir の absorb・drone のビルドまで borg が一貫して
行うので、git submodule add を直接叩いてはいけない（--name の
付け忘れなど手作業の事故を防ぎ、borg の管理下で完結させるため）。
変更はステージされた状態で残る（コミットはしない）。
4. 設定ファイルに組み込む
- 他の設定モジュールが依存するライブラリとして使うだけなら、対応する
lisp/toncs-config-*.org の (require '...) が並ぶブロックに (require '<name>) を追記する。
- 独立した設定モジュールとして追加する場合は
lisp/toncs-config-<name>.org を新規作成し、
lisp/toncs-config.org に (toncs-config-prepare <name>) または
(toncs-config-configure <name> ...) を追加する。
5. ビルドして検証する
make lisp
ERROR_ON_WARN=t make test
（/verify スキルでも同等の検証ができる）
失敗時のやり直し方
assimilate 後にビルドや設定で失敗して最初からやり直したい場合は、
コミット前であれば以下でクリーンアップできる:
git submodule deinit -f lib/<name>
git rm -f lib/<name>
rm -rf .git/modules/lib/<name> .git/modules/<name>
git checkout -- .gitmodules
（.git/modules/ 側のパスは submodule 名によって lib/<name> か <name> のいずれかになるので
両方 rm しても無害）
