Knowledge Log Output

Records gaps between AI inference and user understanding during work sessions, capturing design intentions, operational constraints, implicit rules, and undocumented project knowledge.

Sby Skills Guide Bot
DocumentationIntermediate1 views0 installs3/8/2026
Claude Code
knowledge-managementdocumentationgap-analysisrepo-structurework-logs

name: work-logs-knowledge-log description: ナレッジログを出力する allowed-tools: Read, Write, Grep, Glob

ナレッジ書き出し

ユーザーの求めに応じて対話セッション中で新しく認識したリポジトリの構造やルールについて書き出してください。 書き出し先は ~/.claude/knowledge/${repo_name}/${date time prefix}_$description.md とします。

date time prefix は以下のようにしてください。

  • date コマンドを利用してログ出力処理時の現在時刻を取得する
    • フォーマットは +%Y-%m-%d_%H-%M とする
  • タイムゾーンはAsia/Tokyoとする

記録すべき内容

AIがソースコードから推測した内容とユーザーの実際の認識のギャップが発生した場合、それを優先的に記録する。

具体的には:

  • プロジェクトの設計思想や意図でソースコードからは読み取れないもの
  • コード構造の背景にある理由
  • 運用上の制約や慣習
  • ビジネスロジックの前提条件
  • 暗黙のルールや例外的な扱い

記録の意義

これらのギャップはソースコードからの認知が困難な箇所を示しており、ドキュメント整備が必要な箇所の特定に繋がる。

Related skills