Stats
Actions
Tags
From rite
rite Wiki layer — project-specific experiential knowledge persistence based on the LLM Wiki pattern (Karpathy). Use when the user asks to ingest review/fix/issue outcomes into Wiki pages, query accumulated experiential knowledge by keyword, lint the Wiki for contradictions, stale pages, orphans, missing concepts, broken references, and unregistered raw sources, or initialize the Wiki structure. Activates on "wiki", "ingest", "query", "lint", "経験則", "知識ページ", "Wiki 蓄積", "経験則を残す", "経験則を参照", "Wiki 検索", "Wiki Lint", "Wiki 品質", "矛盾チェック", "陳腐化", "孤児ページ", "欠落概念", "missing_concept", "壊れた相互参照", "broken_refs", "未登録 raw", "unregistered_raw", "wiki:init", "wiki:ingest", "wiki:query", "wiki:lint", "/rite:wiki:".
How this skill is triggered — by the user, by Claude, or both
Slash command
/rite:wikiThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
`rite-workflow` の経験則 Wiki 層に対する操作スキル。プロジェクト固有の経験則（実装パターン・レビュー指摘・修正パターン）を `.rite/wiki/` 配下に Markdown ページとして蓄積・参照・メンテナンスします。
rite-workflow の経験則 Wiki 層に対する操作スキル。プロジェクト固有の経験則（実装パターン・レビュー指摘・修正パターン）を .rite/wiki/ 配下に Markdown ページとして蓄積・参照・メンテナンスします。
/rite:wiki:init, /rite:wiki:ingest, /rite:wiki:query, /rite:wiki:lint.rite/wiki/ 配下に3層構造で経験則を管理します:
| 層 | 場所 | 所有者 | 性質 |
|---|---|---|---|
| Raw Sources | .rite/wiki/raw/{reviews,retrospectives,fixes}/ | rite ワークフロー（自動生成） | 不変の一次データ |
| Wiki Pages | .rite/wiki/pages/{patterns,heuristics,anti-patterns}/ | LLM（自動生成・更新） | 統合された加工済み知識 |
| Schema | .rite/wiki/SCHEMA.md | 人間 + LLM | 蓄積規約 |
詳細は docs/designs/experience-heuristics-persistence-layer.md を参照。
| コマンド | 説明 | 状態 |
|---|---|---|
/rite:wiki:init | Wiki 初期化（ディレクトリ・テンプレート・ブランチ） | 実装済み |
/rite:wiki:ingest | Raw Source から経験則を抽出・統合 | 実装済み |
/rite:wiki:query | 経験則の参照・コンテキスト注入 | 実装済み |
/rite:wiki:lint | Wiki の品質チェック（5 ブロッキング: 矛盾・陳腐化・孤児・欠落概念・壊れた相互参照 + 2 informational: 未登録 raw・説明的番号参照） | 実装済み |
/rite:wiki:ingest で Raw Source から経験則を抽出してページ本文（概要・詳細）を書く際は、説明目的の Issue/PR/commit 番号参照を本文に持ち込まない。Wiki は番号の受け皿ではなく、経験則そのものを自己完結した Why 散文で残す場である（Comment Best Practices SoT の適用スコープが Wiki ページを含む）。
知見の出所（provenance）は frontmatter の sources.ref（Raw Source ファイルパス、例: raw/reviews/pr-1234-...md）でのみ辿れるようにする。sources.ref は番号ではなくファイル参照であり、ingest の bookkeeping として維持する。本文の Why は番号なしで読み手が理解できる自己完結した記述にすること。番号を辿っても背景は得られず、辿る手間に見合わないため、背景は本文の散文に残す。
rite-config.yml の wiki セクションで制御:
opt-out ポリシー:
wiki:セクション自体を省略しても、Wiki 機能はデフォルトで有効として扱われます (wiki.enabled: true相当)。明示的に無効化したい場合のみenabled: falseを設定してください。本ポリシーはwiki.enabledのみに適用され、auto_query/auto_ingest等の他のキーは省略時に各キー個別のデフォルト (下記参照) が適用されます。
wiki:
enabled: true # opt-out (default true、セクション未指定時も有効扱い)
branch_strategy: "separate_branch" # separate_branch (推奨) or same_branch
branch_name: "wiki" # separate_branch 時のブランチ名
auto_ingest: true # Auto-ingest on review/fix/close
auto_query: true # Auto-query on start/review/fix/implement
auto_lint: true # Ingest 完了時の自動品質チェック (default true)
/rite:wiki:ingest の実行前に Raw Source を .rite/wiki/raw/{type}/ にステージングするヘルパー:
bash plugins/rite/hooks/wiki-ingest-trigger.sh \
--type reviews \
--source-ref pr-123 \
--content-file /tmp/review-result.md \
--pr-number 123 \
--title "Code review for PR #123"
詳細は wiki-ingest-trigger.sh --help を参照。
/rite:wiki:query の検索ロジック本体。他コマンドから直接呼び出して経験則をコンテキストに注入できます:
# --max-pages / --min-score はデフォルト値と同一の場合は省略可 (下記は最小呼び出し例)
bash plugins/rite/hooks/wiki-query-inject.sh \
--keywords "database,migration" \
--format compact
wiki.enabled: false や Wiki 未初期化のとき stdout を空にして exit 0（非ブロッキング）index.md をキーワードで検索し、タイトル・ドメイン・サマリーのマッチ数を集計--format full でページ本文（YAML frontmatter 除く）まで含めて出力詳細は wiki-query-inject.sh --help を参照。
Wiki 機能が期待通りに動作しない場合の診断手順。
raw source は /rite:pr:review（Phase 6.5.W.2）、/rite:pr:fix（Phase 4.6.W.2）、/rite:issue:close（Phase 4.4.W.2）で自動生成されます。raw が増えていない場合:
rite-config.yml で wiki.enabled: true になっているかwiki.auto_ingest: true になっているか（false だと raw 蓄積のトリガーが無効化される）git branch -a | grep wiki で wiki branch が存在するか。存在しない場合は /rite:wiki:init を実行するか git fetch origin wiki:wiki を実行### 📚 Wiki ingest 状況 セクションで SKIPPED や FAILED のカウントを確認[CONTEXT] WIKI_INGEST_SKIPPED=1 や WIKI_INGEST_FAILED=1 が ステップ 8.5 で検出・報告されているかraw source は蓄積されているが .rite/wiki/pages/ にページが生成されていない場合:
/rite:wiki:ingest を手動実行: ページ統合は /rite:wiki:ingest で実行されます。自動発火は /rite:pr:cleanup の ステップ 9 (Wiki Ingest 条件付き) で行われるため、cleanup を実行していない場合はページが生成されませんwiki-growth-check.sh の出力で pending 数を確認。ingested: false のまま残っている raw source が多い場合は ingest が実行されていません/rite:wiki:ingest 実行時に LLM 解析エラーが発生していないか確認.rite/wiki/SCHEMA.md が正しくセットアップされているか。/rite:wiki:lint で品質チェックを実行/rite:wiki:ingest の実行タイミング以下のタイミングで手動実行を推奨:
wiki-growth-check.sh が page stall を検出した場合: ==> Page stall detected の出力があった場合pending 数が raw 総数の 50% を超えている場合/rite:wiki:init 実行後、既存の raw source をページ化するため実行方法: /rite:wiki:ingest を Claude Code で呼び出す。
wiki-growth-check.sh の alarm の読み方wiki-growth-check.sh は /rite:lint から呼び出される総合 health check です。以下の alarm を出力します:
| alarm | 意味 | 対処 |
|---|---|---|
Wiki growth stall detected | wiki branch の最終 commit 以降に N 件以上の PR がマージされたが、raw source が追加されていない | Phase X.X.W が silent skip されている。review.md / fix.md / close.md の Wiki Phase 到達を確認 |
PR↔raw correspondence gap | 直近の merged PR に対応する raw source ファイル（pr-{number} 名）が wiki branch に存在しない | 個別 PR の Phase X.X.W 実行を確認。wiki-ingest-trigger.sh / wiki-ingest-commit.sh のログを確認 |
Page stall detected | raw source は存在するがページ数がゼロ、または pending raw が多い | /rite:wiki:ingest を手動実行。cleanup 経路での自動発火が機能しているか確認 |
閾値の調整は rite-config.yml の wiki.growth_check セクションで可能:
wiki:
growth_check:
threshold_prs: 5 # growth stall の閾値（デフォルト: 5）
pr_raw_threshold: 3 # PR↔raw 対応の閾値（デフォルト: 3）
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub asakaguchi/cc-rite-workflow --plugin rite