// Bug 修复工作流：修复 bug 时强制执行"根因分析 → 反思测试缺口 → 修复代码 → 补充单元测试 → 验证"流程。 确保每次 bug 修复都附带回归测试，并反思为什么现有测试没能覆盖到。 关键词：bug fix、修复、regression、回归测试、测试缺口。
| name | kdit-bugfix |
| description | Bug 修复工作流：修复 bug 时强制执行"根因分析 → 反思测试缺口 → 修复代码 → 补充单元测试 → 验证"流程。 确保每次 bug 修复都附带回归测试，并反思为什么现有测试没能覆盖到。 关键词：bug fix、修复、regression、回归测试、测试缺口。 |
修 bug 不只是改代码——必须反思为什么测试没拦住，并补回归测试。
/kdit-development-spec）详见 → bugfix.md
| 规范 | 路径 |
|---|---|
| 测试规范 | 04_quality/verification.md |
| 异常处理 | 03_standards/exception-handling.md |
| Node/Tensor API | 03_standards/node-and-tensor.md |
| 架构总览 | 02_architecture/overview.md |
| Skill | 何时调用 |
|---|---|
/kdit-quality | 编写回归测试时查阅测试命名和目录规范 |
/kdit-architecture | 定位根因需理解模块关系时 |
/kdit-standards | bug 涉及异常处理或 Node API 时 |
在编码或架构设计前强制执行"需求澄清 → 可行性分析 → 结构设计 → 测试设计 → 编码实现 → 校验 → 文档同步"的七步流程。 适用于功能开发、重构、新模块创建、架构讨论与设计评审等需要先设计后实现的场景。 关键词：development spec、先设计后编码、架构讨论、设计评审、需求确认、结构体设计、单元测试先行、vibe testing。
kDiT 架构知识库：全局架构图、数据流、Node/Pipeline/Generator/Adapter 子系统设计、 PinHub 沙箱机制、PoolKey 间接寻址、DeviceInfo/NodeContext 规范。 关键词：architecture、架构、Node、Pipeline、Generator、Adapter、Engine、Executor、PinHub、Pool。
kDiT 编码规范：Import 风格（方案 B）、Python 3.10+ 类型注解、Key 类型体系、 Node/Tensor API 开发约束、异常处理规则、类命名规范。 关键词：standards、规范、import、类型注解、Key、异常处理、命名。
kDiT 质量保障与交付验收：单元测试规范（*_test.py 命名、tests/kdit/ 镜像结构）、 pre-commit 格式检查（black 120字符、ruff）、pytest vs ruff 维度差异、文档同步规则。 关键词：quality、测试、test、pytest、pre-commit、ruff、black、验收。
kDiT 代码评审技能：除常规 CR 项（安全漏洞、格式规范、逻辑正确性）外，重点基于项目 .skills/ 中的架构设计 和编码规范进行评审，确保代码不违背设计原则和约束。 关键词：code review、CR、评审、review、架构合规。
系统化调试工作流：当现象不明确、根因未知时，强制执行"信息收集 → 假设生成 → 逐层验证 → 定位根因 → 记录结论"的排查流程。 区别于 bugfix（已知问题修代码），debug 侧重于从混沌的现象中找到问题本质。 关键词：debug、调试、排查、诊断、日志分析、二分法、断点、现象不明。