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

japanese-tech-writing

日本語の技術文書(書籍の章、記事、解説文)を新規に書く、既存の下書きを推敲する、公開前に規範違反を洗い出す、の3モードで支援します。

k16shikano氏のGist「日本語技術文書の文章規範」(Unlicense) をベースにした段落構成、論証の厳密さ、読み手の負荷管理、演出の抑制などの文章規範 (references/rules.md) と、BLOCKER/IMPORTANT/TASTEのseverity方式チェックリスト (references/checklist.md) を内蔵。

技術書/APIリファレンス/技術ブログ/翻訳解説ごとの例外は references/style-profiles.md に分離。AIっぽい語彙そのものの検出と置換は行わず、既存スキル naturalize-ja に委譲します (疎結合)。

Triggers: 「日本語の技術文書を書いて」「技術書の章を書いて」「この下書きを推敲して」「パラグラフライティングで整えて」「公開前にチェックして」「日本語技術文書の規範に沿って直して」「japanese tech writing」「japanese-tech-writing」「/japanese-tech-writing」

実行スコア 未検証

インストール方法を見る

含まれるファイル(7)

  • SKILL.md7.2 KB
  • LICENSE3.1 KB
  • NOTICE.md5.2 KB
  • references/checklist.md17.7 KB
  • references/modes.md8.0 KB
  • references/rules.md18.8 KB
  • references/style-profiles.md14.7 KB

SKILL.md(原文)

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

japanese-tech-writing

日本語の技術文書(書籍の章、記事、解説文)を対象に、生成、推敲、公開前チェックの3モードで文章規範を適用する薄いルーター。規範の本体、チェック項目、モードごとの手順は references/ に分離してあり、このファイルはモードの選び方と参照順だけを示す。規範の内容そのものはここに書き写さない。

規範の出典(k16shikano氏のGist、Unlicense)と、このリポジトリでの改変範囲は NOTICE.md と LICENSE にファイル単位で明記してある。

3つのモード

ユーザーの依頼が次のどれに該当するかを最初に判定する。

モードA: 生成

新しい日本語技術文書を最初から書くとき。

読み込み順:

  1. references/rules.md:全規範。書きながら適用する(下書きを書いてから後で直す二段構えにしない)。
  2. references/style-profiles.md:文書の型(技術書/APIリファレンス/技術ブログ/翻訳解説)に該当する例外があれば適用する。
  3. references/modes.md の「モードA」:上記2つを適用する実行手順。

モードB: 推敲

既存の下書きを受け取り、規範に沿って直すとき。

読み込み順:

  1. references/modes.md の「モードB」:4パスの手順とその順序。まず論証と厳密さ、次に構成と段落、続いて読み手の負荷と冗長、最後に表層の順で適用する。この順序を守る。
  2. references/rules.md:各パスが参照する規範本体。
  3. references/style-profiles.md:文書の型に応じた例外。
  4. 4パス完了後、仕上げ確認として references/checklist.md を通してもよい(任意)。
  5. 4パス完了後、AIっぽい語彙の検出と置換は行わず、naturalize-jaへ引き継ぐ(後述)。

モードC: 公開前チェック

文書を公開する前に、修正はせず違反を洗い出して報告するとき。

読み込み順:

  1. references/checklist.md:点検項目とseverity (BLOCKER/IMPORTANT/TASTE)。
  2. references/rules.md:各項目の違反判断根拠と具体例。
  3. references/style-profiles.md:文書の型に応じた例外。
  4. references/modes.md の「モードC」:報告の順序と総合判定の出し方。

naturalize-ja との関係

japanese-tech-writing と、このリポジトリの既存スキル naturalize-ja は疎結合である。統合もしないし、完全に分離もしない。

  • 役割分担: japanese-tech-writing は文章設計、生成、論証、構成を担当する。naturalize-ja は既存テキストのAIっぽさ検出と置換に特化し、naturalize-ja/references/ai-japanese-patterns.md に15カテゴリの禁止フレーズ辞書を持つ。AIっぽい語彙の正本は常にnaturalize-ja側であり、references/rules.md の「LLMっぽい表現の禁止」節は、論証や構成に絡む言い回し(予告と総括、正面から系など)の抜粋にすぎない。
  • 推敲モード(B)での導線: 4パスを終えたテキストは、そのままAIっぽさ検出のためnaturalize-jaへ引き継ぐ。呼び出しは次のいずれか:
    • @agent-naturalize-ja:naturalize-ja <target> --policy propose(subagent直接呼出。en-to-ja-explainerが委譲元として使う形と同じ)
    • /naturalize-ja スキル呼出(wrapper経由。挙動は同じ)
  • 生成モード(A)と公開前チェック(C)ではnaturalize-jaを呼ばない: 生成モードは最初から規範に沿って書くため、後段の語彙検出は不要になる。公開前チェックは違反の洗い出しに徹し、修正の実行(naturalize-jaへの引き継ぎを含む)はモードB、あるいはユーザーの判断に委ねる。

References

Retrospective

セッション完了時:

  1. セッション中に起きたことを振り返る:
    • rules.md / checklist.md に無かった判断(新しい違反パターン、判定に迷ったケース)
    • モードの選択を誤った、あるいはユーザーに訂正されたケース
    • style-profiles.md のジャンル判定で迷ったケース
  2. ユーザーに1行で問いかける:「今回の規範適用で、追加すべきルールや見落としていた違反パターンがあれば一言だけ (Enterでスキップ)」
  3. フィードバックがある場合: a. feedback/log.md を作成/追記する b. エントリには該当ファイル (rules.md / checklist.md / modes.md / style-profiles.md) と提案内容を含める c. AIっぽい語彙そのものに関するフィードバックであれば、正本を持つnaturalize-ja側の feedback/log.md への転記も提案する
  4. クリーンに完走し、フィードバックも無ければログは書かずに終了する

Feedback Check

スキル起動時、feedback/log.md に5件以上あれば直近10件を読む。同じ指摘が3件以上あるなら、ユーザーに伝える:

「直近のフィードバックで『X』というパターンが繰り返し指摘されています。references/該当ファイルへの追加を提案します。」

決定はユーザーに委ね、深い分析が必要なら /skill-improve --skill japanese-tech-writing に進める。ログが無い、または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 のスキルをすべて見る

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