ains-setup
Installation
SKILL.md
ほかの ains スキルが毎回聞かずに済むよう、前提を一度だけ決めて記録する。
1. 調べる
AGENTS.md、CLAUDE.mdと、その中の「Agent skills」節、既存の import。シンボリックリンクはtest -Lとリンク先、同一実体は[ AGENTS.md -ef CLAUDE.md ]で確かめる。リンク・import をたどるときは訪問済みの実体を記録し、循環をたどり続けない- 検査コマンド:package.json の scripts、Makefile、CI 設定、pyproject.toml など
- 仕様の置き場所:
openspec/、.specify/、specs/、docs/specs/、docs/changes/。機能単位の現行仕様が見つかれば、その置き場所も Agent skills 節に書く docs/ains/human-review-rulesの有無- 認証、課金、移行、基盤、CI のディレクトリ
2. 確認する
分かったことを示し、未決の項目だけ、ains-grilling の質問手順で推奨案を添えて聞き、回答を待つ。既存の設定・明示された承認は同じ範囲で保持し、調べて決まった項目や既に回答された判断は聞き直さない。既存の許可を下の既定で狭めたり広げたりしない。
以下は確認する話題の一覧で、同時に聞く質問ではない。構造化質問UIが使える場合はその上限内かつ最大5問、使えない場合は最も判断を進める未決事項を1つだけ聞いて回答を待つ。既に解決した内容は要約し、了承が必要ならその要約への承認質問を1つだけ行う。未決の質問を要約に混ぜてまとめて承認させない。
- 検査コマンド:見つけたコマンド。無ければ何で確かめるか
- 変更の置き場所:
docs/changes/。SDDの道具との役割の分け方は ains-spec の sdd-tools.md - 人の確認の規則:このスキルの隣の ains-review-gate にある
assets/human-review-rules.exampleを、1. で見つけたディレクトリに合わせて調整した案