6.3 KiB
6.3 KiB
技能库深度扩充设计(深度波)
日期:2026-08-25 状态:已获用户批准(2026-08-25 逐节确认)
1. 总览
目标:给现有全部技能加深度——薄技能正文扩写至基线 + 全部技能按类型配 references/ 深度文件(每技能 2 个)。
已确认决策:
- 形态:两者结合(正文扩写 + references/ 深度文件)
- 范围:分层滚动(T1/T2/T3,网关正文不动)
- 粒度:按技能类型多文件(每技能 2 个,主题命名)
- 流程:样板先行(2 个样板定调后批量)
- 实现方案:A(类型映射表 + 技能簇任务)
范围:112 个现有技能(v4 的 6 新技能 + re-rtos/re-behavior 标注「待 v4 落地后套用」,不在本设计内重复设计)。技能计数不变:112(v4 落地后 118)。深度文件总量约 220 个。
2. 分层范围
| 分层 | 判定 | 产出 | 规模 |
|---|---|---|---|
| T1 | 原子技能 SKILL.md <100 行 | 正文扩写至 ~130 行基线 + 2 个深度文件 | 约 18 技能 |
| T2 | 原子技能 100-130 行 | 正文适度补强(补缺章/示例/坑,无硬基线)+ 关键者配深度文件 | 48 技能 |
| T3 | 原子技能 >130 行 | 只补深度文件(尚无者) | 约 33 技能 |
| 网关(12+1) | 编排器设计使然 | 正文不动(re-analyze 已有 references/ 不动) | 13 |
行数按 2026-08-25 实测(wc -l .claude/skills/*/SKILL.md,中位 99 行;86-130 行共 62 个)。T1/T3 为约数,精确清单由实施计划首个任务(映射表)产出并确认。
关键者判定规则(T2 内):跨域引用数 ≥ 2,或被网关子技能清单 / triage 路由直接引用,或与 T1 相邻主题(如 re-rtos 与 T1 的 re-tee 同簇)。
3. 类型-文件集映射
每技能 2 个 references/ 文件,主题命名对齐 frida-scripts.md 惯例;[[链接]] 目标 = 文件名去扩展名(validate 既有支持)。
| 类型 | 文件集 | 内容骨架 | 代表技能(示例) |
|---|---|---|---|
| 工具类 | commands.md + gotchas.md |
命令速查/常用操作序列/组合套路;工具特有坑/版本差异/边界 | ghidra / ida / radare2 / gdb / lldb / x64dbg / windbg / binaryninja / angr / z3 / netcap / frida / tracing / sandbox / ti / sdr / mem-forensics / emulation / fw-emulate / plugin-dev / apk(jadx/apktool 为主) |
| 格式类 | layout.md + examples.md |
结构图/字段表/布局与偏移;最小解析示例/字节样例/字段对照 | format-pe / format-elf / format-macho / wasm / cpp-abi / go / rust / nim / zig / swift / fp-runtime / flutter / hybrid-app / harmonyos / python / dotnet / java / rtos / mips / uefi / crypto-id / blockchain / drm / whitebox / mobile-pack |
| 方法论类 | decision-tree.md + gotchas.md |
场景决策树/分支逻辑/证据分级;方法论坑/边界/反例 | behavior / hunting / attribution / proto-rev / ioc / anti-cheat / evasion / fileless / ransomware / loader / doc-malware / browser-ext / keygen / license / patching / variant / deobfuscate / unpack-simple / unpack-advanced / stego / fuzzing / crash-triage / exploit / pwn / shellcode / kernel / hypervisor |
| 领域混合类 | 取主类型文件集 | 判定规则:按技能主属性归类(场景为主取主类型;工具密集取工具类) | ics / iot-proto / automotive / hardware-io / hw-chip / tee / game / macos / ios / ios-jb / android-native / mobile-forensics / disk-forensics / memdump / triage / fw-extract / fw-rootfs / crypto-decrypt / crypto-keys / a-model / a-attack / stego 等 |
完整映射表(112 技能 → 类型 × 分层 → 所属簇任务)由实施计划首个任务产出并确认,本设计定规则与形态。
4. 任务结构
任务队列(每任务 = 实现 → 事实核验(必要时 web)→ 红线对照 → npm test → commit 只 add 本任务文件):
- 映射表任务:产出 112 技能的类型×分层映射表(设计附录,供后续任务引用)
- 样板任务:re-x64dbg(工具类)+ re-format-elf(格式类)完整深度产出 → 提交后用户审阅定调
- T1 批次(约 18 技能 → 4-5 个簇任务):正文扩写至 ~130 行基线 + 2 个深度文件;簇按「类型 × 主题相邻」划分(如 T1 工具类簇、T1 格式类簇…)
- T2 批次(48 技能 → 10-12 个簇任务):正文补强 + 关键者(判定规则见第 2 节)配深度文件
- T3 批次(约 33 技能 → 6-7 个簇任务):只补深度文件
- re-rtos / re-behavior:深度产出放队列末尾(v4 落地后套用)
- 终审波:全库 references 死链/计数/事实抽查/红线对照
样板审阅要点:正文扩写密度与风格、深度文件骨架与命名、命令/示例颗粒度;定调后批量任务按样板同构执行。
5. 质量闸口与验证
- validate.mjs:references/*.md 文件名(去扩展名)为合法
[[链接]]目标;SKILL.md[[链接]]必须解析(深度文件内引用其他技能必须指向存在目标) - 正文扩写不破坏 frontmatter(
name=目录名、description非空、type: atomic必含「## 工具准备」)与固定五节结构 - 事实核验:命令/字段/格式断言以官方文档为准(命令必须可执行;字段名以本机输出验证的写法沿用仓库惯例);抽查机制进终审波
- 红线:呈现中性(禁「最推荐/强烈建议」)/ 隐私脱敏(不指具体项目/公司/产品)/ 不绑定具体工具(跨 OS 安装命令)
- 每任务
npm test;深度波不改技能计数(112 → v4 后 118 由 v4 负责)
6. 与 v4 并行协调
- 两个计划独立任务队列、独立 commit、独立评审
- 文件集隔离:v4 只碰 6 新技能目录 + re-rtos/re-behavior/triage/rerouting/计数文件;深度波只碰其余约 104 个现有技能的 SKILL.md 与 references/(re-rtos/re-behavior 深度产出在 v4 落地后套用)
- 并行执行方式:两计划均按 subagent-driven-development 思路推进(计划内任务串行、两计划间并行),git 冲突面为零
- 计数同步只由 v4 负责;深度波每任务
npm test输出一致
7. 产出物清单
- 约 220 个 references/ 深度文件(commands/gotchas/layout/examples/decision-tree)
- 约 80 个 SKILL.md 正文扩写/补强(T1 全量 + T2 适度)
- 映射表设计附录(112 技能 × 类型 × 分层)
- 技能计数保持 112(v4 后 118)