dsh-plugin-reviewlisted
Install: claude install-skill taxueseek/plugin-fast-adapt
# 代码审查与防御性架构车道
在插件适配或交付前,对代码进行深度架构审计。重点排查 Cordis 生命周期泄漏、单例漂移、Vendored Peer 依赖污染以及废弃 API,按统一严重度(P0/P1/P2/P3)给出明确判定。
同时定义**子 Agent 隔离委派协议(Sub-Agent Dispatch Pattern)**:当面对复杂插件或批量巡检时,主 Agent 派发独立子 Agent 执行重型静态分析与冒烟,仅回传结构化紧凑报告(`<20` 行),避免海量日志填满主会话上下文。
以下命令都相对工具根目录执行,工具根即本文件真实路径往上两级、含 `scripts/` 的那一层。脚本用自身文件的绝对路径定位,不必先 cd。`<插件目录>` 指被查插件的仓库根。
## 第一步:会话内极速体检
```sh
node scripts/plugin-audit.mjs <插件目录> --compact
```
使用 `--compact` 参数时,脚本仅输出高密度结构化 JSON 摘要与关键结论,屏蔽全量文件遍历噪音:
```json
{
"plugin": "my-plugin@1.0.0",
"overallScore": 95,
"scores": { "performance": 100, "resilience": 90, "contextBudget": 100, "lifecycle": 90 },
"priorityCounts": { "P0": 0, "P1": 1, "P2": 0, "P3": 0 },
"blockers": [
{
"priority": "P1",
"dimension": "lifecycle",
"file": "lib/index.js",
"title": "事件监听或定时器未绑定清理逻辑",
"detail": "Cordis 插件重载时未清理的监听器与定时器会泄漏,建议注册进 ctx.effect 或提供 dispose。"
}
]
}
```
## 第二步:子 Agent 隔离委派协议(Sub-Agent Dispatch Pattern)
当审查整个插件仓库或运行全流程适配验证时,主 Agent 应按以下协议委派后台子 Agent:
1. **派发子 Agent**:通过 `subagent`(或需要继承本会话上下文时用 `subagent_fork`)唤醒子 Agent,指定只读工作区;需要长期跟进时给它一个 `name`,后续用名字寻址;
2. **执行紧凑流水线**:
```sh
node scripts/run.mjs <插件目录> --compact
```
3. **回传协议**:子 Agent **严禁**直接复制全量调试日志或终端文本到父会话,必须提炼为以下三段式紧凑摘要返回:
- **通过性总账**:宿主版本、窗口、体检分(各维度分)、冒烟与 typecheck 状态;
- **阻断项账本**:仅列出 `P0`(致命阻断)与 `P1`(严重缺陷)条目(文件 + 标题 + 根因);
- **下一步行动**:具体的修改建议(如 peer 替换、dispose 补充、模板变量清理)。
4. **主 Agent 决策**:主会话上下文保持清爽,主 Agent 仅依据紧凑报告决定修改代码或交付用户。
**寻址用名字或 Se