w-docs について
w-docs は、コード変更に合わせてプロジェクト文書を整える Basilic のワークフロースキルです。適切な文書レイヤーの更新を促し、重複した構成の作成を避けます。
主な機能
- 01該当する文書トピックの特定
- 02正式な MDX 説明の更新
- 03設定やスクリプト変更時の README 修正
- 04制約変更時のエージェントルール更新
- 05最小限のファイル移動リストの提案
活用シーン
- 01機能やアーキテクチャ変更の記録
- 02スクリプト変更後のセットアップ説明更新
- 03関連文書ファイルの移動計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ blockmatic-icebox/ basilic-skills --skill w-docsインストール後、Claude Code で/w-docsを入力して読み込まれたか確認します。
詳細
現在のコードまたは機能について文書化します。利用側のリポジトリのドキュメントおよび README のルールに従ってください。依頼されない限り、コミットしないでください。長期的に維持する情報設計は既存の MDX に記載し、別のサイトマップを新たに作成しないでください。
変更を担当するレイヤーに記載してください。
| レイヤー | 役割 | 更新するタイミング |
|---|---|---|
技術ドキュメント(AGENTS.md に記載のパス) | アーキテクチャ、ADR、ハウツー | 挙動、アーキテクチャ、コマンド、規約、またはワークフローが変わったとき |
| エージェントルール | 簡潔な制約 | エージェントが遵守すべき規約が変わったとき |
| 最も近い README | このアプリ/パッケージの実行方法。リンクのみ | スクリプト、セットアップ、またはパッケージの用途が変わったとき |
コードの内容が誤解を招く場合に限り、インラインコメントを追加してください。MDX をルールや README にコピーしないでください。MDX を @ で添付しないでください。
- 該当するドキュメントのセクションを特定し、次に既存のトピックページを特定します(適切なページがない場合に限り、新しいページを作成します)。
- 正式な説明に変更があった場合は、MDX を作成または修正します。
- README は実行方法/セットアップ/スクリプトに関する場合に限り修正し、MDX へのリンクを記載します。
- 制約が変わった場合に限り、glob に一致するルールを修正します。
- 機械的なファイル移動やドキュメント移動の場合は、関連ファイルごとにグループ化した、移動元/移動先の最小限の一覧を提案します。グループ内ではフォルダー名の接頭辞を省略します。ユーザーがパスを指定した場合に限り保存します。実装も依頼されていない限り、ファイルを移動しないでください。
コメント
Markdown 対応