Skip to content

usage

Jump to bottom
github-actions[bot] edited this page Aug 29, 2026 · 8 revisions

導入方法とユースケース別の使い方

導入方法

インストールせずに試す場合のブラウザ版アプリ: https://boxpistols.github.io/ux-writing-dead-cliche/ (辞書の検索と、AI チャットに貼る指示文のコピー)

Claude Code プラグインとして (推奨)

スキル・コマンド・フック・エージェントの全部が入る導入方法です。

/plugin marketplace add BoxPistols/ux-writing-dead-cliche
/plugin install dead-cliche

チームで揃える場合は、プロジェクトの .claude/settings.json に書いてコミットします。

{
  "extraKnownMarketplaces": {
    "ux-writing-dead-cliche": {
      "source": { "source": "github", "repo": "BoxPistols/ux-writing-dead-cliche" }
    }
  },
  "enabledPlugins": { "dead-cliche@ux-writing-dead-cliche": true }
}

CLI として (エディタ・AI ツールを問わない)

npx github:BoxPistols/ux-writing-dead-cliche check draft.md
cat draft.txt | npx github:BoxPistols/ux-writing-dead-cliche check --preset business

リポジトリを clone して npm install すれば node src/cli.mjs check でも動きます。

textlint ルールとして (既存の textlint 資産と併用)

npm install github:BoxPistols/ux-writing-dead-cliche textlint

.textlintrc.json:

{
  "rules": {
    "ux-writing-dead-cliche": { "preset": "paper" }
  }
}

prh や preset-ja-technical-writing と同じ設定ファイルに並べて書けます。

CI として (GitHub Actions)

- uses: actions/checkout@v4
- uses: actions/setup-node@v4
  with:
    node-version: 22
- run: npx github:BoxPistols/ux-writing-dead-cliche check docs/*.md README.md

error 級の検出があると exit 1 になり、ジョブが落ちます。

プロジェクトごとの設定

対象リポジトリの直下に .deadclicherc.json を置くと、既定プリセットと除外パスを固定できます。

{
  "preset": "business",
  "ignore": ["docs/archive/", "CHANGELOG.md"]
}

ユースケース別の使い方

技術記事・ブログの推敲

書き終えた原稿に /dead-cliche:check 記事.md を実行します。検出表 (file:line / ルール / 該当表現 / 直し方) が返り、--fix を付けると意味を保った書き直しまで行います。 プラグインを入れていれば、Claude が Markdown を書いた直後にフックが自動でチェックし、 クリシェが混入した時点で書き直しが走ります。手動での実行は不要になります。

論文・設計文書・提案書

paper プリセットを使います。修辞疑問 (〜ではないでしょうか) と呼びかけ (〜していきましょう) も error になります。長い原稿は dead-cliche-editor エージェントに渡すと、原稿全文を メイン会話に持ち込まずに推敲結果と変更表だけが返ります。

UI 文言のレビュー

ux-writing-review スキルが反応する場面 (文言を書いた・変えた・レビューを頼んだ) で、 機械チェック (--preset ux-microcopy) と人力チェックリスト (句点の原則、ボタンの 動作名詞、確認ダイアログ、エラーの 3 要素) を通した指摘が must / should の 2 段階で返ります。 CLI 単体でも check src/components/*.tsx --preset ux-microcopy で助詞のゆれ (が失敗しました) や責める表現 (不正な値) を拾えます。

PR レビュー

/dead-cliche:pr-review 1234 で PR 全体をレビューします。コードの観点に加えて、 差分中の散文 (.md、PR 本文) を business プリセットで、UI 文言を ux-microcopy プリセットで検査し、must / should の 2 段階の指摘と、署名・絵文字なしのレビュー コメント文面を組み立てます。既定では文面の提示で止まり、--post を付けたときだけ 確認のうえ gh pr review で投稿します。

PR・コミット・レビューコメント

plain-communication スキルが PR 作成・コミット・レビュー投稿時に常時効きます。 AI 署名と絵文字は入らず、課題と取るべきアクションを明確にした端的な文面になります。 Claude Code 本体の署名も止める場合は settings.json に次を足します。

{ "attribution": { "commit": "", "pr": "", "sessionUrl": false } }

Slack のレビュー依頼

/dead-cliche:review-request で、現在のブランチの PR からプレーンテキストの依頼文を 作ります。URL はフルパス、5 行以内、装飾なしです。/dead-cliche:review-request 1234 明日中に のように PR 番号や期限を渡せます。

文章の新規生成

/dead-cliche:compose テーマ で、導入・説明・結論の 3 段落の文章を生成します。 生成物は出力前にチェッカーを通し、0 件になるまで書き直されます。既存のプロンプト集の 文章生成プロンプトを使う場合も、出力をこのゲートに通せば文体が揃います。

Claude Desktop アプリで使う

Desktop アプリの Code モード (Claude Code セッション) は、この Mac の user スコープの プラグインをそのまま読み込みます。追加の設定は不要で、/dead-cliche:check や フックが同じように動きます。

Code モードではない通常のチャットにはプラグインの仕組みがないため、claude.ai の スキルとして入れます。npm run build:claude-ai-skill で生成される dist/dead-cliche-review.zip (辞書 130 ルールを同梱) を claude.ai の 設定 → 機能 → スキルからアップロードすると、Desktop のチャットでもクリシェ検出と レビュー規律が効きます。決定論的な CLI はチャット内では動かないため、厳密な検査は CI か Code モードに任せる位置付けです。

iPhone アプリでリポジトリをレビューする

3 つの経路があります。

  1. claude.ai/code のクラウドセッション。対象リポジトリの .claude/settings.json に marketplace とプラグインを書いてコミットしておくと、クラウド環境でも同じ プラグインが読み込まれ、iPhone アプリから /dead-cliche:pr-review まで使えます。 投稿 (gh pr review) もクラウド側で実行できます。
  2. claude.ai スキル (上記の zip)。iPhone のチャットにも同期されるため、GitHub コネクタで PR を読ませてレビューさせる使い方ができます。投稿は文面をコピーして GitHub アプリから行います。
  3. リモートコントロール。Mac で起動した Claude Code セッションを iPhone アプリから 操作する方式で、ローカルのプラグイン・フック・CLI がすべてそのまま効きます。

辞書を育てる

誤検出を見つけたら corpus/negative/ に 1 行追加して再現させてから、パターンを直して PR を出します。新しいクリシェは該当カテゴリの rules/*.yml に 1 エントリ追加します。 どちらも npm test が回帰を検出します。

Clone this wiki locally