MCP 与 Skills

install-klymora-agent.sh / install-agent-integration.sh 会对接 11 端 IDE / Agent（10 端 Tier-1 全量 + Continue MCP）。一键脚本内部调用 klymora-mcp install 与 Skills / agent-rules 同步。

1. 支持的 Agent / IDE

1.1 支持级别

级别	含义
⭐ 一级	MCP + Skills + Rules 全支持；安装器自动配置
二级	仅 MCP 支持；安装器写入配置
附录	仅 MCP；非开发工具

未安装的 IDE 会被安装器跳过（不报错）。已检测到的目标会写入对应配置文件。安装后清单见：/opt/flintrix/local/agent-integration.json。

1.2 AI Agent（原生 AI 编程助手 — CLI 工具）

MCP + Skills + Rules 全支持，安装器自动配置。适合无 GUI 的工作环境。

级别	Agent	MCP 配置	Skills 路径	规则 / 专属配置
⭐一级	Cursor	`~/.cursor/mcp.json`；测台 `.cursor/mcp.json`	`~/.cursor/skills` → `/opt/flintrix/skills`	`.cursor/rules/klymora-skills.mdc`
⭐一级	OpenCode	`~/.config/opencode/opencode.json`；测台 `opencode.json`	`~/.opencode/skills` → `/opt/flintrix/skills`	`AGENTS.md` + `CLAUDE.md`
⭐一级	Claude Code	`claude mcp add klymora`	`~/.claude/skills` → `/opt/flintrix/skills`	`~/.claude/rules/klymora-core-rules.md`
⭐一级	Kimi Code	`~/.kimi-code/mcp.json` 或 `~/.kimi/mcp.json`	`~/.kimi-code/skills` → `/opt/flintrix/skills`	`~/.kimi-code/config.toml`（安装器合并 skills/mcp，不覆盖 models/OAuth）
⭐一级	Codex CLI	`codex mcp add klymora`	—	—
⭐一级	OpenClaw	`~/.config/openclaw/config.toml`	—	`~/.config/openclaw/rules.toml`

1.3 IDE 内置 AI

以下 IDE 在 2026 年起都已原生支持 MCP + Skills + Rules。Skills 经标准路径（.agents/skills/ 等）自动同步。

级别	IDE	MCP 配置	Skills 路径	规则 / 专属配置
⭐一级	VS Code（GitHub Copilot）	`.vscode/mcp.json`；`~/.config/Code/User/settings.json`	`.agents/skills/` → `/opt/flintrix/skills`	`.github/copilot-instructions.md`
⭐一级	Lingma IDE（通义灵码）	`~/.lingma/mcp.json`；测台 `.lingma/mcp.json`	`~/.lingma/skills` → `/opt/flintrix/skills`	`.lingma/rules/`
⭐一级	Trae（ByteDance）	`.trae/mcp.json`；`traecli config`	`.trae/skills` → `/opt/flintrix/skills`	`.trae/rules/`
⭐一级	Qoder（阿里云）	`~/.qoder/mcp.json`；`qodercli mcp add`	`.qoder/skills` → `/opt/flintrix/skills`	`.qoder/rules/klymora-rules.md`

1.4 IDE 扩展 / 插件

仅 MCP 工具支持，无 Skills。安装器写入 MCP 配置。

级别	插件	MCP 配置	宿主 IDE
二级	VS Code Continue	`~/.config/Continue/config.json`	VS Code / JetBrains

1.5 附录：非开发工具

工具	MCP 配置	说明
Claude Desktop	`~/.config/Claude/claude_desktop_config.json`	桌面聊天应用，非 IDE / Agent

2. 一键安装

# 推荐：系统依赖 + 全部 Agent 对接 + doctor
sudo /opt/flintrix/setup/install-klymora-agent.sh

# 仅刷新 MCP / Skills / 规则（依赖已满足）
bash /opt/flintrix/setup/install-klymora-agent.sh --agent-only

# 测台级：额外生成 AGENTS.md，并写入测台内 .cursor / .vscode / opencode 等
sudo /opt/flintrix/setup/install-klymora-agent.sh --tb /path/to/your_tb

底层等价于：

/opt/flintrix/bin/klymora-mcp install              # 全局
/opt/flintrix/bin/klymora-mcp install --project-dir /path/to/tb   # 项目级

3. 各端验收

安装完成后 重启对应 IDE，并检查：

klymora-mcp doctor

你用的工具	检查项
Cursor	`cat ~/.cursor/mcp.json`；Agent 面板有 `klymora_*` 工具
OpenCode	`~/.config/opencode/opencode.json` 或测台 `opencode.json`
Claude Code	`claude mcp list` 含 `klymora`
Kimi Code	`cat ~/.kimi-code/mcp.json`；`ls ~/.kimi-code/skills`
Codex CLI	`codex mcp list` 含 `klymora`
OpenClaw	`cat ~/.config/openclaw/config.toml` 含 `[[mcp_server]]`
VS Code	`.vscode/mcp.json` 或 `Code/User/settings.json`；`ls .agents/skills/`
Lingma IDE	`cat ~/.lingma/mcp.json`；`ls ~/.lingma/skills`
Trae	`cat .trae/mcp.json`；`ls .trae/skills`
Qoder	`qodercli mcp list` 含 `klymora`；`ls .qoder/rules/`
VS Code Continue	`cat ~/.config/Continue/config.json`
全局 Skills	`ls -l ~/.cursor/skills` 等应指向 `/opt/flintrix/skills`

4. MCP 工具分级

级别	用途	代表工具
L0 只读	读规程、读报告	`klymora_get_skill`、`klymora_read_loop_summary`、`klymora_list_skills`
L1	激励检查、引导、诊断	`klymora_stimulus_check`、`klymora_bootstrap`、`klymora_diagnose`
L2	闭环验证、仿真	`klymora_verify`、`klymora_simulate`
sweep	参数扫描	`klymora-sweep` / 相关 MCP 路径

完整列表以 klymora-mcp doctor 为准（约 29 个 Tool）。各 IDE 共用同一套 MCP 工具，仅配置路径不同。

5. 推荐 Agent 工作流（任意 IDE）

klymora_stimulus_check → klymora_verify → klymora_read_loop_summary
  →（失败）klymora_diagnose → 改码 → 再次 verify

判据：reports/loop/summary.json → stop_reason。

规程入口：skills/klymora-index/SKILL.md（经 klymora_get_skill 读取）。

6. Skills 与规程包

项	路径
Skills 源	`/opt/flintrix/skills/`
Agent 规则包	`/opt/flintrix/agent-rules/`
测台 AGENTS.md	`install-klymora-agent.sh --tb <测台>`

升级 deb / rpm 后：

bash /opt/flintrix/setup/install-klymora-agent.sh --agent-only

7. 与 CLI 的对应

MCP 工具	CLI（参考）
`klymora_verify`	`klymora-run --verify`
仿真	`klymora-run`
参数扫描	`klymora-sweep`

CLI 见快速开始；安装见安装与部署。

8. 选择指南

您使用 AI Agent CLI（Cursor / OpenCode / Claude Code / Kimi Code / Codex CLI / OpenClaw）
  → 一级全量支持。MCP + Skills + Rules 一键部署，推荐。

您使用 IDE 内置 AI（VS Code / Lingma IDE / Trae / Qoder）
  → 一级全量支持。Skills 经标准路径自动同步。

您使用 IDE 扩展（Continue）
  → 二级：仅 MCP 工具，无 Skills。

您需要命令行工具，无 GUI
  → 直接使用 klymora-run / klymora-sweep CLI，无需 MCP。