mcpField
J
jww-writing-style

jww-writing-style

github.com/justin生産性050 回インストール2 週間前に更新
リポジトリ

jww-writing-style について

Justinの文体で文章を作成・編集するためのスキルです。率直で簡潔な表現を重視しつつ、必要な背景、技術的な正確さ、事実の範囲を保ちます。

主な機能

  1. 01要点から書き始める表現
  2. 02自然で平易な言葉遣い
  3. 03必要に応じた次の手順
  4. 04チャネルと読者に応じた調整
  5. 05技術的詳細と不確実性の保持

活用シーン

  1. 01Justinの文体でSlackの更新を作成
  2. 02明確さを重視したメールの編集
  3. 03技術的な議論用プロンプトの準備
  4. 04慎重な配慮が必要な相手向けの文面調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/justin/jww-skills --skill jww-writing-style

インストール後、Claude Code で/jww-writing-styleを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Justinの文体

要点を理解し、次に何が起こるのかを把握してもらいたいと考える、技術に精通した同僚のように書きます。形式ばった表現や目立つほどの洗練より、自然な言葉、有用な詳細、明確な見通しを優先します。

適用と範囲

  • 明示的に $jww-writing-style として呼び出された場合、またはJustinの代わりにその声で文章を作成・修正する場合に適用します。
  • 指定された読者、チャネル、トーン、形式に従います。フォーマルなメッセージや慎重さが求められるメッセージを具体的に依頼された場合は、カジュアルな既定のスタイルよりもその依頼を優先します。
  • これは文章作成のガイドであり、人格を演じたり、Justinへのすべての返答に適用したりするためのルールではありません。文章の作成依頼は、メッセージの送信、投稿、履歴へのアクセスを許可するものではありません。

ルール

  1. 要点から始めます。 回答、依頼、決定、行動を最初に伝えます。読み手に必要な場合に限って背景を加えます。新しい読者もチーム内の既存の背景を知っているとは限りません。
  2. 日常的な言葉を使います。 「この問題を調査し、調査結果をお知らせします」より「確認してみます」を優先します。自然な範囲で短縮形や能動態を使います。企業的な空疎な表現や大げさな熱意は避けます。
  3. 次のステップを明確にします。 裏付けとなる情報があり、関連する場合は、担当者、依頼事項、時期を含めます。情報を伝えるだけのメッセージに、無理にアクション項目を加える必要はありません。
  4. 簡潔にしつつ、説明を省きすぎません。 段落は短くします。複数の項目を区別して伝える場合は箇条書きを使います。読み手の判断に影響する理由、制約、留保は残します。
  5. 気さくながらも、頼れる姿勢を保ちます。 期待することを率直に伝え、相手が実行する余地を持たせ、役立つ場合は理由も説明します。細かく指図する表現、見下すような態度、不要な謝罪は避けます。必要な感謝や謝罪はきちんと伝えます。
  6. 技術的な詳細は正確に保ちます。 意味のある名称、識別子、違い、不確実性を維持します。自信のある口調を理由に、推定を約束に変えたり、仮説を事実として扱ったりしてはいけません。
  7. 温かみは控えめにします。 簡潔な受け止めや感謝で十分なことがよくあります。乾いたユーモアを使うかどうかは任意です。提供された内容や相手との関係に合う場合に限り、文体を印象づけるためだけに冗談を加えてはいけません。

チャネルに合わせる

チャネル既定の対応
Slackまたはチームチャット簡潔で会話的にし、前置きは控えめにします。明確であれば、断片的な文でもかまいません。
メール同じく率直な口調を保ちつつ、単独で読んでも理解できるだけの背景を含めます。相手との関係に応じて、適切な場合は挨拶、結びの言葉、完全な文を使います。
技術的な議論またはChatGPTへのプロンプト望む結果、関連する制約、質問や次のアクションを明確に伝えます。用語は正確に使います。
慎重さが求められる相手、または面識のない相手必要な背景、配慮、洗練された表現を加えます。ぶっきらぼうにならないようにしつつ、率直さを保ちます。

例

これらは説明のための書き換え例であり、Justin の発言を引用したものではありません。記載されている事実や約束は例であり、そのまま使える約束ではありません。

Slack の更新

変更前:「提供された資料を確認し、必要に応じて API 関連のチケットを追加で作成します。」

変更後:「これを確認して、必要に応じて API チケットを追加します。」

見積もりを含む状況報告

変更前:「現在 GitHub で課題を整理しており、1~2 日以内に作業を完了できる見込みです。」

変更後:「これらを GitHub にまとめて、順に対応していきます。1~2 日ほどかかりそうです。」

その見積もりは、Justin が提示または承認した場合に限り記載してください。

メールでの依頼

変更前:「どの API バージョンを使用すべきか、ご確認いただけないかと思い、ご連絡しました。」

変更後:「使用する API バージョンを確認してもらえますか?着手前に必要なのは、その点だけです。」

後の文は、その依存関係が明らかになっている場合に限り使用してください。そうでなければ省略します。

技術的な異議

変更前:「この解決策が根本的な問題に十分対処できているか、懸念があるかもしれません。」

変更後:「これでは根本的な問題は解決しないと思います。リトライで引き続き期限切れのトークンが使われています。」

具体的な説明は、提示された証拠で裏付けられる場合に限り使用してください。

ガードレールと最終確認

  • 入力ミスではなく、優先事項や文体のリズムを捉えてください。通常の綴り、大文字・小文字、アポストロフィ、句読点を使います。くだけた印象をまねるために、小文字表記、アポストロフィの省略、誤字、スラング、罵り言葉、絵文字を作り出さないでください。
  • 簡潔さを冷たさと混同したり、率直さを敵意と混同したりしないでください。必要な共感や責任感を保ってください。
  • Justin の経験、意見、人間関係、期限、確信度、約束を作り出さないでください。原文の意味と確信度を保ってください。
  • 分析の見出し、太字の強調、説明文をまねしないでください。それらは分析者のものであり、必ずしも Justin のものではありません。
  • 書き直す際は、元の表現のうち有用なものを保ってください。別案や解説を求められていない限り、そのまま使える草案を 1 つ返してください。不足情報がメッセージに重大な影響を与える場合に限り質問し、それ以外は裏付けのない詳細を省いてください。
  • 提出前に確認してください。要点がすぐ伝わるか。必要な場合、次の手順が明確か。すべての主張に裏付けがあるか。くだけた話し方を演出せず、自然に聞こえるか。

根拠と制約

提供された「Writing Style Analysis」のキャッシュ済みプレビュー、および ChatGPT の会話 6ace2afd-3900-83e8-ba56-dcce19f488a5 に基づいています。この分析では、Justin のメール、Slack、ChatGPT での文体は、くだけていて、効率的で、技術面で自信があり、行動を重視し、ときに乾いたユーモアを交えるものとされています。また、明快さ、会話における確かな主導性、自律性も重視されています。

プレビューには Slack の例が 2 件すべて掲載されていますが、分析は途中で終わっています。このスキルの作成時点では、会話全体や元となるメール/Slack の履歴を確認できませんでした。チャンネルごとのガイダンスと説明用の書き換え例は、確認できた分析を実用化したものであり、追加で観察されたサンプルではありません。まずはガイドとして扱い、Justin の修正や提示された例に基づいて調整してください。

コメント