菜单
新規パッケージの追加、`turbo.json` / `pnpm-workspace.yaml` / `tsconfig` の編集、`apps/` や `packages/` の構成変更、責務パッケージ（`log` / `error` / `prompt` / `env` / `db`）の配置・参照を行うときに参照する。Turborepo + pnpm のベストプラクティス、`workspace:*` プロトコル、JIT コンパイル方針を定義する。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
ユーザーの暗黙知を対話で引き出すとき（傾聴、インタビュー、曖昧な回答の具体化、過去の意思決定の掘り下げ、前提への挑戦、矛盾の統合、動機の引き出し、思考の精緻化）に参照する。Rogers 傾聴・DICE プロービング・CDM・悪魔の代弁者・弁証法的探究・動機づけ面接 OARS・ナラティブ引き出し・ソクラテス式質問の 8 技法を統合し、場面に応じた選択ガイドと共通ルールを定義する。
パッチバグフィクス以外の実装作業を行うときに必ず参照する。Issue 起票、専用ブランチ作成、実装、PR 作成、同期状態確認、ahead/behind がない場合のみマージする標準フローを定義する。巨大モノレポ、複数会社・複数人で同時実装する状況、機能追加、仕様変更、リファクタリング、設計変更、依存関係変更、DB/API/UI/アーキテクチャ変更で使用する。
既存スキルに従って作業しても期待通り進まないとき、Web 検索などで異なる情報・より新しい情報が得られたとき、スキルの条件分岐を厳守するとスタックや実装の自由度が制限され最良の結果が得られないと判断したときに参照する。`.agents/skills/<name>/SKILL.md` をローカルで改変する手順、および改変内容が有用と判断した場合に `philtzjp/skills` リポジトリへ変更提案 Issue を起票する手順とテンプレートを定義する。
コミット、プッシュ、ブランチ作成/切り替え/削除、マージ、リベース、`gh pr merge` による PR マージなどあらゆる Git / GitHub 操作を行うときに参照する。コミットメッセージのフォーマット (`type(scope): 説明`)、マージコミット件名 (`merge(scope): 説明`) の `--subject` / `--body ""` 指定、`--author` の扱い、`git fetch --prune` などの安全チェック、マージコミット件名・本文への PR/Issue 番号 (`#N`) 禁止、`Co-Authored-By` 禁止、`git add .` 禁止などを定義する。
日本語で文章を書く・編集する・レビューする・返信する際に参照する。英語（特にスラング・口語・技術用語）の直訳による不自然な日本語、体言止めの乱用、「〜どうぞ」「〜まで。」などの訳語調を検出し、自然な日本語に直す。コミットメッセージ、PR 説明、ドキュメント、UI 文言、ユーザーへの日本語応答を含む。
API エンドポイントの設計・実装・変更を行うとき（OpenAPI スキーマ、ヘルスチェック、ルーティング、認証方式の追加など）に参照する。OpenAPI 準拠、RFC 9457 エラー、パスバージョニング、認証（ネットワーク公開 API は Bearer、loopback サービスは Origin 検証で代替可）、Spectral リント、単一 HTTP フレームワーク（Hono / Nitro 等から選定）への統一を定義する。
| name | typescript-monorepo |
| description | 新規パッケージの追加、`turbo.json` / `pnpm-workspace.yaml` / `tsconfig` の編集、`apps/` や `packages/` の構成変更、責務パッケージ（`log` / `error` / `prompt` / `env` / `db`）の配置・参照を行うときに参照する。Turborepo + pnpm のベストプラクティス、`workspace:*` プロトコル、JIT コンパイル方針を定義する。 |
pnpm-lock.yaml のみコミットするpnpm-workspace.yaml で定義するapps/（デプロイ可能なアプリケーション）と packages/（共有ライブラリ・設定）の分離を維持するpackages/ に配置しない; NEVER: 共有ライブラリを apps/ に配置しない@<org>/ プレフィックスを持つスコープ付きパッケージ名を使用する; すべての内部パッケージは MUST: "private": true を設定するpackage.json に exports を定義する; main より exports を優先するpackages/tsconfig/ に共有 TypeScript 設定を作成する; 各パッケージは MUST: それを継承するpackages/ 配下に必ず配置する: log（ログ集約）、error（エラー集約）、prompt（AI プロンプト集約）、env（環境変数集約）、db（データベース集約）@<org>/log・@<org>/error・@<org>/prompt・@<org>/env・@<org>/db を workspace:* で依存に追加する; NEVER: 該当責務を呼び出し側で再実装しないturbo.json を作成するworkspace:* プロトコルを使用するtsc → dist/）への切り替えを明示的に要求された; THEN: 切り替えるpnpm exec turbo またはルートの devDependency を使用するpackage.json の新規作成は pnpm init または pnpm create <template> で行う; NEVER: ルート・apps/*・packages/* のいずれでも package.json をゼロから手書きしないpnpm add / pnpm update / pnpm remove で行う; IF: 対象がルート以外のパッケージ; THEN MUST: --filter <パッケージ名> で対象を指定する; IF: ワークスペース内部依存を追加する; THEN MUST: --workspace を併用して workspace:* で解決させるpnpm add -D -w <pkg> を使用するname のスコープ化、private、exports、scripts 等）に限り、コマンド生成済みの package.json へ最小限の編集を行う; NEVER: dependencies / devDependencies / peerDependencies を直接編集しない# 1. ルートワークスペース作成
mkdir my-monorepo && cd my-monorepo
pnpm init # ルート package.json を生成する
# pnpm-workspace.yaml を作成し apps/* と packages/* を定義する
pnpm add -D -w turbo typescript # ルートの devDependency はコマンドで追加する
# 2. 責務パッケージ追加（例: packages/log）
mkdir -p packages/log
(cd packages/log && pnpm init) # package.json を生成する
# name を @<org>/log に変更し、private / exports を最小限の編集で設定する
# 3. アプリ追加（例: apps/dashboard）
pnpm create next-app@latest apps/dashboard # フレームワークの scaffolder で生成する
pnpm add --filter @<org>/dashboard --workspace @<org>/log # 内部依存は workspace:* で追加する
pnpm add --filter @<org>/dashboard zod # 外部依存もコマンドで追加する