SuperAPI AI 工具集

crank-deepen

前端与建站

查看项目

更新于 10-15 20:12

技能介绍

用途:在既有代码库中识别架构摩擦并提出“加深”机会,即把浅模块改造为深模块,目标是提升可测试性与可导航性,而非整齐美观。流程为:确定范围 → 并行探查 → 生成候选的可视化 HTML 报告 → 针对用户选中的一个候选进行追问 → 输出简报,交由 crank 流水线路由到规格阶段。报告供用户阅读,简报供流水线读取。

主要能力:用 git log --name-only 回溯历史热点以推断范围;按热点或代码结构划分 1–4 个只读探查器;识别四类摩擦:浅模块(用删除测试判断复杂度是集中还是扩散)、接缝泄漏、为可测试性抽取却缺乏局部性、无法经接口测试;每个候选返回文件、摩擦类型、删除测试结论、file:line 证据、问题与解决方案;汇总去重排序后渲染为自包含 HTML 报告,输出到 ${TMPDIR:-/tmp}/deepen-report-<timestamp>.html 并用 open(macOS)、xdg-open(Linux)、start(Windows)打开;追问覆盖约束、依赖、模块形状、接缝背后内容、存活的测试,可提议将术语写入 CONTEXT.md 或记录 ADR;必要时并行派发 2–3 个重载子代理做“设计两次”的接口方案对比;最后将简报写入 .crank/<slug>/deepen-brief.md,事实存入 .crank/<slug>/grounding.md。

限制:目标仓库只读,不执行重构;报告仅作展示,不作为事实来源;每次追问循环只处理一个候选;追问前不提出接口;追踪树中仅允许经用户批准的两个副作用(写入 CONTEXT.md 的术语、提供的 ADR);不写验收标准;下一步由用户启动,推荐命令为 /crank spec .crank/<slug>/deepen-brief.md。