cline 配置增强手册

🛠 Cline 配置增强手册 — VSCode + Python

基于 GitHub 最新生态调研（2026-05）Cline v3.84.0

核心判断：VSCode Cline 官方默认的 Agent 能力和 Skill 系统已经足够完整。MCP 服务器（mcp-tools-py / mcp-debugpy 等）并没有实质性地增强 Agent 能力——Cline 本身就能通过 bash 直接运行 ruff/mypy/pytest。真正有增量价值的是 .clinerules 对 Agent 行为的引导。

📌 Cline vs 竞品对比

截至 2026-05，以下是对比最终结论：

维度 Cline Kilo Code Aider Roo Code Continue
⭐ GitHub ~62K ~19K ~45K 已停更 ~33K
许可证 Apache 2.0 MIT Apache 2.0 — Apache 2.0
形态 VSCode / JetBrains / CLI / SDK VSCode / JetBrains / CLI / Cloud Agent CLI（pip install） 已停更（原 VSCode） VSCode / JetBrains + CI
Agent 能力 全自主 Agent
Plan/Act 双模式		 全自主 Agent
5 种内置模式		 结对编程
ask/code/architect		 — 弱 Agent
已转型 CI 审查
模型支持 任意模型
（OpenAI / Anthropic / Google / Ollama 等）		 任意模型
（兼容 Cline 模型供应商）		 主流模型
（GPT-4/Claude/Llama 等）		 — 主流模型
自定义模式 .clinerules + Skills 内置 5 模式
Ask / Architect / Code / Debug / Custom		 editor + architect 角色 — 无
MCP 支持 ✅ 原生 ✅ 原生（兼容） ❌ 无 — ❌ 无
Git 集成 手动控制 手动控制 自动提交
（核心卖点）		 — 手动控制
多 Agent 协作 ✅ Kanban 看板 ✅ Cloud Agents ❌ — ❌
Python 亲和度 中（工具链在 .clinerules 配置） 中（同 Cline） ⭐⭐⭐⭐⭐
（自身 Python 编写，pip 安装，lint 自动集成）		 — 低（已转型）
当前状态 ✅ 活跃开发 ✅ 活跃开发
v7.3.1（今日）		 ✅ 活跃开发
v0.86.0		 ❌ 已停更
（组织/仓库/插件均404）		 ⚠️ 转型中
主推 CI 审查

📌 Cline 最新生态概览

  • 主仓库：cline/cline — 开源自主编码 Agent，VSCode / JetBrains / CLI 三端覆盖
  • 最新版本：v3.84.0
  • 核心能力（已内置，无需 MCP）：
    • Plan / Act 双模式 — 审批变更后执行
    • .clinerules 规则系统 — 项目级编码规范、工作流、工具链
    • bash 执行 + 实时输出监控
    • MCP Server 扩展、多 Agent Kanban 看板协作、任意模型提供商（Ollama / OpenAI / Anthropic / Google 等）

📜 .clinerules — 唯一真正值得配置的东西

Cline 默认 Agent 不知道你的编码风格、测试习惯、工具链。.clinerules 是告诉它的唯一渠道，也是 ROI 最高的配置。

完整模板（Python 3.11+）

# Cline Python Rules

## 角色
- 你是 Cline，VSCode 内的 Python 工程助手
- 优先清晰性、可测试性、显式数据契约

## 编码标准
- 目标 Python 3.11+，除非另有说明
- 所有公开函数必须有类型注解（type hints）
- 结构化数据优先使用 dataclass 或 Pydantic
- 使用现代类型语法：str | None 替代 Optional[str]，list[str] 替代 List[str]
- 保持函数聚焦，大块逻辑拆分为可组合单元
- 抛出具体异常并附带可操作消息
- 文件 / 网络 / 外部资源使用上下文管理器
- 路径处理使用 pathlib 而非裸字符串
- 在 __init__.py 中定义 __all__ 以满足 mypy

## 项目结构
- 推荐布局：src/、tests/、scripts/、docs/
- 测试目录镜像源码路径，便于快速定位

## 测试 (pytest)
- AAA 组织模式：Arrange → Act → Assert
- 覆盖成功路径、边界条件、错误处理
- Mock 外部 API、数据库、文件系统、时钟
- 每修复一个 Bug 添加回归测试
- 测试须确定且可并行

## 工具调用约定
- 包管理：uv（现代 pip 替代）
- 格式化：ruff format（或 black line-length=88）
- Lint：ruff check --fix
- 类型检查：mypy --strict 或 pyright
- 测试：pytest -xvs
- 以上工具直接通过 bash 调用，无需 MCP 包装

## 工作流
- 编辑前先检查相关模块 + 测试
- 使用内联补丁编辑而非全文件重写
- 编辑后依次执行 ruff、mypy、pytest
- 修复 lint/type 错误后再推进下一步

## 完成标准
- [ ] Lint 通过（ruff check --no errors）
- [ ] 类型检查通过（mypy --strict）
- [ ] 相关行为测试通过
- [ ] 公开函数已输入并文档化

多文件拆分（可选，适合大型项目）

参考 tnakae/python-cline-rules 模式：

clinerules-bank/
├── 01_coding/
│   ├── 0100_essential.md
│   ├── 0101_uv.md
│   ├── 0102_ruff.md
│   └── 0103_mypy.md
├── 02_structure/
│   └── 0200_project_layout.md
├── 03_library/
│   └── 0300_fastapi.md, 0301_sqlalchemy.md ...
├── 04_test/
│   ├── 0401_pytest.md
│   └── 0402_mocking.md
└── 05_debug/
    └── 0501_debugpy.md

🔌 MCP 服务器的真实评估

MCP 服务器声称的功能真实增量价值
mcp-tools-py
MarcusJellinghaus/mcp-tools-py		 暴露 run_pylint_check / run_pytest_check / run_mypy_check ❌ 几乎没有。Cline 直接 bash 调 ruff/mypy/pytest 效果一样。MCP 只多了一层 JSON 包装
mcp-debugpy
markomanninen/mcp-debugpy		 DAP 调试：断点/步进/变量查看 ⚠️ 场景窄。日常开发用 VSCode 原生调试器更方便；偶尔在 Agent 流程中做断点调试才用得上
tailtest-cline
avansaber/tailtest-cline		 自动测试生成 + 规则层 ❌ 本质是 .clinerules 脚本，不需要 MCP 也能实现

结论：这些 MCP 服务器没有扩展 Cline 的能力边界，只是在重复 bash 已有的能力。不安装也不影响任何开发效率。

📚 相关社区资源（供参考）

仓库用途
Lay4U/awesome-ai-rules.clinerules 精选集，Python 规则可参考借鉴
tnakae/python-cline-rulesPython 专用模块化规则库
LakshmiSravyaVedantham/dotai单配置文件 → 多编辑器同步（Cline/Cursor/Windsurf/Aider）
nirholas/github-to-mcpGitHub 仓库 → MCP 服务器自动转换

🚀 推荐落地清单

  1. 必做：将上述 .clinerules 模板放入 Python 项目根目录，按需调整
  2. 必做：项目依赖添加 ruff、mypy、pytest；锁 Python 3.11+
  3. 推荐：包管理切换到 uv（速度优势明显）
  4. 不需要：安装 mcp-tools-py / mcp-debugpy — Cline 直接跑 bash 命令效果一样
  5. 不需要：额外配置 MCP 服务器 — 官方默认就够