jpskill.com
🛠️ 開発・MCP コミュニティ

black-tortoise-agent-architecture-quality

企業レベルのシステム設計と品質基準に基づき、高凝集・低結合、単一責任、オッカムの剃刀、Signals-firstの原則を強化するSkill。

📜 元の英語説明(参考)

企業級結構與品質守則，強化高內聚低耦合、單一職責、奧卡姆剃刀與 Signals-first。Use when reviewing code for architecture violations, enforcing DDD boundaries, or ensuring quality standards in Black-Tortoise project.

🇯🇵 日本人クリエイター向け解説

一言でいうと

企業レベルのシステム設計と品質基準に基づき、高凝集・低結合、単一責任、オッカムの剃刀、Signals-firstの原則を強化するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o black-tortoise-agent-architecture-quality.zip https://jpskill.com/download/6839.zip && unzip -o black-tortoise-agent-architecture-quality.zip && rm black-tortoise-agent-architecture-quality.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/6839.zip -OutFile "$d\black-tortoise-agent-architecture-quality.zip"; Expand-Archive "$d\black-tortoise-agent-architecture-quality.zip" -DestinationPath $d -Force; ri "$d\black-tortoise-agent-architecture-quality.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して black-tortoise-agent-architecture-quality.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → black-tortoise-agent-architecture-quality フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Black-Tortoise Agent アーキテクチャ＆品質スキル

使用時機

  • アーキテクチャ/設計レビューまたはリファクタリングを行う際、階層と品質ルールを確認する必要がある場合。
  • PR前の構造的な健全性チェックで、高リスクな違反（層をまたぐ依存関係、肥大化したインターフェース、重複する抽象化、RxJSの状態管理）に焦点を当てる場合。

作業ステップ（最小化）

  1. 規範の特定: docs/INDEX.md に従って対応する AGENTS.md / README.md を読み込み、階層の境界と禁止事項を特定します。
  2. 分解/順序付け: sequentialthinking/* を使用して、レビュー項目と優先順位を一度にリストアップします。
  3. 検証:
    • API/フレームワーク: context7/*（解決 → ドキュメント取得を1サイクル）。
    • CLI/スキーマ: angular-cli/*。
  4. 品質スキャン: 必要に応じて codacy/* から重大/高優先度の課題を取得します。
  5. 判断原則:
    • 高凝集度・低結合度；単一責任；インターフェースの最小露出。
    • オッカムの剃刀：余分な抽象化/階層の削除；過剰な設定の回避。
    • Signals-first；RxJSの状態管理の禁止；as any の禁止。
    • 階層の一方向性：Presentation → Application → Domain → Infrastructure。
  6. 成果物:
    • 仮定/リスク → 問題リスト（ファイルリンクを含む）→ 最小修正ステップ → 検証推奨事項（lint / architecture:gate / tests）。

MCP ループ防止

  • 同じ課題に対して同じMCPは一度だけ呼び出します；新しい情報がなければ停止します。
  • context7：resolve-library-id → get-library-docs を一度で完了します。
  • Software-planning-mcp：計画の更新が必要な場合にのみ start_planning / save_plan を一度使用します。
  • sequentialthinking：最初の分解/順序付けに使用し、同じステップで再入しません。
  • agent/runSubagent をネストまたは再帰的に呼び出しません。

禁止事項

  • 能力をまたぐ深いimport、逆方向の依存関係、肥大化したインターフェース、重複する抽象化。
  • RxJSの状態管理または as any の導入。
  • 「大規模な変更」による最小修正の置き換え；削除可能性を損なってはなりません。

例文入力

  • 「overview capability の最近の変更をレビューし、高結合点と最小修正をリストアップしてください」
  • 「tasks store をリファクタリングし、Signals-first を確保し、インターフェースの露出を減らしてください」
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Black-Tortoise Agent Architecture & Quality Skill

使用時機

  • 進行架構/設計審視或重構時，需確認層次與品質守則。
  • PR 前的結構 sanity check，聚焦高風險違規（跨層依賴、肥介面、重複抽象、RxJS 狀態）。

作業步驟（最小化）

  1. 定位規範：依 docs/INDEX.md 讀取對應 AGENTS.md / README.md，鎖定層次邊界與禁止事項。
  2. 拆解/排序：sequentialthinking/* 單次列出審查項目與優先序。
  3. 查證：
    • API/框架：context7/*（resolve → get docs 一輪）。
    • CLI/schema：angular-cli/*。
  4. 品質掃描：必要時 codacy/* 取嚴重/高優先議題。
  5. 判斷原則：
    • 高內聚低耦合；單一職責；介面最小暴露。
    • 奧卡姆剃刀：刪除多餘抽象/層級；避免過度設定。
    • Signals-first；禁 RxJS 狀態；禁止 as any。
    • 層次單向：Presentation → Application → Domain → Infrastructure。
  6. 產出：
    • 假設/風險 → 問題清單（含檔案鏈結）→ 最小修正步驟 → 驗證建議（lint / architecture:gate / tests）。

MCP 防迴圈

  • 同議題對同一 MCP 只呼叫一次；無新資訊即停。
  • context7：resolve-library-id → get-library-docs 一次完成。
  • Software-planning-mcp：僅在需要計畫更新時使用 start_planning / save_plan 一次。
  • sequentialthinking：初次拆解/排序用，不在同一步重入。
  • 不巢狀或遞迴 agent/runSubagent。

禁止事項

  • 跨能力深層 import、逆向依賴、肥介面、重複抽象。
  • 引入 RxJS 狀態管理或 as any。
  • 以「大改」取代最小修正；不可破壞可刪除性。

範例輸入

  • 「審查 overview capability 最近改動，列出高耦合點與最小修正」
  • 「重構 tasks store，確保 Signals-first 並降低介面暴露」