guide-updater

プロジェクトガイド更新ツール

bensz-collect-bugs との連携ルール

• ユーザー環境で、このスキルの設計上の欠陥に起因するバグが発生した場合は、まず bensz-collect-bugs を使い、規定に従って ~/.bensz-skills/bugs/ に記録してください。ユーザーのローカル環境にインストール済みの Claude Code / Codex のスキルのソースコードを直接変更することは、固く禁止されています。
• AI が回避策を使ってユーザーのタスクを続行できる場合は、まずバグを記録してから、現在のタスクを続けてください。
• ユーザーから「report bensz skills bugs」などの公開報告を明確に求められた場合は、ローカルの gh と bensz-collect-bugs を呼び出し、新たに追加されたバグのみを huangwb8/bensz-bugs にアップロードしてください。バグリポジトリ全体を pull / clone しないでください。

会話で新たに生まれた再利用可能な執筆上の知見を、リアルタイムでプロジェクトガイドファイルに反映し、用語の一貫性、構造の安定性、検証可能性、再現可能性を保ちます。

使用方法

このスキルを呼び出す際は、必ず引数にガイドファイルのパスを指定してください。

/guide-updater --guide-path <路径>

または自然言語で：

• 「プロジェクトガイドを更新する（パス：projects/MyProject/项目指南.md）」
• 「この内容をガイドファイル docs/写作指南.md に反映する」

前提条件

更新のたびに、次の項目を簡単に確認してください。

• 新たな ## レベルの見出しを追加しないでください。既存の節やリストに新しい要点を「組み込む」だけにしてください。
• 既存の見出しの文言、番号、順序を変更しないでください。「見栄えを整える」ために大量の内容を並べ替えないでください。
• 新しい内容は、原則として1つ、または少数の箇条書きにまとめ、近くの項目の書き方や文体に合わせてください。
• 事実や文献に関する内容は、検証可能な情報のみを記載してください。検証できない場合は「要検証」と明記し、詳細を捏造しないでください。

「原子的な知見」の抽出

• ユーザーの発言を、書き込める要点に分解してください。各要点には、主張またはルール、書き方を1つだけ含めてください。
• 各要点に、ガイドに記載する目的を1文で添えてください（例：用語の統一／査読での疑問の防止／再現可能性／リスク管理）。

反映先の選択

• さらに詳細な配置ルールが必要な場合は、まず skills/guide-updater/references/guide-structure-map.md を読んでから編集してください。
• 執筆原則／禁止事項／文型 → ## 写作哲学
• 用語、略語、大文字・小文字表記、中核概念の定義 → ## 命名与术语
• 手法の流れ、検証基準、評価指標 → ## 基本原理
• パラダイム上の位置づけ、比較の座標系、差別化のポイント → ## 文献综述与创新性
• 具体的な記述箇所（文書構造との対応） → ## 落点清单
• 査読者から想定される質問への回答方針 → ## 评审专家可能的问题及回答
• リスクと対策 → ## 研究风险
• 「検証可能な事実の根拠」（ソースコード、パラメーター、手順） → ## 附录

配置先が不明な場合は、将来の執筆の手戻りを最も減らせる場所を優先してください。それでも判断できない場合は、ファイルを変更する前に「執筆哲学／技術的な方針／リスク管理のうち、どの分類として残すのがよいですか？」とユーザーに確認してください。

最小限のパッチで書き込む

• 「差分パッチ」のみを適用してください。箇条書きを1～3件追加するか、既存の箇条書きの末尾に説明を1文加えてください。
• 長文の新しい節は作らないでください。知見が大きい場合は、複数の箇条書きに分解し、それぞれ対応する節に分けて配置してください。
• 既存の用語と一貫させてください（プロジェクト既存の用語集を参照）。

更新後の検証

• python skills/guide-updater/scripts/validate_guide.py <ガイドファイルのパス> を実行してください（または、重要な ## 見出しが残っていることを手動で確認してください）。
• 意図せず ## レベルの見出しを追加していないか、または「新たな構造」を持ち込んでいないかを検索してください。

リソース

ディレクトリ	用途
scripts/	项目指南.md の重要な構造と必須見出しが維持されているかを検証します
references/	構造の対応関係と配置ルールを記録し、配置先を何度も判断する手間を防ぎます