Communitygithub.com

Blueprint — 建構計劃產生器

將一個句子描述的目標轉化為逐步的建構計劃,讓任何編碼代理都能無縫執行。

Blueprint — 建構計劃產生器 是什麼?

Blueprint 是一個專為 Claude Code 設計的 Markdown 技能,能將單一目標自動分解為 3 到 12 個可獨立執行的步驟,每個步驟都包含完整的上下文摘要、任務清單、驗證指令與退出標準,確保任何編碼代理(包括不同會話的新實例)都能直接開始執行,無需依賴先前上下文。該技能透過五階段流程運作:研究(獲取專案結構與記憶)、設計(劃分步驟並指定依賴關係與模型層級)、草稿(生成自包含的計劃檔案至 `plans/` 目錄)、審查(由最強模型子代理進行對抗性檢查)、以及註冊(儲存計劃並更新記憶索引)。關鍵功能包括冷啟動執行、對抗性審查閘門、分支/PR/CI 工作流程整合、平行步驟偵測、計劃變異協定,以及零執行期風險(僅含 `.md` 檔案,無任何可執行程式碼)。它會自動偵測 git 與 GitHub CLI 的可用性,若存在則生成完整的分支與 PR 計劃,否則切換為直接編輯模式。此技能是 Everything Claude Code 套件的一部分,可透過 ECC 安裝或獨立複製到 `~/.claude/skills/blueprint/SKILL.md` 中部署。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/blueprint

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Blueprint — 建構計劃產生器 是做什麼的?

將一個句子描述的目標轉化為逐步的建構計劃,讓任何編碼代理都能無縫執行。

使用時機

  • 將大型功能拆解為多個 PR,並明確依賴順序
  • 規劃跨越多個會話的重構或遷移
  • 協調子代理之間並行工作流程
  • 任何因會話間上下文遺失而導致重做的工作

請勿使用於可在單一 PR 內完成、少於 3 次工具呼叫的任務,或當使用者說「直接做」的時候。

運作方式

Blueprint 執行一個五階段流程:

  1. 研究 — 預先檢查(git, gh auth, remote, default branch),然後讀取專案結構、現有計劃與記憶檔案以收集上下文。
  2. 設計 — 將目標分解為 3 到 12 個適合單一 PR 的步驟,為每個步驟指定依賴邊緣、並行/序列順序、模型層級(最強或預設)以及回滾策略。
  3. 草稿 — 在 plans/ 目錄中寫入一個自包含的 Markdown 計劃檔案。每個步驟都包含上下文摘要、任務清單、驗證指令與退出標準,讓全新的代理無需閱讀先前步驟即可執行任意步驟。
  4. 審查 — 將對抗性審查委派給最強模型子代理(例如 Opus),依據檢查清單與反模式目錄進行審查,在最終確定前修復所有關鍵問題。
  5. 註冊 — 儲存計劃、更新記憶索引,並向使用者顯示步驟數量與並行性摘要。

Blueprint 會自動偵測 git/gh 的可用性。若有 git 與 GitHub CLI,它會生成完整的分支/PR/CI 工作流程計劃;若無,則切換為直接模式(原地編輯,不建立分支)。

範例

基本用法

/blueprint myapp "將資料庫遷移至 PostgreSQL"

產生 plans/myapp-migrate-database-to-postgresql.md,包含以下步驟:

  • 步驟 1:新增 PostgreSQL 驅動程式與連線設定
  • 步驟 2:為每個表格建立遷移腳本
  • 步驟 3:更新儲存庫層以使用新驅動程式
  • 步驟 4:針對 PostgreSQL 新增整合測試
  • 步驟 5:移除舊的資料庫程式碼與設定

多代理專案

/blueprint chatbot "將 LLM 供應商提取為外掛系統"

產生一個計劃,其中盡可能包含並行步驟(例如,「實作 Anthropic 外掛」與「實作 OpenAI 外掛」在外掛介面步驟完成後並行執行)、模型層級指派(最強模型用於介面設計步驟,預設模型用於實作),以及每個步驟後驗證的不變量(例如「所有現有測試通過」、「核心中無供應商導入」)。

關鍵功能

  • 冷啟動執行 — 每個步驟包含自包含的上下文摘要,無需先前上下文。
  • 對抗性審查閘門 — 每個計劃由最強模型子代理依據檢查清單進行審查,涵蓋完整性、依賴正確性與反模式偵測。
  • 分支/PR/CI 工作流程 — 內建於每個步驟中,在 git/gh 缺失時優雅降級為直接模式。
  • 平行步驟偵測 — 依賴圖表識別沒有共用檔案或輸出依賴的步驟。
  • 計劃變異協定 — 步驟可分割、插入、跳過、重新排序或放棄,並附有正式協定與審計軌跡。
  • 零執行期風險 — 純 Markdown 技能。整個儲存庫僅包含 .md 檔案——沒有鉤子、沒有 Shell 腳本、沒有可執行程式碼、沒有 package.json、沒有建構步驟。安裝或呼叫時,除了 Claude Code 的原生 Markdown 技能載入器外,不會執行任何內容。

安裝

此技能隨 Everything Claude Code 一同提供。安裝 ECC 後無需單獨安裝。

完整 ECC 安裝

如果您是從 ECC 儲存庫檢出目錄工作,請使用以下指令驗證技能是否存在:

test -f skills/blueprint/SKILL.md

稍後要更新時,請先檢視 ECC 的 diff 再更新:

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # 檢視新提交後再更新
git checkout <reviewed-full-sha>          # 鎖定到特定的已審查提交

獨立廠商安裝

如果您是將此技能獨立於完整 ECC 安裝之外進行廠商管理,請將已審查的檔案從 ECC 儲存庫複製到 ~/.claude/skills/blueprint/SKILL.md。廠商管理的副本沒有 git 遠端,因此請透過從已審查的 ECC 提交中重新複製檔案來更新,而非執行 git pull。

需求

  • Claude Code(支援 /blueprint 斜線指令)
  • Git + GitHub CLI(可選——啟用完整的分支/PR/CI 工作流程;Blueprint 會偵測缺失並自動切換為直接模式)

來源

靈感來自 antbotlab/blueprint——上游專案與參考設計。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

相關技能