代码交接洞察
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_32dfb39b/hands-on。
技能介绍
交接时真正缺的是什么
新人接手模块时,README 往往只描述「怎么用」,却很少标出隐式依赖、耦合点和一改就炸的分支。口头交接容易漏掉缓存未命中时的请求路径、全局 cache 的生命周期,或与上游约定但未写在类型里的字段。你需要的是一份面向「敢不敢改」的地图,而不是逐行导读。
技能如何工作
该技能把模型约束成有十年经验的技术负责人:输入一段代码,输出固定结构的 JSON,而不是散文式讲解。
module_insight:purpose说明模块职责,core_logic列出关键流程,usage概括典型调用场景。risk_map:high_risk逐条给出风险点与原因;code_smells收录坏味道,便于后续重构排期。change_guide:safe_changes与danger_changes分开,直接回答「动哪里相对安全、动哪里会连带下游」。
分析原则写死在提示里:优先找风险、找隐式依赖与耦合、结论必须落到具体代码行为(例如 cache[id] || fetch(...) 这类短路逻辑),避免泛泛的「要注意性能」。
适用边界
它针对单段或局部代码做交接视角的扫雷,不能替代全仓库的架构文档、依赖图或集成测试。若输入缺少上下文(配置、部署、数据模型),danger_changes 可能只能标出代码内可见的风险,跨服务契约仍需你补充材料。适合作为 PR 说明、交接清单或重构前的结构化附录,而不是单独作为合规或安全审计报告。
使用场景
- 离职前把 `getUser` 这类缓存+请求封装交给同事,需要标出缓存未命中与并发下的行为差异
- Review 老模块 PR 时,要求助手按固定 JSON 列出高危点与安全可改区域,便于写入交接文档
- 接手遗留服务的一段路由处理代码,要在不改业务的前提下先弄清哪些分支不能动
- 重构前对单个工具函数做扫雷,把隐式全局依赖写进 `risk_map` 再排期
适合人员
- 负责组员离职交接、要把口头经验变成可检索风险清单的后端 Tech Lead
- 维护遗留 Node/JS 服务、每周处理「这段能不能改」类问题的接手工程师
- 写内部交接 Wiki 的技术写作者,需要把代码片段自动整理成模块目的与改动边界
- 带新人做 Code Walkthrough 的 Mentor,希望每次讨论都产出同一套 `change_guide` 结构