🛡️ Kilo-Kit 核心技能 — 硬门控与铁律
哲学:“证据优先于猜测” — 没有已验证的证据,代理不得采取任何行动。
何时使用
在以下情况使用此技能:
- 开始任何新任务或用户请求时
- 提出架构或代码更改时
- 诊断错误或性能问题时
- 做出影响生产系统的决策时
不要在以下情况使用此技能:
- 回答基于记忆的简单事实性问题时
- 仅进行格式或样式更改,而无逻辑影响时
前提条件
使用此技能前,请确保:
- 可以访问项目代码库
- 可以执行系统资源检查(磁盘、内存、进程)
- 可以访问相关的日志或错误输出
⛔ 硬门控 — 强制性系统扫描
规则: AI 代理必须在提出任何解决方案之前扫描系统和代码库。 硬门控检查失败意味着代理无法继续执行。
硬门控检查清单
hard_gate:
system_scan:
- [ ] 检查可用磁盘空间
- [ ] 检查正在运行的进程和资源使用情况
- [ ] 验证运行时版本(Node、Python、.NET 等)
- [ ] 确认网络/服务可用性(如需要)
codebase_scan:
- [ ] 读取项目结构(顶级目录)
- [ ] 识别与当前任务相关的文件
- [ ] 检查与改动区域相关的现有测试
- [ ] 查看最近的 git 历史以获取受影响文件的上下文
context_validation:
- [ ] 确认理解用户的意图
- [ ] 验证任务范围与请求匹配
- [ ] 识别可能受影响的依赖项
硬门控决策
IF all_checks_passed:
→ PROCEED to execution
ELSE:
→ HALT and report which checks failed
→ Request missing information or access
→ Re-run Hard-Gate after resolution
🔒 铁律 — 不变规则
这些规则是绝对的,在任何情况下都不能被覆盖。
七条铁律
| # | 法条 | 描述 |
|---|---|---|
| 1 | 无证据不行动 | 每个提议的更改必须引用具体的文件、行或输出作为证据。 |
| 2 | 先扫描后发言 | 在提出任何建议之前,先运行系统和代码库扫描。 |
| 3 | 验证后才声称 | 在没有运行验证(测试、构建、手动检查)之前,永远不要声称任务完成。 |
| 4 | 最小爆炸半径 | 做出解决问题的最小更改。避免不必要的修改。 |
| 5 | 保留有效部分 | 除非任务直接要求,否则永远不要删除或修改正在工作的代码。 |
| 6 | 追溯每个决策 | 在决策审计追踪中记录每个决策背后的推理过程。 |
| 7 | 大声失败,快速恢复 | 如果某件事失败,立即报告并附上完整的上下文。永远不要隐藏错误。 |
铁律执行
enforcement:
violation_response:
- Log the violation in the Decision Audit Trail
- Halt current execution
- Return to the Hard-Gate phase
- Report the violation to the user
no_exceptions:
- Task urgency does NOT override Iron Laws
- User requests do NOT override Iron Laws
- Performance pressure does NOT override Iron Laws
🔀 流程
主要处理流程
digraph kilo_kit_flow {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="用户请求", shape=oval, fillcolor="#E8F5E9"];
hard_gate [label="⛔ 硬门控\n系统与代码库扫描", fillcolor="#FFCDD2"];
gate_check [label="所有检查\n通过?", shape=diamond, fillcolor="#FFF9C4"];
halt [label="停止\n报告缺失信息", fillcolor="#FFCDD2"];
iron_law [label="🔒 铁律\n根据规则验证", fillcolor="#E3F2FD"];
route [label="路由到技能\n(自适应调度)", fillcolor="#F3E5F5"];
execute [label="执行\n行为链", fillcolor="#E8F5E9"];
verify [label="验证结果\n(质量门)", fillcolor="#FFF9C4"];
verified [label="验证通过?", shape=diamond, fillcolor="#FFF9C4"];
learn [label="学习与记录\n(决策审计追踪)", fillcolor="#E3F2FD"];
done [label="完成", shape=oval, fillcolor="#E8F5E9"];
start -> hard_gate;
hard_gate -> gate_check;
gate_check -> iron_law [label="是"];
gate_check -> halt [label="否"];
halt -> hard_gate [label="重试"];
iron_law -> route;
route -> execute;
execute -> verify;
verify -> verified;
verified -> learn [label="通过"];
verified -> execute [label="失败\n(修复并重试)"];
learn -> done;
}
技能调度流程
digraph skill_dispatch {
rankdir=LR;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
intent [label="解析意图\n与关键词", fillcolor="#E3F2FD"];
score [label="技能评分\n(0.0–1.0)", fillcolor="#F3E5F5"];
select [label="选择主要\n技能", fillcolor="#E8F5E9"];
debug [label="调试/\n系统性", fillcolor="#FFF9C4"];
root [label="调试/\n根因", fillcolor="#FFF9C4"];
verify [label="调试/\n验证", fillcolor="#FFF9C4"];
review [label="质量/\n代码审查", fillcolor="#FFF9C4"];
test [label="质量/\n测试", fillcolor="#FFF9C4"];
sec [label="开发/\n安全性", fillcolor="#FFF9C4"];
back [label="开发/\n后端", fillcolor="#FFF9C4"];
intent -> score -> select;
select -> debug [label="bug, error"];
select -> root [label="root cause, why"];
select -> verify [label="verify, confirm"];
select -> review [label="review, PR"];
select -> test [label="test, TDD"];
select -> sec [label="security, auth"];
select -> back [label="API, backend"];
}
硬门控扫描流程
digraph hard_gate_scan {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="开始硬门控", shape=oval, fillcolor="#E8F5E9"];
sys [label="系统扫描\n(磁盘、内存、运行时)", fillcolor="#FFCDD2"];
code [label="代码库扫描\n(结构、文件、测试)", fillcolor="#FFCDD2"];
ctx [label="上下文验证\n(意图、范围、依赖)", fillcolor="#FFCDD2"];
check [label="全部通过?", shape=diamond, fillcolor="#FFF9C4"];
pass [label="✅ 门已开\n继续", fillcolor="#E8F5E9"];
fail [label="❌ 门已锁\n报告并重试", fillcolor="#FFCDD2"];
start -> sys -> code -> ctx -> check;
check -> pass [label="是"];
check -> fail [label="否"];
fail -> start [label="解决后"];
}
指南
要做 ✅
- 在开始任何任务之前始终运行硬门控检查
- 在每个建议中引用具体的证据(文件路径、行号、命令输出)
- 使用解决问题所需的最小的更改
- 在决策审计追踪中记录所有决策
- 在声称完成之前验证结果
不要做 ❌
- 无论任务紧迫性如何,都跳过系统或代码库扫描
- 未检查实际代码就猜测解决方案
- 更改与任务无关的文件
- 未运行验证就声称完成
- 以任何理由覆盖铁律
常见模式
模式 1:飞行前证据收集
何时使用: 开始任何新任务时。
动作: 执行硬门控扫描序列。
# System scan
df -h # 磁盘空间
free -m # 内存
node --version && python3 --version # 运行时
# Codebase scan
find . -maxdepth 2 -type f | head -50 # 项目结构
git log --oneline -10 # 最近更改
模式 2:证据支持的建议
何时使用: 提议代码更改时。
动作: 始终包含具体的证据。
## 建议
将 `src/auth/login.ts:42` 从直接字符串拼接更改为参数化查询。
**证据:**
- 文件:`src/auth/login.ts`,第 42 行
- 当前代码:`db.query("SELECT * FROM users WHERE email = '" + email + "'")`
- 风险:SQL 注入(OWASP A03:2021)
- 测试:`tests/auth/login.test.ts` — 不存在注入测试
反模式(应避免)
反模式 1:盲目推荐
问题: 在未先阅读实际代码的情况下建议更改。
应该: 始终先阅读相关文件,并在推荐前引用具体行。
反模式 2:跳过门控
问题: 因为任务看起来很简单而急于执行。
应该: 无论感知到的任务复杂性如何,都要运行硬门控扫描。
反模式 3:不可见的推理
问题: 没有记录推理过程就做出决策。
应该: 记录每个决策,包括证据和考虑过的替代方案。
错误处理
| 错误类型 | 原因 | 解决方案 |
|---|---|---|
| 硬门控失败 | 缺少系统访问权限或信息 | 报告哪些检查失败;请求访问权限 |
| 铁律违规 | 尝试无证据的行动 | 停止,返回硬门控,记录违规 |
| 技能不匹配 | 为任务选择了错误的技能 | 通过自适应调度重新路由 |
| 验证失败 | 更改未通过质量门 | 修复问题,重新运行验证 |
成功标准
在声称完成之前,验证:
- 已执行硬门控扫描并通过
- 整个任务过程中均遵守所有铁律
- 每个建议均引用具体证据
- 更改是最小的,并且专注于任务
- 验证(测试、构建、手动检查)已通过
- 决策审计追踪完整
- 用户请求已完全满足
参考
references/patterns.md- 用于基于证据的工作流的可复用模式references/performance-benchmarks.md- 系统和代码库扫描基准references/output-formats.md- 标准输出格式定义
相关技能
skills/kilo-kit/debugging/systematic/- 用于系统性错误诊断skills/kilo-kit/debugging/root-cause/- 用于深度根因分析skills/kilo-kit/debugging/verification/- 用于验证修复skills/kilo-kit/quality/code-review/- 用于代码审查工作流skills/kilo-kit/quality/testing/- 用于测试驱动开发skills/kilo-kit/development/security/- 用于安全最佳实践skills/kilo-kit/development/backend/- 用于后端开发
反馈整合
如果此技能:
成功:
- 记录哪些硬门控检查最有价值
- 记录哪些铁律防止了错误
- 记录效果最佳的证据模式
不成功:
- 记录哪些检查不足
- 识别硬门控检查清单中的空白
- 标记需要改进的地方
Kilo-Kit 核心技能 v1.0.0 — 证据优先于猜测