glossary-sync
リポジトリの用語集 docs/glossary.md と、文書の中の用語の使い方の食い違いを洗い出す。「用語集と文書の食い違いを調べて」という依頼で使う。用語集の新規作成と翻訳には使わない。
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- glossary-sync
- description
- リポジトリの用語集 docs/glossary.md と、文書の中の用語の使い方の食い違いを洗い出す。「用語集と文書の食い違いを調べて」という依頼で使う。用語集の新規作成と翻訳には使わない。
02 资源文件 2
- 参考文档references/roles/checker.md459 B
- 脚本scripts/check.js644 B
03 SKILL.md 正文
glossary-sync
概要
このスキルわ、用語集に載ってる用語が文書のなかでどう使われてるかを、用語ごとに確かめるためのもので、確かめた結果は表にまとめられ利用者へと返されるのである。
手順
docs/glossary.mdを読み、表の 1 列目を用語の並びとして取り出す。ファイルが無ければ、用語集が無いことを利用者に返して止まる。- 用語の並びを
termsとしてWorkflow({ scriptPath: "[SKILL_DIR]/scripts/check.js", args: { terms } })を起動する。 - 返った結果の並びを、用語・食い違いのある文書のパス・食い違いの内容の 3 列の表にして利用者に返す。食い違いが 1 件も無ければ、「食い違いは無い」と返す。
書き方
利用者に返す表は、用語の並びの順のままにしておいていただき、行の並べ替えは行わないようにしてください。表の後には、確かめた用語の数を 1 行で添えるようにしてください。
04 同仓库更多 Skills
coverage-build
文書でもプログラムでも、作る(create)・既にあるものを目標に合わせて直す(update)・作らずに目標に照らして確かめる(review)作業を、 目標の固定 →(update は現状の検査)→ 設計 → 設計レビュー → 実装 → 実装レビューの段で回し、見落としを構造で減らす汎用の仕組み。 1 体には 1 単位だけを任せ、テストは実装と別の担当が先に書き、レビューは coverage-audit を呼び、悪かった出来事を探索グラフで振り返って 欠陥を原因の層(目標・設計・実装)へ戻す(指摘の箇所だけを直す経路は持たない)。台帳は run をまたいで持ち越し、変わったものだけを見直す。 「この機能を設計からレビューまで通して作って」「このスキルを目標に合わせて直して(文書とコードが混ざってよい)」 「この実装が目標を満たすか確かめて、直すならどの層からかを返して」のような依頼で使う (Use when building or updating documents or code through goal, design, design review, implementation, and implementation review with layer-routed rework)。 対象外: 目標に照らした網羅的な検査だけで振り返りも要らないもの(coverage-audit)、1 体で 1 回で済む小さな変更、このリポジトリの差分・PR のレビュー(repo-review)。
coverage-audit
与えられた目的と対象(設計・計画・要求・仕様・コード・テストなどのファイル)を、資産 × 観点の枡に分けて網羅的に検査し、 確かめた指摘と、見ていない所(開示した枡)を台帳に残して返す検査専用の仕組み。1 体には 1 枡だけを渡し、 読んだ証拠を本文の区画ごとの逐語の引用で機械が照らし、読む役と別のモデル・反証側の検証役が指摘を確かめ、 悪かった出来事を振り返り、確かめた欠陥を根本原因で束ねて型を全ての資産へ横展開する。台帳は run をまたいで持ち越し、変わった枡だけを読み直す。 「修正の前にこの設計・計画を観点ごとに漏れなく検査して」「この実装が目的と仕様を満たすか網羅的に検証して」 「前回の台帳の続きから、変わった所だけ検査し直して」のような依頼で使う(Use when files must be audited for every part × every lens with machine-checked evidence, without fixing them)。 対象外: 修正・生成の実行(このスキルは指摘と網羅の記録までを返し、直すのは呼ぶ側)、1 体で 1 回で済む小さな確認、このリポジトリの差分・PR のレビュー(repo-review)。
summarizing-meeting-notes
会議後に書かれた議事録・会議メモ・文字起こしテキストと、会議の録音ファイル(.mp3 / .m4a)を読み、 決定事項・アクションアイテム・未決事項を区分した要約を作る。 「この議事録を要約して」「会議メモから宿題を抜き出して」「定例の決定事項をまとめて」 「先週の打ち合わせの要点を出して」のように、 会議の記録から決定・宿題・未決を知りたい依頼なら使うこと。 記録が箇条書き数行のメモでも使うこと。 対象外: 会議中のリアルタイムな記録取り、議事録以外の文書(企画書・報告書)の要約、 1on1・面談の記録の要約。
release-notes-editor
リリースノートの下書きを、利用者と 1 項目ずつ確かめながら書く。「次のリリースのリリースノートを書いて」「リリースノートを作って」という依頼で使う。リリースノートの翻訳と、コミットメッセージの書き直しには使わない。
trace-cause
リポジトリで再現する 1 つの失敗(落ちるテスト・誤った出力)の根本原因を、確かめた事実の連なりとして特定する。「このテストが落ちる原因を突き止めて」「なぜこのコマンドがこの出力になるのか調べて」のように、再現手順のある失敗の原因調査を頼まれたときに使う。再現手順の無い相談、修正そのものの依頼、一般的な質問には使わない。
review-document
[When] Use when a Japanese explanatory document (requirements, rules, README, skill text) needs a readability review or revision. または短く書き直したいとき。[What] 「短さ・平易さ・独自用語の不使用」の3軸で証拠つき採点を行い、 求められれば内容を落とさない改稿案を作って before/after を示す(native Workflow は staging、Codex runner は本文をインラインで返却)。 「この要求文書を読みやすさの観点で見て」 「この rule、冗長じゃないか採点して」「この README を短く書き直して」「PRD を渾身の言語化の 基準でレビューして」「独自用語が多すぎないか確認して」といった依頼で使うこと。 他のドキュメント生成スキル(prd-spec など)から監査の観点として呼ばれる場合にも使う。 文書の新規執筆、コードレビュー、翻訳は対象外。対象の文書パスが示されていない依頼では 採点に入らず、どの文書かを1回だけ聞き返す。