逆向重建循环 mulqizamzam/mulqi--reasll

Mulqi ReaSLL

DeepSeek Harness (DSH) 插件，把技能 Reverse Engineer Anything with a Self-Learning Loop 带进 DSH 会话：研究你有权重新构建的产品，构建你自己的版本，用证据评审，补齐差距，然后反复迭代，直到写明的检查清单 100% 通过。

移植自 Speedrunlab/reverse-engineer-anything-self-learning-loop（MIT，Speedrun AI Labs，commit a0b4f1e）。方法完整保留；在 1.0.2 中 Section 0 改为可选录入，并相应调整了四个文件（见源文件完整性）。

MIT · 目标 DSH 0.2.1-rc.2 · 无依赖 · 无构建步骤

| 插件名 | Mulqi ReaSLL |
| 包名 | mulqi-reasll |
| 插件版本 | 1.0.2 |
| 源技能版本 | 1.0.1（上游） |
| 注册技能名 | reverse-engineer-anything-self-learning-loop |

目录

- 这是什么
- 环境要求
- 在 DSH 中安装
- 使用方法
- 技能工作流
- 仓库结构
- 源文件完整性
- 开发与测试
- 故障排查
- 许可证与署名

这是什么

DSH 有一套技能系统：一组指令，任务匹配时由智能体加载。原仓库是 Claude Code 风格的技能（SKILL.md + references/ + templates/）。本插件把它重新打包，以便作为 DSH bundle 安装，并做了一处有意的改动：Section 0 现在是可选录入，而不是授权门槛。

有三点需要理解：

1. 本插件不新增工具。 它只向 ctx.skills 注册一个技能。
2. 技能名与插件名不同。 智能体调用的是 reverse-engineer-anything-self-learning-loop；mulqi-reasll 是包名。
3. 录入是建议，不是强制。 技能会把目标、权限依据（如有）、构建边界、完成定义、模式、数据处理记录到 run ledger。记录完整，结果就可审计；没有记录也不妨碍开始。

环境要求

| 要求 | 说明 |
| DeepSeek Harness | >=0.2.1-rc.2 <0.3.0 |
| Node.js | >=22.19.0 |
| DSH 配置档 | 任一配置档，例如 web |

无运行时依赖。无构建步骤。入口模块是普通 ESM。

在 DSH 中安装

方式 A — 从 GitHub 仓库安装

dsh plugin --profile web add github:mulqizamzam/mulqi--reasll

把 web 换成你的配置档名。这条命令会把 mulqi-reasll 添加为配置档依赖，并自动注册到 dsh.profile.bundles —— 你不需要编辑 YAML。

方式 B — 从本地克隆安装

git clone https://github.com/mulqizamzam/mulqi--reasll.git
cd mulqi--reasll
dsh plugin --profile web add .
想阅读或修改技能内容的话，这样正合适。

验证

dsh --profile web --dump-config | grep -A2 "== mulqi-reasll"

正确时会显示：

== mulqi-reasll
- id: mulqi-reasll
name: mulqi-reasll

最后，启动新的 DSH 会话。技能在启动时注册，所以正在运行的会话还看不到它。

卸载

dsh plugin --profile web remove mulqi-reasll

更详细的指南，包括从旧包名迁移，见 HOWTOUSE.md。

用法

这个技能补充的是知识，不是命令。有两种用法。

1. 让智能体自己选

智能体会看到技能列表和简短描述。你提出的需求正好匹配时——比如「重建源码已丢失的内部工具」——它就会加载这个技能。

2. 显式调用

用 reverse-engineer-anything-self-learning-loop 技能重建这个报表解析器。

你需要准备什么

这个技能不会在 intake 完整之前拦住你。建议先记下这些：

- 你有权重建的产品；
- 权限依据（如有）：自有、许可证或书面许可——自己单干？把自己记为 approver，并写明理由；
- 范围：哪些算在内，哪些不算；
- 可写的工作目录；
- 用于 live 步骤的独立分析环境（理想情况是一次性 VM）。

还不知道的内容在 run ledger 里记为 unknown，不要靠猜测填写。intake 的意义在于让工作边界明确，结果可审计。

技能工作流

简要说明——完整细节在技能内部：

1. 检查（references/examine.md）——static-first，不复制受保护的表达。
2. 写出 100% 定义（templates/parity-checklist.md）——build 之前你必须确认的清单。
3. 构建——先做 walking skeleton，再填充。
4. 带证据评审（references/review.md）。
5. 记录缺口和计划（templates/gap-report.md、templates/iteration-plan.md）。
6. 修复（references/fix-recipes.md）。
7. 重复，直到清单通过；每次迭代都记到 templates/run-ledger.md。

仓库结构

