本文へ移動
cccskills
無料GitHub で公開

naturalize-ja

日本語の技術文書 (技術ブログ・技術記事・README・設計書・英語の技術語が混ざるドキュメント) に絞った AI 臭レビュアー。

ファイル / 貼り付けテキスト / ディレクトリを読み、プレ AI 時代の技術ブログ調へ整えるための禁止フレーズ辞書 (16 カテゴリ A–P。曖昧・稚拙な用語の的確化も含む。実フィードバックと公開研究を統合) と、grep + 質的レビューの二段監査で検出・置換します (subagent をさらに spawn せず、自分のコンテキスト内で完結)。

英語語混在の技術ドキュメントには、カタカナ技術語→英語表記・英字↔日本語の境界スペース除去のハウススタイルも適用します。en-to-ja-explainer と japanese-tech-writing が名前指定で委譲する先でもある。

技術文書以外 (議事録・レポート・メール・企画書などのビジネス文書、note・一般のブログ・エッセイ) の AI 臭除去、読みやすさの改善、AI 臭さの採点・診断は natural-japanese の担当なので、そちらを使う。

Triggers: 「技術ブログの AI 臭を抜いて」「技術記事の日本語を自然にして」「README の日本語が AI っぽい」「技術ドキュメントの ChatGPT 臭をチェック」「カタカナ技術語を英語表記に揃えて」「naturalize Japanese」「naturalize-ja」「/naturalize-ja」

実行スコア 未検証

インストール方法を見る

含まれるファイル(6)

  • SKILL.md5.3 KB
  • agents/naturalize-ja.md8.9 KB
  • feedback/amendments.md889 B
  • references/ai-japanese-patterns.md14.7 KB
  • references/review-agent-prompt.md4.4 KB
  • references/tech-doc-house-style.md6.8 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

naturalize-ja

naturalize-ja:naturalize-ja サブエージェントに処理を委譲する thin wrapper。 ロール定義 (日本語ネイティブのレビュアー) と二段監査ワークフロー (grep + 質的レビューを 同一コンテキスト内で完結) は subagent 側に集約。

呼び出し方

@agent-naturalize-ja:naturalize-ja <target> [--policy auto|propose] [--scope <section>]

引数の意味と挙動は subagent 側の system prompt に書いてある。auto-discovery のトリガーフレーズ経由でこの skill が呼ばれたときは、ユーザー入力をその まま subagent に渡して実行を委ねる。

委譲元から見たインターフェース

他スキル (例: en-to-ja-explainer) からこのスキルを呼びたいときは:

  • @agent-naturalize-ja:naturalize-ja を直接呼ぶ (subagent への delegation。スキル経由のホップを省略できる)
  • もしくは /naturalize-ja skill 呼出 (本 wrapper 経由)

どちらでも、最終的に subagent 側のワークフローが走る。

natural-japanese との住み分け

AI 臭の除去は vendored スキル natural-japanese (coji/natural-japanese) と 重なる。自動起動の振り分けは description で行い、このスキルは技術文書、 natural-japanese はビジネス文書・エッセイ・読みやすさ・採点を受け持つ。 振り分けのために natural-japanese 側は書き換えない (上流と無改変のまま 保つため)。技術文書以外を明示的に渡された場合も拒否はせず、そのまま処理する。

なぜ subagent 化したか

  • このスキルの本質は「同じ役割・判断基準を持つ担当者に任せる」(role-based) であり、「毎回同じ手順を回す」(procedure-based) ではない
  • 委譲元 (en-to-ja-explainer など) から呼ぶときに、subagent 呼出のほうが context boundary が綺麗
  • 内部で subagent をさらに spawn しない設計に整理されたことで、subagent 化が現実的になった (Claude Code の subagent は further subagent を spawn できない)

References

subagent が必要に応じて読む reference:

  • references/ai-japanese-patterns.md — カテゴリ A–P の禁止フレーズと置換辞書 (曖昧・稚拙語の的確化 = カテゴリ P を含む)
  • references/tech-doc-house-style.md — 英語語混在の技術ドキュメント向けハウス スタイル (カタカナ技術語→英語表記、英字↔日本語の境界スペース除去)。bilingual な 技術文のときだけ適用
  • references/review-agent-prompt.md — 質的レビューのチェックリスト

Retrospective

セッション完了時:

  1. 辞書に無かった新パターンが見つかったか確認する
  2. ユーザーに 1 行で問いかける:「今回直したフレーズで辞書に追加すべき パターンや、見落としていた表現があれば一言だけ (Enter でスキップ)」
  3. フィードバックがある、または新パターンが現場で出ていた場合: a. feedback/log.md を作成 / 追記 b. エントリには新パターンとカテゴリ案を含める
  4. クリーンに完走でフィードバックも新パターンも無ければ、ログ無しで終了

Feedback Check

スキル起動時、feedback/log.md に 5 件以上あれば直近 10 件を読む。 同じ新パターンが 3 件以上検出されているなら、ユーザーに伝える:

「直近のフィードバックで『X』というパターンが繰り返し検出されています。 ai-japanese-patterns.md のカテゴリ Y への追加を提案します。」

決定はユーザーに委ね、深い分析が必要なら /skill-improve --skill naturalize-ja に進める。ログが無い、または 5 件未満なら静かにスキップ。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

