GerardoRdz96/deepfork

``` you: /deepfork https://github.com/karpathy/micrograd — but in TypeScript, with a graph visualizer agent: ⚖️ license gate ........ MIT ✓ 🕸️ knowledge graph ..... 55 nodes · 86 edges · god nodes: Value, Neuron, Layer, MLP 🧠 UNDERSTANDING.md .... the repo, explained clean — load-bearing pieces, data flow, the core trick 📐 BLUEPRINT.md ........ a spec you could build from without ever seeing the source 🔨 rebuild/ ............ your TypeScript version, clean-room, tests first ``` ## ⚡ 安装 适用于 **Claude Code**（以及任何支持读取 [skills](https://github.com/anthropics/skills) 的 agent）： ``` npx skills add GerardoRdz96/deepfork ``` 🕸️ 可选但推荐——让理解阶段变得无比强大的图谱引擎（[graphify](https://github.com/safishamsi/graphify)，65k★）： ``` uv tool install graphifyy # double-y! code analysis is local & free (tree-sitter) ``` 如果不使用 graphify，DeepFork 将回退到手动仓库映射。如果使用：可以进行 god-node 检测、自动命名子系统、意外关联分析，以及 token 消耗极低的图谱查询。 ## 🎁 你能得到什么 | | 产物 | 这是什么 | |---|---|---| | 🧠 | **`UNDERSTANDING.md`** | 以你最希望官方文档采用的方式来解释该仓库：5 个核心承重模块，每个子系统，一个端到端追踪的请求，以及非显而易见的耦合。每项断言都标有 `[VERIFIED]`（已验证）或 `[INFERRED]`（推测）。 | | 📐 | **`BLUEPRINT.md`** | 一份行为规范——包含机制、契约、构建顺序、测试策略——以及**你的自定义差异**。即使是没有见过原始代码的人也能据此构建。这个人就是你的 agent。 | | 🔨 | **`rebuild/`** | 你的版本。净室开发：在关闭原始源代码的情况下，完全根据蓝图构建。自带 `ATTRIBUTION.md`。 | ## 🗺️ 工作原理 ``` flowchart LR A["⚖️ Phase 0
License gate"] --> B["📥 Phase 1
Acquire"] B --> C["🕸️ Phase 2
Comprehend
graph · god nodes · subsystems"] C --> D["🔎 Phase 3
Interrogate
verify the load-bearing claims"] D --> E["📐 Phase 4
Blueprint
+ YOUR deltas"] E -.->|"only behavior crosses
🧱 the clean-room wall"| F["🔨 Phase 5
Rebuild
original closed · tests first"] ``` 1. **⚖️ 许可证关卡** — 在进行任何操作之前先进行 SPDX 检查；无许可证的代码永远不会被重新构建。 2. **🕸️ 理解** — graphify 构建知识图谱（在本地运行，对代码完全免费）；该 skill 将 god nodes、社区和意外关联转化为 `UNDERSTANDING.md`。 3. **🔎 审查** — agent 回答重新构建者必须了解的问题（核心技巧、契约、在 10 倍规模时会崩溃的问题），并根据真实代码验证推断出的结论。 4. **📐 蓝图** — 询问你需要什么不同的改动，然后编写融合了你差异设计的规范。 5. **🔨 重新构建** — 全新仓库，关闭原始代码，仅依据蓝图，测试驱动。 ## 📚 实战案例 [`examples/micrograd/`](examples/micrograd/) — karpathy 的 micrograd（12k★）端到端 deepfork 示例： - 🧠 [`UNDERSTANDING.md`](examples/micrograd/UNDERSTANDING.md) — 通过 6 个章节解释自动求导引擎，基于真实的 55 节点图谱运行生成（$0） - 📐 [`BLUEPRINT.md`](examples/micrograd/BLUEPRINT.md) — “gradflow”：TypeScript + 内置可视化器的重新构建规范 ## 🛡️ 为什么采用净室开发？ DeepFork 的设计旨在让你在开源世界中始终保持合规： - ⚖️ **阶段 0 许可证关卡** — 首先检查目标的许可证；拒绝重新构建无许可证的代码。 - 🧱 **蓝图防火墙** — 只有*行为描述*会从原始项目传递到你的重新构建版本中。绝对不包含代码。你的实现是原创作品。 - 🔓 **Copyleft 意识** — 针对 GPL/AGPL 目标会发出警告，并建议你的重构版本保持开源。 - 🙏 **默认署名** — 每次重新构建都会标明对原始设计的引用。 这就是几十年来工程师们在法律允许范围内重新实现系统的标准方式（Compaq 诉 IBM BIOS 案，1982 年）。DeepFork 只是让这种规范变得自动化了。 ## ❓ 常见问题

这只是普通的“fork”吗？

不。一次*浅层* fork 会保留他们的代码、架构、语言和技术债务。DeepFork 在规范中为你提供他们的< i>经验教训，以及一个真正属于你自己的版本。

这合法吗？

理解公开代码在任何地方都是合法的。基于行为规范的净室重新实现是行业标准且合法的途径。许可证关卡 + 蓝图防火墙确保了这一过程的严谨与诚信。（这不构成法律建议；如果你要重新构建具有商业敏感性的内容，请咨询律师。）

它能在超大型仓库上运行吗？

能——从社区列表中选择一个子系统，然后对该子系统进行 deepfork。知识图谱能让你清晰地看到子系统的边界。

支持哪些 agent？

头等支持 Claude Code。该 skill 是纯 markdown 编写的——Codex、Cursor、Gemini CLI 等工具也可以运行它。

标签：SOC Prime, 云资产清单, 代码生成, 净室设计, 开发工具, 渗透测试工具, 逆向工具, 逆向工程, 防御加固