jww-writing-style について
Justinの文体で文章を作成・編集するためのスキルです。率直で簡潔な表現を重視しつつ、必要な背景、技術的な正確さ、事実の範囲を保ちます。
主な機能
- 01要点から書き始める表現
- 02自然で平易な言葉遣い
- 03必要に応じた次の手順
- 04チャネルと読者に応じた調整
- 05技術的詳細と不確実性の保持
活用シーン
- 01Justinの文体でSlackの更新を作成
- 02明確さを重視したメールの編集
- 03技術的な議論用プロンプトの準備
- 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へのすべての返答に適用したりするためのルールではありません。文章の作成依頼は、メッセージの送信、投稿、履歴へのアクセスを許可するものではありません。
ルール
- 要点から始めます。 回答、依頼、決定、行動を最初に伝えます。読み手に必要な場合に限って背景を加えます。新しい読者もチーム内の既存の背景を知っているとは限りません。
- 日常的な言葉を使います。 「この問題を調査し、調査結果をお知らせします」より「確認してみます」を優先します。自然な範囲で短縮形や能動態を使います。企業的な空疎な表現や大げさな熱意は避けます。
- 次のステップを明確にします。 裏付けとなる情報があり、関連する場合は、担当者、依頼事項、時期を含めます。情報を伝えるだけのメッセージに、無理にアクション項目を加える必要はありません。
- 簡潔にしつつ、説明を省きすぎません。 段落は短くします。複数の項目を区別して伝える場合は箇条書きを使います。読み手の判断に影響する理由、制約、留保は残します。
- 気さくながらも、頼れる姿勢を保ちます。 期待することを率直に伝え、相手が実行する余地を持たせ、役立つ場合は理由も説明します。細かく指図する表現、見下すような態度、不要な謝罪は避けます。必要な感謝や謝罪はきちんと伝えます。
- 技術的な詳細は正確に保ちます。 意味のある名称、識別子、違い、不確実性を維持します。自信のある口調を理由に、推定を約束に変えたり、仮説を事実として扱ったりしてはいけません。
- 温かみは控えめにします。 簡潔な受け止めや感謝で十分なことがよくあります。乾いたユーモアを使うかどうかは任意です。提供された内容や相手との関係に合う場合に限り、文体を印象づけるためだけに冗談を加えてはいけません。
チャネルに合わせる
| チャネル | 既定の対応 |
|---|---|
| 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 の修正や提示された例に基づいて調整してください。