capture-learning

学びの記録

モデルを選ぶ前にブランチを選択してください。通常の記録作業は現在のロールで行います。独立したレビュアーに作業を振り分ける前に、shared/references/model-preview.md を使用し、承認済みのルートスナップショットを1つ紐付けてください。

後のエンジニアが見つけて活用できる、ソースに基づいた解決策のドキュメントを1つ作成してください。次に利用するのは、同じ問題に直面している人です。完了とは、ドキュメントが作成され、検証済みであり、未検証の主張を事実として記載していない状態です。

範囲

1回の実行で記録する学びは1つです。解決済みで、検証済みであり、自明ではない問題を説明する必要があります。証拠がこの基準を満たさない場合、内容の薄いドキュメントは作成しないでください。mode:headless では、理由を添えて Documentation skipped を返してください。対話型の実行では、解決した問題自体が不明確な場合に限り質問してください。

このスキルで作成するのは解決策のドキュメントのみです。既存の CONCEPTS.md に条件を満たす未掲載の用語がある場合は、その項目も更新してください。用語集の新規作成、プロジェクトの指示書の編集、無関係な記憶の検索は行わず、この実行をドキュメント監査に変えないでください。

ワークフロー

1. 関連する会話の証拠、変更されたソース、検証結果、近接する解決策のドキュメントを読みます。ソースと記録されたコマンドの実行結果は、セッション中の記憶より優先します。
2. references/schema.yaml と references/yaml-schema.md を読み、学びを分類して保存先を選びます。必要な本文の形式については references/resolution-template.md を読みます。
3. 同じ問題を扱う既存のドキュメントがないか確認します。問題、原因、解決策が実質的に一致する場合は更新し、それ以外の場合は新しいドキュメントを1つ作成します。更新時はパスを変更しないでください。
4. 動作に関するすべての主張を、file:line の参照を付けて現在のソースに基づかせます。マージ状態は検証済みの場合のみ記載してください。検証できない主張には情報源を明記するか、削除してください。
5. 既存の用語集に条件を満たす用語を追加する必要がある場合に限り、references/concepts-vocabulary.md を読みます。用語集の変更は、この学びの領域に限定してください。
6. このスキルのディレクトリから scripts/validate-frontmatter.py と scripts/validate-doc-claims.py を実行します。フラグの判定には references/grounding-validation.md を読みます。各フラグを修正、注釈、または確認してください。黙って無視してはいけません。バリデーターを実行できない場合は、文書化された手動チェックを実施し、その代替手段を報告してください。

ヘッドレスモード

mode:headless では、質問も任意の拡張も行いません。呼び出し元から検証済みの修正と、1つの学びを特定するのに十分なコンテキストが与えられている場合に限り使用してください。次のいずれかの終端行で終了してください。

Documentation complete

Documentation skipped

出力

モード、作成または更新したパス、分類、検証結果、用語集の結果、根拠に基づく制約事項を報告してください。最初に結果を示してください。ヘッドレスモードでドキュメントを作成しなかった場合は、その理由も報告してください。

受け入れ条件は明快です。後から読む人が問題を特定し、その解決策を適用できる状況を見分け、検証済みの解決策に従い、証拠と履歴を区別できることです。