用途:把一个外部系统逆向拆解为两部分——teardown(证据:功能清单、可机器校验的注册表与规范,可选安全审计)和 steal-map(决策:哪些能力纳入我方、哪些留在外面)。仅对拥有或获得明确书面授权的代码/二进制运行,避免在未授权情况下拆解;不提供绕过保护或减少服务条款、提取专有源码/系统提示的步骤。
主要能力与证据规则:每项能力须按来源打标签。code:其源码、二进制或拆解注册表可见,引用 file:line 或注册表条目并记录实际行为;docs:仅 README、文档页或公告声称,未验证;hosted:无法检查的服务或控制面。无代码访问则不能 steal,只能标为 gap、park 或 reject。我方侧要引用现有文件,缺失项须附证明搜索命令与范围。事实由代码并交叉复核,不采信单一上下文总结。steal 的是模式,不是平台,不用照搬其运行时或存储。
使用方式:先跑脚本做 teardown(带授权克隆或二进制):python3 skills/reverse-engineer/scripts/reverse_engineer.py <product> --mode=repo --upstream-repo="https://github.com/org/repo.git" --upstream-ref=v1.0.0 --output-dir=".agents/scratch/reverse-engineer/<product>/" 。二进制模式需 --authorized。无代码时手写清单与 steal-map,标注 docs/hosted 并说明无校验器运行。然后由调用者撰写 steal-map,每行恰好一个判定:have、steal、gap、park、reject。判定冲突时 reject 优先于 park,park 优先于 steal/gap。单向门采纳交 Plan 处理,不在此决定。最后用 validate-output.sh 校验完整输出:bash skills/reverse-engineer/scripts/validate-output.sh --output-dir "$output_dir" --phase complete --security-audit "$security_audit" --sbom "$sbom" --upstream-ref-set "$upstream_ref_set" 。
限制:需授权;不输出重构的专有源码或嵌入式提示(仅索引并在报告中脱敏);遇到密钥/令牌须脱敏并跑秘密扫描门;脚本只完成 Phase 1 校验,无法判断我方现状;无代码时无法使用完整校验。