con un clic
kdit-code-review
// kDiT 代码评审技能:除常规 CR 项(安全漏洞、格式规范、逻辑正确性)外,重点基于项目 .skills/ 中的架构设计 和编码规范进行评审,确保代码不违背设计原则和约束。 关键词:code review、CR、评审、review、架构合规。
// kDiT 代码评审技能:除常规 CR 项(安全漏洞、格式规范、逻辑正确性)外,重点基于项目 .skills/ 中的架构设计 和编码规范进行评审,确保代码不违背设计原则和约束。 关键词:code review、CR、评审、review、架构合规。
在编码或架构设计前强制执行"需求澄清 → 可行性分析 → 结构设计 → 测试设计 → 编码实现 → 校验 → 文档同步"的七步流程。 适用于功能开发、重构、新模块创建、架构讨论与设计评审等需要先设计后实现的场景。 关键词: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、验收。
Bug 修复工作流:修复 bug 时强制执行"根因分析 → 反思测试缺口 → 修复代码 → 补充单元测试 → 验证"流程。 确保每次 bug 修复都附带回归测试,并反思为什么现有测试没能覆盖到。 关键词:bug fix、修复、regression、回归测试、测试缺口。
系统化调试工作流:当现象不明确、根因未知时,强制执行"信息收集 → 假设生成 → 逐层验证 → 定位根因 → 记录结论"的排查流程。 区别于 bugfix(已知问题修代码),debug 侧重于从混沌的现象中找到问题本质。 关键词:debug、调试、排查、诊断、日志分析、二分法、断点、现象不明。
| name | kdit-code-review |
| description | kDiT 代码评审技能:除常规 CR 项(安全漏洞、格式规范、逻辑正确性)外,重点基于项目 .skills/ 中的架构设计 和编码规范进行评审,确保代码不违背设计原则和约束。 关键词:code review、CR、评审、review、架构合规。 |
/kdit-code-review 或 "帮我 review 一下"| 优先级 | 维度 | 说明 |
|---|---|---|
| P0 | 架构合规 | 基于 .skills/02_architecture/ 和 .skills/03_standards/ 检查 |
| P1 | 逻辑正确性 | 边界条件、资源泄漏、并发安全、数据流完整 |
| P1 | 单元测试覆盖 | kdit/ 核心代码变更必须包含对应测试,否则阻塞 |
| P2 | 安全漏洞 | OWASP Top 10 |
| P3 | 代码质量 | 格式规范、复杂度 |
详见 → code_review.md
git diff 或 PR diff,确认涉及的模块kdit/ 核心代码;若涉及,diff 中必须包含 tests/kdit/ 下的测试变更,否则直接标记为 P1 阻塞项| 改动模块 | 必查文档 |
|---|---|
| Node 相关 | node.md、pin-hub.md、node-and-tensor.md |
| Pipeline 相关 | pipeline.md |
| Generator 相关 | generator.md |
| Engine/Executor | overview.md |
| Adapter 相关 | adapter.md |
| Key/Pool 相关 | key-system.md、pool-key.md |
| Skill | 何时调用 |
|---|---|
/kdit-architecture | P0 架构合规检查:查阅依赖方向、Node 签名、PinHub 机制等设计约束 |
/kdit-standards | P0 编码规范检查:查阅 Import/类型注解/异常处理/命名规则 |
/kdit-quality | P3 质量检查:查阅测试覆盖要求和格式规范 |