القائمة
kDiT 代码评审技能：除常规 CR 项（安全漏洞、格式规范、逻辑正确性）外，重点基于项目 .skills/ 中的架构设计 和编码规范进行评审，确保代码不违背设计原则和约束。 关键词：code review、CR、评审、review、架构合规。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在编码或架构设计前强制执行"需求澄清 → 可行性分析 → 结构设计 → 测试设计 → 编码实现 → 校验 → 文档同步"的七步流程。 适用于功能开发、重构、新模块创建、架构讨论与设计评审等需要先设计后实现的场景。 关键词：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 质量检查：查阅测试覆盖要求和格式规范 |