Communityライティング&編集github.com

plain -- 専門用語やコードを平易な英語に翻訳

専門用語、コード、略語が密集した応答を、わかりやすく会話調の平易な英語で言い直すスキル。

plain -- 専門用語やコードを平易な英語に翻訳 とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)の応答が、独自のコード(例:F027、B13、PTT、def_hashなど)、展開されていない略語、複合名詞の連なりで埋め尽くされている問題を解決します。ユーザーが理解しやすい平易で会話調の英語に「もう一度言い直す」ことで、情報の損失なく内容を明確にします。/breakdown(短縮・要約)の対極にあり、簡潔さよりも意味の保持を優先します。デフォルトでは直前のアシスタントメッセージを対象とし、ユーザーが別のテキストやファイルを指定した場合はそちらを翻訳します。コードや用語の意味はプロジェクト内のファイルを検索して実際の意味を解決し、推測で意味を捏造することは禁止されています。すべての内容を保持し、新しい分析や意見は追加せず、既存の内容を読みやすく再表現するだけです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dtiger1889-ops/claude-harness-toolbox/tree/main/skills/plain

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

plain -- 専門用語/コードの応答を平易な英語に翻訳する

このスキルが強制する基本ルール:チャット内で理解しやすく消化しやすい英語を維持すること -- 自己発明的なコードはすべて平易な言葉で説明し、プロセス説明の下に何も埋もれさせない。 このルールはしばしば破られてきた -- 応答にはファイルコード(F027、B13、PTT、def_hash...)、展開されていない略語、読み手にとって壁となる複合名詞の連なりが詰め込まれて返ってくる。このスキルはその修正策である:その応答を受け取り、平易で会話調の、余裕のある英語でもう一度言い直す。

これはアンチ簡潔スキル -- /breakdown(要約・短縮)の真逆です。長さは構いません;意味を失うことが問題なのです。

翻訳対象

デフォルトの対象:直前のアシスタントメッセージ。ユーザーがテキストを貼り付けたり、ファイル/ブロックを @ メンションした場合は、そちらを翻訳します。どちらか曖昧な場合は、一度だけ確認します。

やり方

  1. すべてのコード、タグ、略語を実際の意味に解決する -- 推測してはいけません。 ファイルコード、フェーズ名、ゲート名、ハッシュなどが出現したら、プロジェクトファイル(例:findings.md、CHECKPOINT.md、該当する仕様書)でそれを調べ、実際に何であるかを人間の言葉で述べてください。もしコードの参照先を本当に見つけられない場合は、「Xが何を指すか見つけられませんでした」と言ってください -- 決して意味をでっち上げてはいけません。
  2. 要約ではなく言い換える。 すべての内容を保持する。これは翻訳であり、トリミングされた再録ではありません;短くするために詳細を落とすのが失敗モードです。
  3. 複合名詞の連なりや入れ子になった節を分解し、短くて普通の文にします。
  4. 新しい短縮形を導入しない -- コードやプロジェクト専門用語は使わない。どうしても避けられない専門用語は、最初に使う時にその場で定義してください。
  5. 読みやすい構造にする -- 長い段落ではなく、短い段落か簡潔なリストを使う。

ルール

  • 平易で会話調の英語で、消化しやすいように構造化する:答えを最初に置き、短い段落で、すべての用語を定義するのに十分な広がりを持たせる -- 決してテキストの壁を作らない。
  • 解決できなかったコードに対して意味をでっち上げてはいけない。
  • 新しい分析、意見、次のステップを追加しない -- 既存の内容を読みやすくするだけ。ユーザーがさらに必要なら、尋ねてくるでしょう。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル