软件工程
绘制代码变更的影响半径
变更影响图,沿调用方、依赖、数据、部署、测试和客户路径跟踪拟议差异,在实施前揭示隐藏后果。
流程
按这个顺序做。
- 界定拟议变更、基准与目标修订、预期结果、范围内文件、假设,以及地图必须提供信息的决策。
- 检查差异和直接依赖者,使用可用工具搜索调用方、导入、接口、生成代码、配置和测试。
- 用静态证据追踪 API、数据读写、队列、作业、权限、功能开关、部署设置和客户可见路径的影响。
- 映射负责人、测试覆盖、可观测性、依赖和迁移限制,将每个受影响面分类为直接、可能、尚可能或未知,并把静态证据与运行时假设分开。
- 找出验证、无障碍、兼容性、回滚和可观测性缺口,提出最小且安全的检查,但不要在此运行测试、包命令或运行时路径。
- 总结影响和可逆性,标出敏感数据与不可信代码;如果需要测试或包命令,另行取得执行批准。
- 将地图和非机密的原始证据保存到 Latch 目标工作区,报告覆盖限制和未解决风险,映射本身不得改变仓库或远程状态。
先准备
猫会向你要的输入。
- 基准与目标修订或差异
- 预期变更与范围
- 运行时与部署背景
- 风险容忍度与复核负责人
路由器 + 一份 playbook
先路由。只选一份。
Cat Paw 每次任务只加载一份 playbook,不合并多份。先走这个路由器;其余路径是此 workflow 可检查的候选。
- 路由器:
code-graph-pack skills/code-graph-pack/code-change-blast-radius-map/SKILL.md
界限
界限跟着提示一起走。
- 开始前核实实际工具、账号、权限和工作区;绝不声称拥有不可用的工具、账号、来源或能力。
- 私有代码、产物、实时探测或非公开数据使用 Latch/target-workspace;如果无法访问,就在边界停止并报告阻塞,不要用猜测替代。
- 任何有后果的外部行动前先暂停并取得明确批准;返回证据、未解决风险、假设以及仍等待批准的行动。
完成代表
一个可核对的终点。
静态证据地图沿着指定差异追踪代码、数据、依赖、部署、测试和用户,并列出排序风险、建议检查、覆盖限制和未解决风险,且不改变仓库或远程状态。
来源
这个流程从哪来。
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review
- c4model.com/
来源确立 workflow 的模式。如有 Reddit 或社区帖子,视为实务轶事,不是普遍事实。