to-wiki について
ユーザーが呼び出し、明示的に確認された永続的なプロジェクト知識をWikiに記録するスキルです。リポジトリの根拠を検証し、概念やADRを管理し、破壊的な変更前には処理を中断します。
主な機能
- 01確認済み知識の収集
- 02リポジトリ根拠との照合
- 03概念とADRの公開
- 04インデックスとメタデータの更新
- 05破壊的変更前の一時停止
活用シーン
- 01確定したアーキテクチャ決定の記録
- 02プロジェクト用語の追加や修正
- 03確認済みの動作や指針の公開
- 04未確認の変更のバックログへの振り分け
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ beeltec/ skills --skill to-wikiインストール後、Claude Code で/to-wikiを入力して読み込まれたか確認します。
詳細
Wiki へ
このスキルを呼び出すことは、この会話で明示的に確認された永続的な知識を公開することに対する、オーナーの恒常的な承認です。対象には、議論やコードベースの調査から得られた、概念の作成、修正または拡張、すでに有効な決定の ADR 公開、ユビキタス言語の追加と修正、派生するインデックス、リンク、メタデータ、ログの変更が含まれます。これらの追加および修正のトランザクションに限り、$wiki のトランザクションごとの一時停止に優先します。それ以外はすべて $wiki に従ってください。既存の概念の非推奨化や削除、既存 ADR の置き換え、docs/backlog の変更、提案の形式をとるコンテンツの公開、未確認の知識への変更は許可されません。
ステップ 3 の項目ごとの候補と重大なブロッカーでのみ一時停止し、それ以外は最後まで実行して報告してください。ユーザーが呼び出した場合のみ使用できます。ただし、$to-product は例外で、その自律的な契約ではステップ 3 の一時停止も自動承認されます。概念の非推奨化、概念の削除、ADR の置き換えについては、個別に報告してください。
ワークフロー
- 候補を収集する — 用語やアーキテクチャ上の決定として確認されたものを含め、この会話でユーザーが明示的に確認した結論をすべて列挙します。それぞれを
$wikiの知識適格性に照らして分類し、現在のプライマリーブランチで受け入れ済みの状態を示す永続的な事実、動作、ルール、決定、ガイダンスのみを採用します。確認済みの決定すべてに ADR の重要性テストを適用し、該当するものには ADR 候補として印を付けます。変更の要望、目標仕様、提案された作業がリリースされた時点でのみ有効になる決定、未解決の質問は却下し、報告で$backlogに振り分けます。公開は決して行いません。 - 検証して公開する — 採用した候補ごとに、依存関係の順に
$wikiに従ってリポジトリの証拠と照合します。正規の所有概念の下に配置するか、まとまりのある範囲で最小の概念を作成します。$wikiで検証済みの永続的なトランザクションとして求められるインデックス、リンク、メタデータ、ログのエントリーを追加して編集を適用し、この呼び出しを記録済みの承認として引用します。$wikiが認める場合は、関連する編集をまとめてトランザクションを共有します。 - 項目ごとの一時停止 — 確認済みの結論に、既存の概念の非推奨化または削除、あるいは既存 ADR の置き換えが必要な場合は、そのトランザクションのみを個別に提示します。証拠、参照元、ADR の組み合わせの両方向、影響を含め、項目ごとに明示的な承認を得た場合のみ適用します。
$to-productの自律的な契約を除き、恒常的な承認に決して含めないでください。同契約では個別に承認し、個別にログへ記録します。 - 報告する — 公開した概念、割り当てられた
ADR-NNNを含む ADR、トランザクションとコミットハッシュを付記した用語を報告します。却下した候補とその$backlogへの振り分け、破壊的な決定や置き換えの決定とその結果、最後に実行したnode scripts/validate-project.mjsの結果も報告します。
バリデーターの失敗、確認済みの結論と矛盾する証拠、現在の受け入れ状態が確立されていないことはブロッカーです。その候補は公開せず、コミット済みのトランザクションは維持して報告してください。受け入れを決して強行してはなりません。
報告は Next step: で締めくくります。結果に応じた、コピーして貼り付けられるコマンドを1つ記載してください。却下した変更要望の候補がある場合は、それらを指定した $to-backlog を使用します。それ以外の場合、最上位の準備完了済み WORK-NNN があれば、それを指定した $implement を使用します。該当するものがなければ省略します。