mulqi-reasll/
├── index.js Plugin Cordis: registrasi provider skill
├── cordis.patch.yml Layer patch bundle DSH
├── package.json Manifest paket
├── README.md Dokumen ini
├── HOWTOUSE.md Panduan pasang dan pakai
├── CHANGELOG.md Riwayat rilis plugin
├── LICENSE MIT (identik dengan lisensi upstream)
├── assets/ Salinan runtime — dibaca saat ctx.skills.get()
| ├── SKILL.md
| ├── references/ examine, fix-recipes, learning-loop, parity-checklist, review, dsh-notes
| └── templates/ gap-report, iteration-plan, parity-checklist, run-ledger
├── vendor/upstream/ 来源只读 —— 从不执行 ├── docs/
| ├── SOURCE-MANIFEST.md 源到目标的清单（供人阅读）
| ├── source-manifest.json 源到目标的清单（供机器读取）
| └── RECONCILIATION.md 核对报告
├── scripts/validate.mjs 自动校验完整性 └── tests/ 集成测试 + 完整性测试

技能内容故意存了两份，两者角色不同：

- assets/ —— 运行时唯一读取的副本。resourceBase 指向这里，所以技能正文里的 references/… 和 templates/… 链接不用改写就能解析。
- vendor/upstream/ —— 上游的完整快照。不执行、不注册、智能体也访问不到。它的用途是审计，以及在 DSH 之外复用这套方法。

校验器会确认两份内容彼此一致。十三个文件里有九个与上游 a0b4f1e 逐字节相同；四个文件在本地有意改过（Section 0 改成可选的 intake），vendor 快照也同步更新了。

源文件完整性

源仓库在提交 a0b4f1ecff591100d207ddcc799bcb5bb769f031 上有 13 个文件。它们全都在本仓库里：

| 处置方式 | 数量 | 位置 |
| 可执行（运行时读取） | 10 | assets/ + vendor/upstream/ |
| 参考（不执行） | 3 | vendor/upstream/（+ 根目录的 LICENSE） |
| 与上游 a0b4f1e 逐字节相同 | 9 | assets/ + vendor/upstream/ |
| 有记录的本地差异 | 4 | assets/ + vendor/upstream/（见下文） |
| 删除 / 排除 | 0 | — |

逐文件明细（含 sha256 和处置理由）见 docs/SOURCE-MANIFEST.md。决策摘要见 docs/RECONCILIATION.md。

1.0.2 在本地改了四个文件，让 Section 0 不再阻塞流程： SKILL.md、references/examine.md、references/review.md 和 templates/run-ledger.md。这四个文件在 assets/ 和 vendor/upstream/ 里存的是同一份字节，所以运行时副本和来源副本保持一致；上游哈希和本地哈希并排记录在 docs/SOURCE-MANIFEST.md。其余九个文件仍与 a0b4f1e 逐字节相同。

另外，有一处转换发生在读取时，而不是保存时：index.js 会去掉 SKILL.md 开头的 YAML frontmatter 块，再用程序方式提供同样的元数据。磁盘上的文件保持原样。

开发与测试

npm run check

会跑两件事：

1. node scripts/validate.mjs —— 检查清单、哈希、目标、assets/ 与 vendor/upstream/ 是否一致、包的一致性，以及 SKILL.md 引用的链接。
2. node --test tests/*.test.js —— 把插件加载进真实的 DSH 技能注册表。

集成测试会在 /home/administrator/deepseek-harness 找 DSH 检出目录。路径不同就用 DSH_ROOT 指定：
DSH_ROOT=/path/to/deepseek-harness npm test

找不到 checkout 时，集成测试会跳过，不会失败。

如果你改了 assets/ 的内容，记得同步更新 vendor/upstream/ 和 manifest——否则校验器会拒绝。这是有意为之：防止运行时副本与来源之间出现无声漂移。

故障排查

| 现象 | 原因 | 处理 |
| 技能没有出现在会话里 | 技能在启动时注册 | 开新会话，或重启应用 |
| dsh plugin add 被拒，提示 engines.dsh 不满足 | DSH 版本超出范围 | 升级 DSH；没搞清风险前不要强行豁免 |
| --dump-config 显示 dsh-reasll | 配置档里还挂着旧包 | dsh plugin --profile <nama> remove dsh-reasll，再重新 add |
| 智能体中途停下发问 | 工作边界还没记录 | 在 run ledger 里填 intake（目标、权限、构建边界、模式），然后继续 |
| npm run check 在 hash 部分失败 | assets/ 和 vendor/upstream/ 不一致 | 把两边同步，或确认改动是有意的之后更新 manifest |

许可与署名

MIT。

- 方法、参考与模板：Speedrunlab/reverse-engineer-anything-self-learning-loop，MIT，Speedrun AI Labs，commit a0b4f1ecff591100d207ddcc799bcb5bb769f031。
- DSH 打包：mulqizamzam。

来源许可原文保留在 LICENSE 和 vendor/upstream/LICENSE 中。