Community研究与数据分析github.com

VoDaLociz/kilo-kit-mcp

一款用于更安全编码代理的 MCP 服务器:技能路由、C4 工作流门控、内存检查以及在完成前进行验证。

kilo-kit-mcp 是什么?

Kilo-Kit Core Skill 是一款专为 AI 编码代理设计的 MCP(模型上下文协议)服务器技能,其核心理念是“证据优先于猜测”。该技能强制执行严格的“硬门控”(Hard-Gate)系统扫描和代码库扫描,确保代理在提出任何解决方案前已获得必要的上下文信息。同时,它通过七条不可违反的“铁律”(Iron Laws)来规范代理行为,例如“无证据不行动”、“先扫描后发言”和“验证后才声称完成”。该技能适用于 Claude Code、Cursor 等支持 MCP 的 AI 代码助手,通过自适应调度(Adaptive Dispatch)将任务路由到最合适的子技能(如调试、代码审查、安全性等),并在整个流程中生成决策审计追踪,从而显著减少盲目猜测和错误执行,特别适合对代码质量、安全和可靠性有严格要求的项目。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add VoDaiLocz/kilo-kit-mcp

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

🛡️ 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 — 证据优先于猜测

相关技能