mattpocock-skills-zh-cn

これは mattpocock/skills の簡体字中国語ローカライズ版であり、Claude Code、Codex などのコーディングエージェント向けに、作者が日々の実際のエンジニアリング業務で使用するエージェントスキルを提供します。開発プロセス全体を掌握する方法論フレームワークではなく、小さく変更可能で組み合わせ可能であることを重視しています。 ローカライズの動機と戦略： - 中国語の説明は、中国語母語話者の開発者にとって概念変換のコストを削減します。中国語で対話する、または中国語コーパスで最適化されたモデルにとって、中国語のプロンプトは中国語のコンテキストにより適合し、中英混在による曖昧さを低減します。 - 翻訳には skill-guided content localization を採用：自然言語の説明のみを翻訳し、ディレクトリ名、スキル名、frontmatter キー、コマンド、コードブロック、パス、URL、パッケージ/ツール/API 識別子などは保持します。これにより、インストールや実行時の動作を損なうことを防ぎます。 - リポジトリはコンテンツのリフレッシュ方式で上流と同期し、上流の Git 履歴やリポジトリ管理状態は同期しません。最新の同期翻訳は Claude（Anthropic）によって実行され、メンテナーが PR を通じて main ブランチにマージしました。メンテナンスルールは .skills/translate-skill/SKILL.md に記録されています。 インストール方法（3つから1つを選択。重複インストールは避けてください）： 1. skills.sh インストーラ：`npx skills@latest add vinvcn/mattpocock-skills-zh-CN` を実行し、インストールするスキルと対象のコーディングエージェントを選択します。この方法ではスキルがプロジェクトにコピーされるため、変更やカスタマイズが容易です。 2. Claude Code プラグイン：`/plugin marketplace add vinvcn/mattpocock-skills-zh-CN` と `/plugin install mattpocock-skills@mattpocock` を実行し、管理された読み取り専用バンドルとしてインストールします。新しいバージョンがリリースされると一括更新され、すぐに使用してアップデートを追跡したいユーザーに適しています。 3. DeepSeek Harness（dsh）：`dsh plugin --profile web add @vinvcn/dsh-mattpocock-skills-zh` でプラグインとしてインストールします。インストール後は `/zh-` にスキル名を付けて呼び出します（例：`/zh-grilling`）。 初回インストール時は `/setup-matt-pocock-skills` を選択し、エージェント内で1回実行する必要があります。これにより、issue トラッカー（GitHub、Linear、またはローカルファイル）、トリアージで使用するラベル、docs の保存場所が設定されます。 設計思想：作者はコーディングエージェントの一般的な失敗モードに対応するスキルを設計しました。 - 要件のズレ：grilling session（`/grill-me`、`/grill-with-docs`）により、エージェントが着手前に詳細に質問を重ね、意図を一致させます。 - 冗長な表現：shared language ドキュメント（CONTEXT.md）により、エージェントがプロジェクトの用語を解読し、命名の一貫性を高め、コードの閲覧を容易にし、トークン消費を削減します。 - コードが動作しない：フィードバックループ（静的型付け、ブラウザアクセス、自動テスト）を重視。`/tdd` は red-green-refactor サイクルを推進し、`/diagnosing-bugs` は規律ある段階的なデバッグサイクルを提供します。 - アーキテクチャの劣化：`/to-spec` は仕様作成前にどのモジュールを変更する予定かを質問します。`/improve-codebase-architecture` はコードベース内の深化機会をスキャンし、視覚的な HTML レポートを生成します。これは定期的なサーベイとして位置づけられ、レスキューではありません。 スキルは「誰が呼び出せるか」に基づいて2種類に分類されます：user-invoked（ユーザーが名前を入力してトリガーする必要があり、オーケストレーションを担当。model-invoked スキルを呼び出せるが、別の user-invoked スキルは呼び出せない）と model-invoked（ユーザーが呼び出せるほか、タスクが一致した場合にエージェントが自動的にトリガーすることも可能。再利用可能な規律を担う）。 Engineering（エンジニアリング系）： - User-invoked：ask-matt（このリポジトリのスキルルーティング）、grill-with-docs（質問形式のインタビューを実施し、CONTEXT.md と ADR を保守）、triage（トリアージロールの状態機械で issue を進める）、improve-codebase-architecture、setup-matt-pocock-skills、to-spec（会話を整理して spec を作成し、issue トラッカーに公開）、to-tickets（計画をブロック関係を持つ tracer-bullet チケットに分割）、wayfinder（大規模な作業を issue トラッカー上の decision チケットとして計画し、共有マップを作成）、implement（spec/チケットに従って実装し、合意された seams で /tdd を駆動し、/code-review で締めくくる）。 - Model-invoked：prototype（使い捨てのプロトタイプを構築。単一ファイルの HTML や複数の UI バリアントを生成可能）、diagnosing-bugs、research（信頼性の高い一次ソースを参照して調査し、引用付きの Markdown を保存）、tdd、domain-modeling、codebase-design（deep modules 設計規律と語彙）、code-review（Standards と Spec の2軸、並行サブエージェントレビュー）、resolving-merge-conflicts（hunk ごとに競合を解決し、各側の意図を追跡。--abort は使用しない）、wizard（対話型 bash ウィザードを生成し、インフラ構成、認証情報、CI シークレット、一括移行などの手順を人間が実行できるようにガイド）。 Productivity（汎用ワークフロー。コードに限定されない）： - User-invoked：grill-me、handoff（会話を圧縮して引き継ぎドキュメントを作成）、teach（現在のディレクトリを状態を持つ教学ワークスペースとして、セッションをまたいで教学）、to-questionnaire（決定を Markdown の質問票に変換し、回答できる人が記入）、wait-what（欠落したコンテキストを補完し、平易な言葉でメッセージを言い直す）。 - Model-invoked：grilling（再利用可能なインタビュー原語。grill-me、grill-with-docs、triage、wayfinder、improve-codebase-architecture を支える）、writing-for-agents（エージェント向けのドキュメント作成。例：AGENTS.md/CLAUDE.md）。 Misc（ローカルに保持されているが、使用頻度は低い）：git-guardrails-claude-code（フックを使用して、push、reset --hard、clean などの危険な git コマンド実行前にインターセプト）、migrate-to-shoehorn（テストファイル内の as 型アサーションを @total-typescript/shoehorn に移行）、scaffold-exercises（sections、problems、solutions、explainers を含む練習ディレクトリを生成）、setup-pre-commit（Husky pre-commit フックを設定し、lint-staged、Prettier、型チェック、テストを統合）。