Run a multi-model adversarial mutual review with facilitator synthesis: 2+ panelists (different model families where possible — use codex-server / codex-cli for the external-family seat) independently answer, adversarially critique each other across rounds, and the main session acts as facilitator, synthesizing agreements, live disagreements, and calibrated confidence into one answer. Use ONLY on high-stakes, hard-to-reverse claims, designs or decisions, and only when the user EXPLICITLY asks to debate or adversarially review with multiple models — "discuss with Opus and Codex", "red-team this", "devil's advocate", 敵対的レビュー, 相互レビュー, 多モデル討論, 議論させて. A full run costs ~6 subagent/CLI dispatches: state the panel size and round count and get a go-ahead before launching. Where the Workflow tool is available, run the panel as a Workflow (judge-panel / adversarial-verify) instead of ad-hoc fan-out. Do NOT self-trigger on a bare "are you sure?" — that is a cue to OFFER the panel, not to run it.

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Orchestrate multiple coding-agent sessions (Claude Code, Codex, Gemini) over the mcp_agent_mail MCP server, observe their progress on a recurring auto-loop, and prevent inconsistencies (file/edit conflicts and contradictory decisions) between concurrent tasks. Auto-manages the agent-mail server, derives the shared room key from the git repo, and runs either as the orchestrator/observer or as a participating worker. Handles the operational details (server startup, room key, reservation conventions) so the user does not have to remember them. Use when coordinating several agent sessions on different tasks at once, watching a swarm of sessions for conflicts, or wiring already-running sessions into a shared coordination room. Trigger phrases: "agent-swarm", "/agent-swarm", "orchestrate agents", "orchestrate multiple claude sessions", "coordinate sessions", "watch for conflicts between agents", "observe the swarm", "prevent inconsistency between sessions", "multi-agent observe", "複数セッションを協調", "エージェント協調", "セッション間の不整合監視", "スウォーム監視", "複数のClaudeを束ねて".

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Generate AGENTS.md (cross-tool agent context — Codex CLI, Aider, Cursor, etc.) and wire CLAUDE.md as a symlink so Claude Code reads the same file. Delegates content generation to Claude's built-in /init when needed, then renames + symlinks. Idempotent. Triggers — /agents-init, "generate agents.md", "create agents.md", "share claude and codex context", "set up agents file", "init agents", "agents-init", "cross-tool agent context", "wire claude and agents".

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Drive an already-running, LOGGED-IN Chromium browser on macOS via AppleScript — navigate, click, fill forms, scroll, and extract page content from the user's REAL session, with the browser left open and NO profile copy and NO restart. Use when the task needs the existing logged-in session (cookies, auth, current tabs) reused as-is. Trigger phrases: "chrome-use", "ブラウザから取得", "ログイン済みの Chromeで", "ブラウザを操作して", "このページ読んで", "Xのスレッド読んで", "ログインしたまま取得", "自分のセッションでスクレイプ", "read this page in my browser", "scrape with my session", "drive my chrome", "execute JS in my (logged-in) browser", "automate my logged-in browser". Chromium family (Chrome default; Brave/Edge/Arc/Vivaldi via --app). NOT for isolated/throwaway automation where login reuse is unneeded — use playwright-cli for that. macOS only.

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

codex-cli

無料

Run OpenAI Codex CLI from the terminal for batch / one-shot `codex exec` invocations with output captured to an `-o` file. Use for fire-and-forget runs, scripted CI, code review batches (`codex review`), and resuming a specific session by id (`codex exec resume`). Always use this skill instead of `mcp__codex__codex` and `mcp__codex__codex-reply` MCP tools — CLI is faster and more capable. For streaming UX, multi-turn dialogues that need live state, structured (JSON schema) output, attaching images, or programmatic event handling → **use codex-server instead**. codex-server uses the user's ChatGPT subscription via Codex App Server and decoupled async invocation that bypasses the Bash 2-minute timeout entirely. Trigger patterns (batch-only — chat/streaming triggers belong to codex-server): codex-cli / codex CLI / codex exec / codex review / codex resume / codex fork / batch + {codex, gpt} / one-shot + {codex, gpt} / non-interactive + codex / codex {to a file, -o, output file, captured output} / CI + {codex, gpt} / scripted + {codex, gpt} / fork codex session / resume codex session by id

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

Run OpenAI Codex via the Codex App Server (JSON-RPC-over-stdio) for streaming multi-turn chat sessions with persistent threads, structured output, image input, and rich event streams. Default entry point for ChatGPT/GPT/Codex-like conversations from the terminal. Uses the user's ChatGPT subscription (Plus / Pro / Team) exclusively via `codex login` — never consumes OPENAI_API_KEY billing, by design. Implementation: TypeScript on deno with npm:@openai/codex-sdk; spawns the existing system codex binary. Decoupled async invocation: every turn returns turn-id in <1 s; the actual SDK work runs in a detached worker that streams to per-turn files under ~/.codex-server/turns/<turn-id>/ — Bash's 2-min timeout never applies. Prefer this over codex-cli for streaming UX, multi-turn dialogues that need live state, structured (JSON schema) output, attaching images, or programmatic event handling. Use codex-cli only for one-shot batch invocations that pre-capture to an -o file. For OpenAI Platform API calls specifically (embeddings, image generation, audio, moderation, batches, files) — not open-ended chat — use openai-cli instead; that path bills OPENAI_API_KEY, this one uses the ChatGPT subscription. Trigger patterns (match any variation): codex / codex-server / codex app server / codex app-server / openai / open ai / OpenAI / chatgpt / chat gpt / ChatGPT / GPT / ask gpt / chat with gpt / gpt session / codex session / streaming chat / multi-turn chat / multi turn chat / second opinion / cross-check / cross check / ai pair programming / another AI / external AI / ask another model / get GPT's take / what does openai think / show me what gpt thinks / structured output from gpt / json schema gpt / resume codex thread / continue codex conversation / continue codex session / /codex-server

日本語の概要は準備中です。原文の説明を表示しています。

hideki5123/agent-skill-set22026年10月21日 更新

hideki5123 のスキルをすべて見る

このスキルの問題を報告する