Wiki更新スキル
Wikiページの手書きの散文セクションを、コードベースの現在の状態を反映してリフレッシュします。自動生成されたメトリクス/データブロックはオーケストレーターが管理するため、決して触れてはいけません。
起動タイミング
- ユーザーが
/update-wikiと入力 — 散文を含むすべてのページを更新 - ユーザーが
/update-wiki Architectureと入力 —wiki/Architecture.mdのみ更新 - ユーザーが「wikiプローズのリフレッシュ」「オンボーディング記述の更新」「アーキテクチャドキュメントの書き直し」と発言
- システム設計の記述を変更する大規模なリファクタリング後
このスキルの機能(ステップバイステップ)
-
スコープを決定する。 ページ名の引数が指定された場合(例:
Architecture)、それをwiki/{PageName}.mdに解決します。それ以外の場合は、以下にリストアップされた散文を含むすべてのページをキューに入れます。 -
各対象ページに対して: a. Wikiページファイルを読み込みます。 b. すべての
<!-- claude:prose -->...<!-- claude:prose:end -->ブロックを特定します。 c. 以下のページレジストリにリストアップされた関連ソースファイルを読み込み、コンテキストを構築します。 d. マーカー間のコンテンツを、現在のコードベースを正確に反映するように書き換えます。全体的な構造(見出し、段落の順序)は、事実に反していない限り維持します。 e. 更新されたコンテンツをファイルに書き戻し、マーカーはそのまま正確に保持します。 -
生成ブロックには決して触れない。
<!-- generated:start -->...<!-- generated:end -->内のコンテンツは、バイト単位で同一に保たれなければなりません。これらのブロックはWikiオーケストレータースクリプトによって管理されます。 -
アーキテクチャ決定ログは完全にClaudeが管理する。
wiki/Architecture-Decision-Log.mdにはgeneratedブロックもclaude:proseマーカーもありません。Claudeがファイル全体を管理します。更新時には、最後に記録されたエントリ以降に行われたアーキテクチャ上の決定について、新しいADLエントリを追加します。既存のエントリは変更しないでください。 -
コミットのプロンプト。 すべてのページが更新されたら、ユーザーに次のように促します。
「Wikiプローズを更新しました。
/commitを実行して変更を保存し、Wikiリモートにプッシュしてください。」
散文を含むページとそのソースファイル
wiki/Architecture.md
プローズブロックの目的: システム設計の記述 — モジュールの責務、データフロー、静的サイトとLambdaチャットエージェントがどのように連携するかを説明します。
関連ソースファイル(読み取り対象):
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(ページ構造のコンテキスト用)projects.html(ページ構造のコンテキスト用)
wiki/Lambda-Chat-Agent.md
プローズブロックの目的: エージェント設計の根拠 — Lambdaアーキテクチャ、ナレッジベースのロード、プロンプトの構築、レスポンス処理について説明します。
関連ソースファイル(読み取り対象):
lambda/lambda_function.pylambda/context/(存在する場合はすべての.mdファイル)
wiki/Contributing.md
プローズブロックの目的: オンボーディング記述 — 新しいコントリビューター向けに開発ワークフロー、テスト哲学、プロジェクトの規約を説明します。
関連ソースファイル(読み取り対象):
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architecture-Decision-Log.md
特別な取り扱い: claude:prose マーカーはありません。Claudeがファイル全体を管理します。新しいADLエントリを追加するのみで、既存のエントリは変更しないでください。
関連ソースファイル(読み取り対象):
- 最近のgitログをレビューし、重要なアーキテクチャ変更を確認する
CLAUDE.md(現在のツールに関する決定事項)lambda/lambda_function.py(バックエンドの決定事項)
マーカー保持ルール
<!-- claude:prose -->
[Claudeがこのコンテンツを書き換えます]
<!-- claude:prose:end -->
<!-- generated:start -->
[絶対に触れてはいけません — オーケストレーター管理のデータ]
<!-- generated:end -->
- 開始マーカーと終了マーカーは、それぞれ独立した行に、変更せずに配置する必要があります。
- マーカーの内側に余分な空行を追加しないでください。
- マーカーを入れ子にしないでください。
警告
<!-- generated:start --> ... <!-- generated:end --> ブロックは決して変更しないでください。
これらのブロックには、Wikiオーケストレーターによって生成された自動生成のメトリクスとテーブルが含まれています。これらを変更すると、次回のオーケストレーター実行時にマージ競合が発生したり、あなたの変更が自動的に上書きされたりする可能性があります。