Blackbox Dev — AI skill for Claude Code

乐高黑盒 · blackbox-dev

AI Coding 时代的完整产品与软件开发框架。 **让产品的每一块都可以被独立替换、删除、新增——不动其他块。**

一个以 [Agent Skill](https://docs.claude.com/en/docs/claude-code/skills) 形态封装的设计哲学与项目管理框架。它不是又一套"模块化"口号，而是一组可递归落地的判断动作——当 AI 写代码近乎免费、重构可以无限重来时，真正稀缺的是**边界清不清、契约稳不稳**。

为什么需要它

维度	传统软工	AI Coding 时代
核心动作	前期把问题想清楚	前期把契约划清楚，"想清楚"交给演化
好架构定义	设计是否完美	换一个模块的成本是多少
代码价值	资产	负债（生成廉价、维护昂贵）
主要风险	选错	契约划错 / 没划清

设计目标不是"一次想清楚"，而是"让系统能在 AI 协助下持续重写、重构、自然演化"。

核心：5 问骨架

同一组问题递归应用到**项目 / 业务 / 数据 / 代码 / Prompt** 五层：

1. 原始事实是什么？ —— 不可派生、必须由人决定的源头
2. 派生有哪些？ —— 从原始事实推导出的产物（可由 AI 重生成）
3. 观察有哪些？ —— 边做边沉淀的判断（可能过时，需带 staleness）
4. 模块边界在哪？ —— 独立替换的最小单位
5. 契约写在哪？ —— 机器/人可读的固定位置（让陌生 Agent 能找到）

这套问题答完，该层的乐高骨架就有了。回答不出来 → 设计还没就绪。

适用场景

讨论新产品/功能设计、设计数据结构、写代码（模块边界/接口/技术选型）、评审 AI 生成的代码或架构、重构现有系统、启动新项目、接手存量项目时加载。

安装

作为 Claude Code / Claude Agent 的 skill 使用：

git clone https://github.com/eze-is/blackbox-dev.git ~/.claude/skills/blackbox-dev

加载后由 skill 自身的 description 自动触发，无需手动引用。

结构

blackbox-dev/
├── SKILL.md                              # 主框架（lean，按需加载 references）
└── references/
    ├── application-domains-detail.md     # 各应用域详细决策框架/陷阱/成功标准
    ├── case-studies.md                   # 具体案例（CC tool system / memory / 数据层契约等）
    └── intellectual-roots.md             # 业界思想根基与参考来源

作者

**一泽Eze** · 中文社区里"乐高黑盒"方法论的提出者。

skill 的复利机制：**用得越多越锐利**。欢迎在 issue 区交流落地经验。