kulikala/wakariyasu

session-status

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

소스 보기

사용 방법

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

시작 전 확인

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

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

スキルの目的

ユーザーが答えを読めば、自分が何を目指していて、作業がどこまで進み、判断してもらうことがあれば何を判断してもらうのかが分かるように記述する。状況は、ファイル・コマンドの出力・タスクの状態のように確かめられるものを確かめ、今の事実に合わせて記述する。

伝え方の方針

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

回答の構成

次の順番で記述する。記載することが無いセクションは、見出しごと省く。

markdown
## 現在のゴール

<セッション全体で、何を、何のためにしているか>

## 直近の指示

<最後の依頼で取り組んでいること:何を、何のために>

## タスク

| # | タスク | 状態 | 背景・補足 |
|---|---|---|---|
| 1 | … | … | … |

## 直近のステータス

<今どこにいるか。直前に何が終わり、何が動いていて、次に何をするか>

ユーザーに判断してもらうことがあるときは、最後に「## 判断を求めていること」の節を足し、 「判断の問いかけの書き方」(スキル writing-rules の references/asking.md)の形で記述する。何を判断してもらうかは、規則「ユーザーへの返答は、経緯を追っていない人が読んで分かるように記述する」(writing-to-user.md)の「判断してもらうことだけを問いかけ、経緯を読まずに答えられる形にする」の節に沿って決定する。 エージェントが選んで進めたことは、「判断を求めていること」の節ではなく「直近のステータス」か「タスク」の背景・補足に記載する。

判断してもらうことが1つだけで、タスクの進み具合など、ほかに伝えることが無ければ、返答を「判断を求めていること」の節だけにしてよい。

見出し・表の列名・状態の語は、返答と同じ言語で表記する。

タスクの状態欄の表記

状態欄は「絵文字+状態の語」で表記する。次の 7 つは固定で、当てはまる場面では、表に記載した絵文字と状態の語の組を変えずに使う。

状態欄の表記使う場面
✅ 完了終わっていて、結果を確かめた
🚧 作業中今、エージェントが手を動かしている
⏳ 処理待ち自分の手を離れて動いているもの(裏で動かした処理、サブエージェント、CI など)の終わりを待っている
🙋 判断待ちユーザーが判断しないと進められない。判断を求めていることの番号を添える(例:🙋 判断待ち(1))
📝 未着手やることは決まっているが、まだ始めていない
❗ 問題あり失敗した、または結果が想定と違って止まっている。何が起きたかを背景・補足に記載する
⛔ 中止やらないことに決まった。誰の判断かを背景・補足に記載する

絵文字を使わないようにユーザーに言われていれば、状態の語だけを表記する。

7 つのどれにも当たらない状態は、状態を表す絵文字と語の組を作って使ってよい。上の 7 つの絵文字はほかの意味に使わない。

状態欄の絵文字は意味を担うので、整えるときも残す。

送信前の確認

作成した報告を、規則「記述した文章は、渡す前に整える」(スキル writing-rules の rules/polishing.md)に沿って整える。yomiyasu は呼ばない。表の構造も残す。

같은 저장소의 Skills

더 많은 Skills

모든 Skills
kulikala
커뮤니티

check-terms

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

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

explain-clearly

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