kulikala/wakariyasu

explain-clearly

エージェントが自分で作成した直前の返答や、返答の中の語・説明が分からないと言われたときに使う。「分かりやすく」「つまり?」「簡潔に」「どういうこと?」「言い換えると?」「平易に言うと?」「小学生でも分かるように」、返答に出た語について「〜とは?」、返答で並べたものについて「〜と〜の違いは?」と聞かれたときに当たる。ほかの言語で同じ意味のことを聞かれたときも当たる。作業の経緯を知らない人に通じる言葉で言い直し、言われた言葉から、短くまとめるか前提を足すかを選ぶ。返答と関係の無い一般の質問(「REST とは?」)…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/kulikala/wakariyasu --skill explain-clearly

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

スキルの目的

ユーザーが分からなかったものを、ユーザーが分かる言葉で言い直す。中身は変えず、伝え方を変える。

分からなかった点の特定

言い直す前に、ユーザーが引っかかったものを判断する。

  • 語(「〜とは?」): 作業の中で使い続けた呼び名や、ツールの出力に出てきた語であることが多い。
  • つながり(「どういうこと?」): 1つずつの文は読めても、何が何の理由なのか、何と何を比べているのかが追えていない。
  • 結論(「つまり?」): 説明は読めたが、自分にとって何を意味するのか、何を判断すればよいのかが分からない。
  • 違い(「〜と〜の違いは?」): 並んだものの、どこが違い、選ぶと何が変わるのかが分からない。
  • 全体(「分かりやすく」): 上のどれか1つに絞れない。直前の返答を、経緯を知らない人の視点で頭から読み、引っかかる箇所をすべて挙げる。

ユーザーの言葉から上のどれに当たるかを判断できないときは、直前の返答から、ユーザーがセッションの中で使っていない語と、何を示すかが語を含む文の中に記載されていない語を探し、探した語から言い直す。

説明の長さの選択

言われた言葉向き
「つまり?」「簡潔に」「一言で」短くする。結論を1〜3文で言い、必要な条件だけを残す
「どういうこと?」「小学生でも分かるように」「平易に」前提を足す。結論の前に、知らないと読めない前提を短く置く
「言い換えると?」「分かりやすく」長さは大きく変えない。語と文の組み立てを替える
「〜とは?」語の意味を1〜2文で言い、今の話の中で何を示しているかを添える
「〜と〜の違いは?」違う点だけを並べる。選ぶと何が起きるかまで記載する

表に無い言い方は、意味の近い行として扱う。

言い直しの方法

  • 結論を先に述べる。
  • 作業の中で付けた呼び名・略称・ファイルの中の語は、ユーザーが使った言葉か、一般に通じる言葉に置き換える。正確さが必要な固有名(ファイル名・コマンド名)は残し、何のためのものかを添える。
  • 元の説明に無い因果やつながりを足さない。別々に決定した2つのことを、理由を示す接続でつながない。つながりが分からなければ、別々の文で記述する。
  • 例えを使うなら1つだけにし、例えのどこが本題のどこに当たるかを記載する。
  • 前の説明で記載した条件・例外・確かさ(推定か、確かめたか)を、短くするために落とさない。落とすなら、落としたことを記載する。
  • 言い直し自体から始める。前の説明のどこが分かりにくかったかの説明や、謝りの前置きは要らない。

書き方は規則「ユーザーへの返答は、経緯を追っていない人が読んで分かるように記述する」(スキル writing-rules の rules/writing-to-user.md)に従う。

送信前の確認

  • 言い直した文を、直前の返答を読んでいない人の視点で、頭から順に読む。前に戻って読み直した箇所があれば修正する。
  • 規則「記述した文章は、渡す前に整える」(スキル writing-rules の rules/polishing.md)に沿って整える。表記で迷ったら、「日本語の表記の選び方」(スキル writing-rules の references/styles.md)を読む。
같은 저장소의 Skills

더 많은 Skills

모든 Skills
kulikala
커뮤니티

check-terms

日本語の文書から、日本語では使わない言い回し(翻訳調の語や、作業の中で生まれた造語)と、文脈によっては別の語のほうが自然な言い回しを、一覧で探して替える。「言い回しを確かめて」「使わない語が無いか見て」と言われたときに使う。言われなくても、エージェントがファイルに記述した日本語の文書を人に渡す前に使う。wakariyasu の規則とほかのスキルも、言い回しの一覧と探すスクリプトをこのスキルのフォルダから使う。

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 9일
kulikala
커뮤니티

session-status

「現状は?」「現在のステータスは?」「今何してる?」「どこまで進んだ?」「何が残ってる?」と聞かれたとき(ほかの言語で同じ意味のことを聞かれたときも)に使う。聞かれなくても、複数のタスクにまたがる作業が一区切りついて報告するとき、ユーザーに判断を求めて手を止めるとき、長い作業の途中経過を伝えるときに使う。今のセッションの状況を、現在のゴール・直近の指示・タスクの一覧(状態つき)・直近のステータスに分け、ユーザーに判断してもらうことがあれば番号つきの問いかけを添え、要点を絞って、背景と意図まで分かるように答える。

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 9일
kulikala
커뮤니티

show-changes

変更前と変更後の差分を、1つ以上の対象(git のリポジトリの2つのコミット、2つのフォルダやファイル、既にある unified diff)にまたがって1つの HTML のページにし、人がブラウザで変更の全体と中身を確かめられるようにする。「差分を見せて」「変更を見せて」「変更内容を表示して」「変更をページにして」「レビュー用に差分をまとめて」と頼まれたとき、レビュー・承認・マージ・差し替えの前に人へ変更を見せるとき、複数のリポジトリやフォルダにまたがる変更をまとめて見せるときに使う。エージェントがファイルを変更する作業を終えて、何を変えたかをユーザーに見せるときは、頼まれなくても使う。エージェントが自分で差分を読むだけのときと、変更の良し悪しを点検するときには使わない。

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 9일
kulikala
커뮤니티

summarize-session

今のセッションで扱った内容を、セッションに居なかった人やエージェントが後から読んで使える文書にまとめる。「このセッションをまとめて」「判明したことをまとめて」「指摘を抜き出して」と言われたときと、ほかの言語で同じ意味のことを言われたときに使う。依頼からユーザーが求めているものを推定し、頼まれた事柄を文書として構造化するドキュメント出力・分かったことを汎用的な知見として構成する知見抽出・ユーザーの指摘を指摘事項と意図と背景と対応方針で整理する指摘抽出・作業の記録を残すログ出力のうち、該当するモードの方針で文書を作る。複数のモードに該当すれば、モードごとに文書を分ける。どのモードにも該当しなければ、各モードの方針を参考に構成を組み立てる。返答の中で短く要約するだけのときには使わない。セッションの進み具合を聞かれたときは session-status を、直前の返答が分からないと言われたときは explain-clearly を使う。

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 9일