--- name: summarize-session description: 今のセッションで扱った内容を、セッションに居なかった人やエージェントが後から読んで使える文書にまとめる。「このセッションをまとめて」「判明したことをまとめて」「指摘を抜き出して」と言われたときと、ほかの言語で同じ意味のことを言われたときに使う。依頼からユーザーが求めているものを推定し、頼まれた事柄を文書として構造化するドキュメント出力・分かったことを汎用的な知見として構成する知見抽出・ユーザーの指摘を指摘事項と意図と背景と対応方針で整理する指摘抽出・作業の記録を残すログ出力のうち、該当するモードの方針で文書を作る。複数のモードに該当すれば、モードごとに文書を分ける。どのモードにも該当しなければ、各モードの方針を参考に構成を組み立てる。返答の中で短く要約するだけのときには使わない。セッションの進み具合を聞かれたときは session-status を、直前の返答が分からないと言われたときは explain-clearly を使う。 --- # スキルの目的 セッションで検討したこと・分かったこと・受けた指摘は、セッションが終わると会話の記録の中に埋もれる。このスキルはセッションの中身を、セッションを追っていない人が文書だけを読んで使える形にまとめ、セッションの外へ渡せるようにする。 文書の読み手はセッションに居なかった人とエージェントだ。依頼が読み手や渡す先を示していれば、その読み手に合わせる。 ## モードの選択 依頼から、ユーザーが何を求めているかを推定する。依頼の言葉だけで決まらないときは、依頼の前後の会話と、セッションで扱った中身から推定する。求めているものが次のモードのどれかに該当すれば、そのモードの方針に従って文書を作る。 | モード | ユーザーが求めているもの | |---|---| | ドキュメント出力 | セッションで検討・決定した事柄を、文書として構造化したもの | | 知見抽出 | セッションで確認した事実から導いた、セッションの外でも通用する理解 | | 指摘抽出 | ユーザーがエージェントに出した指摘と、指摘ごとの対応方針 | | ログ出力 | エージェントが行った作業の記録 | - 求めているものが複数のモードに該当するときは、モードごとに別の文書にする。モードごとに読み手と使い道が違い、1つにまとめると、どの読み手にも余計な章が混ざるためだ。 - どのモードにも該当しないときは、ユーザーが求めているものに合う構成を自分で組み立てる。組み立てるときは、各モードの方針のうち、求めているものに合う部分を参考にする。 - 依頼がセッションの一部に対象を絞っていれば、その対象に絞る。絞っていなければ、セッション全体のゴールを対象にする。 ## 時間で変わるかの判定 文書を作り始める前に、ユーザーの依頼から、文書が次のどちらかを判定する。読み手が文書を読むのはセッションより後なので、時間が経つと変わる値が混ざった文書は、読んだ時点では誤りになる。 - 時間が経っても変わらない中身の文書:目的・方針・決定とその理由・知見のように、セッションが終わったあとも成り立つ中身だけで構成する。その時点の状態(進み具合・件数や大きさの現在の値・公開済みのバージョン)と作業記録は記述しない。ユーザーが依頼で作業記録を求めたときだけ、作業記録を記載する。求められても文書の種類は変えず、作業記録は別の節にするか引用の形にして、作業記録の部分と中身の部分を読み手が区別できるようにする。 - 変わる状態を含む文書:その時点の状態や作業の経過を残すことが目的の文書だ。作業記録も記述する。状態にはいつの時点の状態かを添える。 ドキュメント出力・知見抽出・指摘抽出は、依頼が文書の目的として状態を残すことを求めていなければ、時間が経っても変わらない中身の文書にする。ログ出力は変わる状態を含む文書にする。 作業記録は文書に書く中身の種類を指す。エージェントが何をしたか、何をどの環境(どの PC・どの設定)で何回試したか、という中身だ。時系列をやめて中身の軸で並べ替えても、中身がこの種類なら作業記録のままだ。知見や決定が成り立つ範囲(対象のツールや前提の条件)は、知見や決定の一部であり、作業記録ではない。 ## 文書の根拠にする記録 文書の中身は確認できる記録から取る。会話の記録・変更したファイル・コミット・コマンドの出力を見て、セッションを終えた時点の事実に合わせる。 - 会話が要約されて続いているセッションでは、要約は細部と言い回しを落としている。元の会話の記録のファイルを読める環境なら、その記録を読む。記録が大きければ、ユーザーの発言と、その直前のエージェントの提案や問いかけを組にして読む。ユーザーの承認や選択は、何を承認したのかが直前の提案を読まないと分からないためだ。指摘抽出では、指摘と指示の区別や、指摘が繰り返されたかが要約から読み取れないので、とくに元の記録から取る。 - 元の記録を読めないときは、会話に残っている要約と、ファイル・コミットから取る。 - 途中で取り消した案・誤りだと分かった事実・ユーザーの後の指示で置き換わった方針は、セッションを終えた時点で有効なものを採る。有効なものを説明するのに取り消した経緯が必要なときだけ、取り消したことを決定の理由の一部として記載する。取り消すまでに試した順序は記載しない。 - 記録から確認できないことは記載しない。推し量るなら、推定だと分かる形で記載する。 - 持ち主が外部への提供を認めていない情報は、文書に転記せず、あることだけを記載する。文書はセッションの外へ渡るためだ。ユーザーの言葉を引用するときも、その情報の部分だけを伏せる。 ## 文書の組み立て どのモードでも、読み手が読み始めてすぐに、何についての文書かを読み取れるようにする。対象は対象そのものを語る文で示し、文書が自分を説明する文にはしない。何から文書を作ったかは、読み手に必要なときだけ、本文とは別の節で記述する。 時間が経っても変わらない中身の文書には、ユーザーが求めたときのほかは作業記録を記述しない。読み手が知りたいのは、エージェントが何をしたかではなく、何を目指し、何を決定し、何に留意するかだからだ。 - 全体を時系列ではなく、中身の軸で章と節に分ける。 - 見出しは、見出しだけを読んでも節の中身が分かる言い方にする。分類の名前だけの見出しは、読み手が節を開くまで中身が分からないので避ける。 - 全体の目的と方針の骨子と意図が、細部より先に読み取れるようにする。細部は、セッションの外の読み手が細部を知らないと判断や行動を誤るときだけ残す。 - 量は、読み手が目的と方針を読み取るのに必要な分にする。項目が増えたら、上位の方針でまとめ、細かい項目を並べ続けない。 ### ドキュメント出力 ドキュメント出力でいちばん大事なのは、文書として構造化することだ。事柄を並べただけの一覧では、読み手は事柄どうしがどう関わり、どれが上位の方針かを自分で組み立て直すことになる。 何を文書にするかは、依頼からユーザーが求めているものを推定して判断する。依頼が名指した事柄と、その事柄についてセッションで検討・決定したことが対象になる。 - 対象を、個々の作業や発言の層から、目的・方針・決定とその理由の層へ、抽象の階層を上げる。 - 文書全体の目的を念頭に置き、目的を支える部分を章に、章を支える事柄を節に分けて、階層を作る。各章と各節が、文書全体の目的のどこを担うかが読み取れるようにする。 - 部分どうしの関係を記載し、読み手が前提になる部分から順に理解できるように構成する。 - 決定したことと、決定していないことは分けて記述する。読み手がどこから先を自分で判断すればよいかが分かる。決定していないことは、セッションで質問として挙がったまま答えの出ていないものに限り、何が未決定で、決定に何が必要かを対象の状態として記述する。 - 決定には理由を添える。理由が分かれば、読み手は記載していない場面でも同じ方針で判断できる。理由に検証の結果が必要なときは、結果から言えることだけを書き、試した手順・回数・環境は書かない。 - 手順は、特定のバージョンの値でなく一般の形で書く。読み手は、文書を読んだ時点のバージョンに当てはめて手順を使う。 ### 知見抽出 知見は、セッションの外でも通用する、汎用的な理解だ。読み手が次に同じ種類の環境・ツール・課題に直面したとき、判断を誤らずに済むことを目的に、事実から抽象の階層を上げて構成する。 書き手は、いつ何が分かったかを報告したくなるが、読み手に必要なのは、何が言えるかだ。エージェントの作業の記録は知見の文書から除く。知見を理解するのに背景が必要なときだけ、背景を短く添える。 - 個々の事実をそこから言える性質・傾向・因果・前提にまとめ、知見を主語にした節を立てる。事実は知見の根拠として必要な分だけ記述する。 - 抽象の階層を上げられず、汎用的に言えないまま細部の列挙にとどまる事柄は、知見から落とす。 - 知見どうしの関係が分かるように構成する。ある知見が別の知見を前提にしているなら、読み手が前提の知見から順に理解できるようにする。 - 知見ごとに、知見が成り立つ範囲(対象のツールや前提の条件)を記述し、読み手の判断にどう影響するかを記述する。 - 推し量った知見は、推定だと分かる形で記述する。知見の確かさは、確認した知見か推定かの区別で示し、確かめた回数・方法・確かめていない理由では示さない。回数や方法は作業記録だからだ。 - 知見を確かめた手順(実験の進め方)と、確認していないことの一覧は記述しない。手順は作業記録で、確認していないことは作業の残りであり、どちらも知見ではない。ユーザーが求めたときだけ、記録として記載する。 ### 指摘抽出 指摘は、エージェントの振る舞いや成果物が、ユーザーの期待とずれていることの表明だ。指示はこれから何をするかの依頼で、指摘とは違う。指示は作業の内容を決め、指摘は振る舞いの方針を変える。指示を指摘として並べると、一度きりの作業の依頼が、続けて守る方針に見えてしまうので混在させない。 指摘された事実を並べるのではなく、指摘から、ユーザーが何を目指しているかを読み取り、目的に向けた方針として整理する。読み手が、同じ指摘を受ける前に振る舞いを変えられることが目的だ。 - 繰り返された指摘や、同じ目的から出た指摘は、一つ一つを並べず、共通する目的に引き上げて1つの指摘にまとめる。繰り返されたこと自体は、その方針が重いことの根拠になる。 - まとめた指摘ごとに、指摘事項・意図・背景と対象・対応方針の4つを記述する。指摘事項は、何がユーザーの期待とずれていたか。意図は、ユーザーが指摘で目指していること。背景と対象は、指摘がどんな場面で、エージェントのどの振る舞いや成果物に向けられたか。対応方針は、エージェントがどう振る舞うか。読み手が、指摘の意図と対応を組にして読めるように、4つとも省かない。 - 指摘が多いときは、意図が近い指摘を、共通して重視している観点ごとの章にまとめる。観点はそのセッションの指摘から立てる。 - ユーザーの言葉は意図の根拠として必要なときだけ短く引用する。引用は書き換えない。 - ユーザーが承認した進め方も、続けてよい方針として含める。 - 同じ論点で指摘が変わったときは、セッションを終えた時点で有効な方針を採る。 ### ログ出力 ログ出力は作業自体を記録する文書なので、時系列で並べてよい。一連の作業を節にまとめ、節ごとに、その作業が何のためのもので、結果どうなったかが先に読み取れるようにする。何のための作業かは節ごとに決まった書き出しで述べるのではなく、作業の中身に合わせた文で記述する。途中で失敗した試みや、分からなかったことも残す。残っている作業と、ユーザーの判断を待っていることは、記録を読み終えた読み手が、次に何が必要かを分かるように記述する。 ## 仕上げ 表記の種類は、スキル `writing-rules` の `references/styles.md` にある「日本語の表記の選び方」から選択する。ログ出力のほかは、表記の種類のどれにも該当しなければ技術記事の種類にする。仕上げは、スキル `writing-rules` の `rules/writing-documents.md` にある規則「エージェントが記述する文書は、文書だけで通じるように記述する」の「書き終えたら」の節に従う。ログ出力は、規則 `writing-documents` の表で作業記録・進行記録として扱う。 文書を提示するときの返答には、選択したモードと、時間で変わるかの判定の結果を記載する。どのモードにも該当せずに構成を組み立てたときは、そのことと組み立てた構成を記載する。根拠にした記録も記載する。元の会話の記録を読んだのか、要約から取ったのかをユーザーが区別できるようにするためだ。