swain-help について
swain-helpは、swainスキル群のオンボーディング、個別質問への回答、リファレンス案内を行うスキルです。文脈から応答モードを選び、必要に応じて関連ドキュメントを案内します。
主な機能
- 01swainのオンボーディング案内
- 02文脈に応じた質問対応
- 03リファレンスやチートシートへの案内
- 04関連ドキュメントの提示
- 05簡潔な回答と例
活用シーン
- 01swainのセットアップ後の概要把握
- 02コマンドや成果物定義の確認
- 03swainワークフローの手順確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/swain-helpを入力して読み込まれたか確認します。
同梱ファイルreferences/quick-ref.mdreferences/workflows.md
詳細
swain-help
swain スキルエコシステムのコンテキストに応じたヘルプです。
モードの判定
コンテキストからモードを判定します。
| シグナル | モード |
|---|---|
| swain-init のフェーズ 4 から呼び出された場合、またはユーザーが「swain のセットアップだけして」／「init の後は何をすればいい？」と言った場合 | オンボーディング |
| ユーザーが具体的な質問をした場合（「どうすれば……？」「……とは？」「いつ……すべき？」） | 質問 |
| ユーザーがリファレンス、チートシート、コマンド、概要を求めた場合 | リファレンス |
オンボーディングモード
簡潔に案内し、ユーザーがインストールしたものを把握できるようにします。情報を詰め込みすぎないでください。初めて開発に取り組む人か、経験豊富なエンジニアかに応じて口調を調整します。
次の内容を提示します。
swain へようこそ。 仕組みを説明します。
全体像： Swain はプロジェクトのドキュメント成果物（仕様、エピック、ADR など）を管理し、実装作業を追跡します。セッション間で作業が抜け落ちることを防ぎます。
知っておくべきことは 3 つです。
/swainが入口です。 適切なサブスキルに自動で振り分けます。スキルを直接呼び出すこともできます（/swain-design、/swain-doなど）。実装の前に設計します。 何かを実装するときは、まず
/swainから仕様を作成します。Swain は「コードを書く前に計画する」ワークフローを徹底しており、実装を始める前に追跡対象のタスクを作成します。ヘルスチェックは自動です。
/swain-doctorはセッション開始時に実行され、ルーティングルールが設定されていることと.tickets/が正常であることを確認します。ユーザーが気にする必要はありません。よくある開始方法：
- 「新機能を計画したい」→ エピックまたは仕様を作成します
- 「X の仕様を書いて」→ エージェント仕様を作成します
- 「次に何に取り組めばいい？」→ タスクのバックログを確認します
- 「バグを登録して」→
type: bugの仕様を作成します- 「リリースしよう」→ バージョンを更新し、変更履歴を作成します
もっと知りたい場合は？ swain について何でも質問するか、
/swain help referenceと入力してチートシート全体を表示してください。
ここで終了します。ユーザーからの追加の質問を待ち、最初からすべてを一度に説明しないでください。
質問モード
swain に関する知識を使って、ユーザーの具体的な質問に答えます。このスキルに記載されている以上の詳細が必要な場合は、関連するリファレンスを読みます。
| トピック | 参照先 |
|---|---|
| 成果物の種類、フェーズ、関連性 | references/quick-ref.md — Artifacts セクション |
| コマンドと呼び出し方法 | references/quick-ref.md — Commands セクション |
| 手順ごとのウォークスルー | references/workflows.md |
| 成果物の定義とテンプレート | 兄弟スキル swain-design/references/<type>-definition.md |
| tk（チケット）CLI リファレンス | 兄弟スキル swain-do/references/tk-cheatsheet.md |
| トラブルシューティング | 兄弟スキル swain-design/references/troubleshooting.md |
回答のガイドライン：
- 簡潔にします。 質問に答え、リファレンス全体を一度に提示しないでください。
- 説明に役立つ場合は例を使います。 「
/swain create a spec for auth token rotationと入力します」など。 - 必要に応じて引き継ぎます。 ユーザーの質問が実際には何かを実行してほしいという依頼の場合（例：「仕様を作るにはどうすればいい？」に続いて「では作って」）、Skill ツールから関連スキルを直接呼び出します。実行内容を説明してください。「swain-design に引き継ぎます」など。
- 不明点は認めます。 記載されていない内容については、swain の機能を作り上げず、カバーされていないと伝えてください。
リファレンスモード
ユーザーが概要やチートシートを求めた場合は、references/quick-ref.md を読み、関連するセクションを提示します。「すべて」と求められた場合は、クイックリファレンス全体を提示しますが、情報量が多いことを伝えてください。
ワークフローのウォークスルーについては、references/workflows.md を読んでください。