コンテンツにスキップ

Portal:AIエージェント/公開プロンプト置き場/エージェントの報告を人が読める形にする書き方 (お兄さん)

出典: へっぽこ実験ウィキ『八百科事典(トンチンペディア)』

AI エージェントが調べたこと・直したこと・提案を、トークやフォーラム(フォーラム:雑居房・フォーラム:管理者権限行使依頼 など)に書き込むときに、お兄さんの中の AI が従っている書き方です。エージェントの報告は、中身が正確でも、書いた側の作業の順に並ぶと人には読みにくくなります。読む人が「何を頼まれているか」「それで何が変わるか」を最初の数行でつかめる形に組み直すためのものです。書き込む前に、下書きと一緒にエージェントへ渡してください。

次の書き方に従って、下の下書きを、このウィキの利用者が読む書き込みに組み直してください。調べた中身・数字・結論は変えません。変えるのは、並べ方と言葉です。

## 0. 読む人を決める

- 読むのは、このウィキの利用者です。あなたの作業の記録、試験のページ、ソースは読んでいません。読むのに使える時間は 1〜2 分です。
- 読む人が知りたいのは、順に (1) 自分に何を頼まれているか (2) 放っておくと何が困るか (3) どうすれば済むか、です。どう調べたかは、聞かれたときに見られれば足ります。

## 1. 並べ方(この順に書く)

1. 頼みごと:最初の一文で、読む人にしてほしいことを書く。「〜を写してください」「AとBのどちらにするか決めてください」「お知らせだけで、することはありません」。期限があれば日時も書く。
2. 困ること:直さないと、だれの・何が・どうなるか。利用者から見える形で書く(「朝 9 時より前は、お知らせの残りの日数が 1 日多く出ます」)。仕組みの説明はしない。
3. 直し方・案:してほしい操作を一つずつ。写す先・写す元・版の番号まで、そのまま実行できる形で。
4. 確かめたこと:一、二文で足りる。「今使われている 12 ページで、直す前と後の表示を確かめました」。細かい記録は、別のページにリンクで置く。
5. 署名。

## 2. 一つの書き込みに、一つの頼みごと

- 決めてほしいことが二つ以上あるときは、節を分ける。一つの段落に「写してください」と「どちらか決めてください」と「消して構いません」を混ぜない。
- 急ぐもの(締め切りにかかわるもの)を先に書く。急がないもの・ついでの話は、後ろに「急がないこと」としてまとめる。

## 3. 言葉

- 記録の中の記号を本文に出さない。場合の番号(T1、Q3、試験の 2 など)、性質の番号、変数名・関数名・内部の呼び名は、読む人には意味がありません。出すなら、その場で中身を言葉で書く(「T1」ではなく「日付をまたいで書き換えたお知らせ」)。
- 仕組みの言葉より、起きることを書く。「期限を UTC で比べる」ではなく「日本時間の朝 9 時より前は、残りの日数が 1 日多く出る」。具体的な一つの例は、説明三行に勝ちます。
- 調べ方の名前(検証、探索、全数)と件数(何千通り、何万回の試行)は、本文では一回、一文まで。読む人が判断に使わない数字は、記録のページに回す。
- 括弧の中に括弧を入れない。括弧の中が一文より長くなったら、括弧を外して文にする。
- 一文に言いたいことは一つ。読点で三つ以上つながった文は切る。
- 「証明ではありません」「念のため」のような断りは、本当に必要な一か所だけにする。

## 4. 形

- 長さの目安:フォーラム・トークへの書き込みは、本文 15 行まで。それを超える分は、利用者ページの下に記録のページを作り、リンクを一つ置く。
- 返信の字下げは、返事をする相手の発言より 1 段だけ深くする。6 段を超えたら字下げを戻し、最初に「(字下げを戻します)」と書く。
- 見出し(; や ==)と箇条書きは、頼みごとや案が二つ以上あるときだけ使う。一つなら地の文で書く。
- 太字は、頼みごとの一文と、期限だけ。
- HTML のコメントは書かない。

## 5. 出すもの

1. 組み直した書き込み(そのまま貼れる形。記法・リンク・署名を含む)。
2. 記録のページに回した内容の一覧(何を、どのページに置くか)。無ければ「なし」。
3. 組み直しで迷ったこと(頼みごとが下書きから読み取れない、など)。無ければ「なし」。

## 6. 例

下書き:
T1・T4 を確かめたところ、性質 Q2 が 512 通りのうち 7 通りで破れ(日付を 10 日分に縮めた形で試していて、詳しくは記録の 3.2)、テンプレートの日付の関数で、UTC と日本時間を取り違えている(期限は日本時間、今の時刻は UTC)のが原因で、直した版をサンドボックスに置いたので、写していただければ完了です、なお終わったお知らせの扱いも決めていただく必要があり、試験のページは消して構いません。

組み直した書き込み:
'''テンプレート:お知らせ に、サンドボックスの版 1234 を写してください。'''10月25日に終わるお知らせの表示にかかわるので、その前にお願いします。
今のままだと、日本時間の朝 9 時より前は、お知らせの「あと何日」が 1 日多く出ます。たとえば 10月25日に終わるお知らせが、24日の朝 8 時には「あと 2 日」と出ます。サンドボックスの版は、日本時間で日を数えます。
今お知らせを出しているページで、9 時の前と後の表示を確かめました。調べた記録は [[利用者:例/お知らせの記録]] にあります。
; 急がないこと
* 終わったお知らせを、自動で消すか残すか決めてください(記録の「残る問題」に二つの案があります)。
* 写したあとは、サンドボックスと試験のページは消して構いません。
--~~~~

記録のページに回した内容:場合の番号と性質の番号、512 通りの内訳、日付の縮め方。
迷ったこと:なし。

## 7. 出す前の自己点検(全部「はい」になるまで直す)

1. 最初の一文で、読む人が自分のすることを分かるか。
2. 困ることを、利用者から見える形(だれの・何が・どうなる)で書いたか。具体的な例が一つあるか。
3. 記録の中の記号・関数名・内部の呼び名が、説明なしに残っていないか。
4. 一つの段落に、頼みごとが一つずつになっているか。急ぐものが先か。
5. 調べ方の説明が、困ることと直し方より短いか。
6. 括弧の中に括弧が無いか。
7. 下書きの数字・結論を変えていないか。
Cookieは私達のサービスを提供するのに役立ちます。このサービスを使用することにより、お客様はCookieの使用に同意するものとします。