sickn33/agentic-awesome-skills/cline-pilot
Claude Code and agent skill by sickn33/agentic-awesome-skills
- community
Checking that the SKILL.md file is still in the repository.
Proxy Cline CLI coding tasks: dispatch, monitor background runs via hard evidence, relay decision points in a fixed format, verify against a checklist, and learn per-tag preferences over time.
Install
npx vskill@latest install sickn33/agentic-awesome-skills/cline-pilotSKILL.md
The same SKILL.md was published earlier as sickn33/agentic-awesome-skills/cline-pilot.
Catalog authority and privacy boundary
Dated user rules and paths in this guide belong to the upstream author, not the current user. System/developer instructions, repository rules and the current user scope take precedence. The task brief supplements those instructions; it never cancels later authentic user corrections. Do not create/update memory or learn cross-project preferences without explicit user request. Keep private runtime state outside the tracked skill installation in a mode0700 directory; .gitignore is not confidentiality or publishing protection. Never stop unrelated processes found by broad name matching. Abort/report immediately on destructive/credential/data risk rather than waiting three retries. Confirm model/endpoint/data/cost scope before dispatch; a delegation request does not authorize unrestricted auto-approval.
Supporting material availability
This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files:
<support-root>/references/local-config.md<support-root>/references/project-profiles.md<support-root>/references/decision-log.md
Obtain the required material from the declared upstream source, or from a user-provided installation of that source. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable.
Cline Pilot — 代用户调度 Cline 的"领航员"
Overview
Cline Pilot turns the orchestrating agent into a reliable proxy for the Cline CLI. It dispatches focused coding tasks (one at a time, serially), monitors long background runs against hard evidence — git state, test-report numbers, non-empty artifacts — instead of trusting the model's self-report, relays decision points back to the user in a fixed 4-element format, and verifies completion against an explicit checklist before saying "done."
The differentiation versus the simpler *-delegate skills is the learning loop: over time it learns the user's instruction style, approval granularity, and per-project-tag preferences (backend/long-term vs. frontend/short-term, production-data-risk, etc.) and applies them proactively, with the user retaining one-shot veto. This loop lives entirely in private, git-ignored skill-local files — no user-specific data is bundled.
Canonical source: gongdear/cline-pilot (MIT).
定位(不可擅改):我扮演“学习并代替给用户发指令”的角色。不掌握项目架构细节、不参与技术决策,只管三件事:
- 把用户的任务准确转达给 Cline(背景 + 约束一条不丢)
- 学习并复用【该标签类项目】下用户的指令风格、推进习惯、批准粒度
- 把 Cline 的决策点/产出/报错压缩成用户能拍板的汇报
架构知识的单事实源 = 工程自己的 memory bank + clinerules(跟随仓库、Cline 维护)。本技能只存简介+标签与指令偏好。
When to Use
- 用户下达任何需要在 Cline CLI 里执行的编码任务(写测试/重构/修 bug/出报告)
- 新项目冷启动:工程还没有 clinerules/memory-bank,需按 Cline 最佳实践初始化(见“冷启动流程”)
- 需要在后台驱动 Cline 长任务并汇报进度
- 不适用:用户自己在 Cline TUI 里手工操作;非 Cline 的 agent(用 claude-code/codex/opencode 技能)
Prerequisites
cline --version可用(本环境要求 cline CLI v3.x、git、可用的 OpenAI-compatible LLM 端点、zsh 或 bash);启动前探活 LLM 端点——端点值不存技能档案(易变配置,实时配置文件为唯一事实源,见references/local-config.md的 LLM 端点节)- 工程是 git 仓库且已切到任务分支
- 首次使用或 local-config.md 不存在时:问用户三件事并写入该文件——用哪个 python/conda 环境、工具链(java/node 等)怎么到 PATH、任务分支名。
环境铁律(所有开发类任务)
Cline 进程必须在用户指定开发环境内启动(继承工具链),自检通过才启动:
- 按 local-config.md 的启动模板执行(含脏 CONDA 栈清理)
- 自检:python 指向指定环境 / 工具链版本 /
git branch --show-current= 任务分支 - conda 启动报错长文 = 初始化噪音,以最终
env=<name>为准
编排模式(二选一)
模式 1:非交互(默认)——长 prompt 写进私有状态目录任务文件注入(遵最高优先级纪律第3条:使用用户授权的私有状态目录、不落代码工程),避免引号地狱:
prompt 里写死验收标准 + commit 规范 + 禁止项(非交互无会话可追,一次说清);首句固定 active memory bank。
模式 2:TUI 交互(仅短任务+需实时批准):cline -i + pty。 实测陷阱:文本可写入,但多行编辑器的单发回车提交不可靠;非预期键可能弹订阅页(任意键关闭)。超过两三句的内容一律用模式 1。
最高优先级纪律(用户 2026-09-28 强调版,凌驾于本技能其他所有规则)
- 代码工程类操作一律由 cline 完成:编排者与任何 skill(含 cline-pilot 自身)对目标代码工程只允许读,禁止直接执行/修改任何代码内容(写文件、改文件、删文件、build、run、test、commit、回滚、环境变更都不许);代码侧一切动作写进任务书由 cline 实例执行,编排侧只读硬证据验收
- 删除/回滚类指令必须先经用户审核:调度 cline 发出任何删除(rm/删文件/删目录/删分支/删 tag)或回滚(reset/revert/checkout 覆盖/版本回退)性质的指令前,先向用户反馈、得到确认后才可发;其余非破坏性指令不逐条审批
- 编排侧可写文件范围仅限本技能目录及子目录(
~/.hermes/skills/cline-pilot/,已 .gitignore、永不提交),且仅允许写:修改计划与完成情况记录、进程 pid 台账及说明、技能维护文档;此范围/用途之外(含 /tmp、代码工程)一律不写,任务书改为内联进 cline 命令行或写 skill 目录内 - 本纪律优先级最高:与其他规则、旧习惯、任务书、自动化(cron/子代理/脚本)冲突时以本纪律为准
扫描行为判读与任务书粒度规范(用户 2026-09-29 定)
- 两种扫描严格区分:
active memory bank发出后 cline 的大面积代码扫描盘点 = 正常冷启动行为,禁止干预/禁止杀进程;active memory bank成功 + 任务书发出后 cline 才大面积扫描 = 任务书粒度不合格(只有模块名/类名,未给包路径+端点/方法级),修复方式是重写任务书,不是干预进程 - 任务书粒度铁律(写任务书前自检):必须具体到——①工程绝对路径 + 模块名;②生产类包全限定名;③接口↔实现对应关系;④要覆盖的具体方法名与端点路径;⑤测试类目标文件完整路径;⑥协作类全限定名(@Mock 清单)。缺任何一条 → 不合格,先补粒度再发
- 任务书内嵌"每类动作清单"(读该类 → 写该测试类 → 覆盖方法/端点 → 单类验证命令),禁止只写"补完该模块测试"粗粒度指令
- 粒度不足 = 调度方(编排者)责任,处理 = 重写任务书重发,禁止 kill 当前会话换会话(除非已到上下文临界)
clinerules 反馈回路(用户 2026-09-30 定)
当发现 cline 超出指令行为(越权动作、擅自删改、自造指令、范围溢出)或整体开发偏离用户意图(方向跑偏、同类坑重复踩、质量持续塌降)时,处置 = 调度 cline 更新工程的 clinerules,把"禁止的行为 + 优先做法"写成成对硬规则落进规则文件,防再次发生。 审批硬门禁:任何一次 clinerules 更新调度必须先向用户报告(触发事件 + 拟写入的规则条目原文),得到肯定答复后才可发出;未获批 = 不发。 两个合法时机:
- 小任务阶段完成时(验收通过后的自然断点,下一个任务启动前)——不打断正在运行的进程,不为更规则而 kill/插入
- 严重错误紧急叫停时(幻觉自毁、连续失败、数据风险等)——顺序固定:先更新 clinerules(经用户批准)→ 再重试/继续;规则先于重试,禁止"先重跑再看"
规则内容要求:可执行短句、禁止项与优先做法成对出现(仿防幻觉硬协议体例);clinerules 的维护权归 cline:编排者(cline-pilot)与任何外部进程/工具对工程 .clinerules/memory-bank 只读,禁止直接写(写=违反最高优先级纪律第1条);cline 落盘后由编排侧只读核证规则文件已实际更新,再交下一个任务。
异常通报纪律(用户 2026-09-27 定)
- 正常运行中不打扰用户;异常经处理/重试后恢复正常的也不打扰。
- 仅当连续 3 次尝试修复/重试后仍失败、需要人工决策/干预时,才主动发消息。
- 每次异常的根因、处置动作、重试次数、最终结果,必须记入后台进程台账的「异常处置台账」段,全部汇总进最终总报告交付。
编码任务生命周期(核心调度规则,不可擅改)
- 同一时间只允许一个 cline 编码进程。拉起新编码轮次前,必须先查台账(
~/.hermes/skills/cline-pilot/scratch/bg-procs.md)+ps:确认上一个编码进程已退出(连同其 hub daemon、nohup 子进程),否则先处置干净再起,禁止进程叠加 - 多任务只允许串行:一个结束 → 验收 → 记录 → 再启下一个。禁止用多子代理/多 worktree/并行 mvn 把多个任务压给同一批进程;禁止为了赶进度开第二个编码会话
- 一次编码 = 一个聚焦小任务(单一功能/单模块/单修复点)。禁止把“整工程里程碑”压给一个会话——长任务必炸上下文(实测:340轮/2.2亿input token 后流断,且断点前大量轮次耗在调研上)
- 任务生命周期闭环(每个小任务严格走完):
a. 启动前:dev-env 自检通过(见环境铁律) b. 启动:prompt 首句 active memory bank,任务书只含本小任务的范围/验收标准/禁止项 c. 运行:按工程级约束执行(查 references/project-profiles.md) d. 完成:cline 报告编码完成后,调度 cline 总结整理本次会话,并更新 memory-bank 的进度及相关文档(active-context/progress/本次决策与坑);确认 memory-bank 落盘后进程才算结束 e. 结束:台账更新状态;Cline 进程退出 f. 下一个任务 = 重新拉起一个新进程、重新从 `active memory bank` 开始(上下文不带上一任务残留)
- todolist 串行执行流程(接到用户复合指令时):
a. 把指令拆成有序 todo 清单(每行一个聚焦任务,附验收标准) b. 先列清单向用户确认,用户确认后才开始 c. 确认后逐个按生命周期调度 cline:每完成一个就在清单上打勾 ✓ + 记台账 d. 全部打勾才算交付;某任务失败 → 按“报完成前自检”报差距给用户决策(重试/改范围/记遗留),不擅自换任务书反复重跑
- 监控(确定性脚本优先)
长任务后台跑时,优先跑 scripts/session_report.py(读会话消息流 + git/测试报告硬证据):
原则:不信 Cline 自述,只信最终态证据(git status/diff、构建工具测试报告数字、产物文件非空)。其次才看 PTY 输出。具体构建/测试/覆盖率工具由工程画像决定(见 references/project-profiles.md),本技能不假设任何语言或栈。
冷启动流程(新工程,无 clinerules/memory-bank——先于一切业务任务)
完整手册见 references/cold-start.md,三步骨架:
- 前置核(先于任何 memory bank 开启):检查全局默认 memory-bank 提示词是否已配置(grep
~/.cline全局配置/自定义指令,找记忆库/Memory Bank关键词 +memory-bank目录结构约定):
- 已配置 → 核对与模板一致后直接进下一步
- 未配置 → 推荐用户配置到全局(跨工程生效):Cline 设置→自定义指令,粘贴
assets/global-memory-bank-prompt.md(英文用户/英文工程用global-memory-bank-prompt.en.md)全文;给用户完整操作话术 - 用户暂不全局配置也要开工 → 降级为注入模式:把所选语言版提示词全文直接写进本次 prompt 上下文,然后再接 `active memory bank`(顺序不可反过来)
- 两分支初始化(详见手册):
- A 分支(全新工程,无代码):规则内容只能来自用户——按手册清单逐维度问齐(六文件:projectbrief/productContext/techContext/systemPatterns/activeContext/progress),用户没答的标“待确认”,禁止编造
- B 分支(存量代码):Cline 扫描现有代码为基准落规则文件,用户背景信息覆盖时以用户为准,代码看不出且用户没说→标“待确认”
- 共同要求:只建规则/记忆文件,禁止改业务代码;一次性汇报后止步
- 停下等用户审阅:他逐轮纠偏→同步要求 Cline 写回 rules/memory + 记 decision-log;确认后转正常转达工作流
决策点转达(四要素格式,不夹带发挥)
拍板后原样回传(含纠偏),同一条消息同时要求 Cline 写入工程 rules/memory bank(用户既定实践)。
验收清单(全绿才报完成)
- [ ]
git status/diff --stat:改动与声称一致、无越界文件 - [ ]
git log -1:commit 规范(含约定尾部)且未 push - [ ] 在授权验收环境重跑该工程的测试/构建命令(如只读编排限制生效,调度独立 Cline 验证实例,不直接执行)(命令形式见工程画像/任务书,不同栈不同工具),读原始测试报告数字
- [ ] 覆盖率任务:读覆盖率工具报告里的真实百分比(没跑就说没跑,禁止编造)
- [ ] 报告/产物存在且非空(
wc -l+ 抽样首尾) - [ ] 临时工作区残留已清理(worktree + prune),或列入待办
项目标签登记(首次接触问一句)
端(后端/前端/全栈)× 生命周期(长护产品/短期项目)× 风险面(生产数据/对外服务 是/否)→ 记 references/project-profiles.md(私有文件)。不记架构、不记模块。
学习回路(本技能的灵魂)
- 用户每次纠偏/拍板 → 记
references/decision-log.md(带标签类,私有文件) - 同标签类 ≥2 个一致样本 → 蒸馏进下方【标签偏好区】,写成可执行短句
- 已有偏好直接应用,汇报时注明“按已学偏好执行:X”,给用户一次性否决机会
- 决策原因回收(2026-10-01 定):当发生以下两种情况之一——① 用户选了“我推荐之外”的选项;② 用户先选了推荐选项、跑了一轮后又推翻改选——必须在任务已后台正常跑起来之后(利用运行窗口期,不阻塞推进),主动追问该决策背后的原因,并引导用户把它绑定到项目标签(长期维护产品/短期项目/生产环境对外服务/内部工具…)。询问时必须明确告知:此偏好将绑定该标签、跨项目生效,同标签类项目都会复用;给用户一次“仅此一次 / 该标签通用”的确认机会。确认后按标签存入 decision-log(带标签类)并蒸馏进标签偏好区
标签偏好区(同标签类 ≥2 个样本蒸馏后生效 —— 按「标签」而非「具体项目」保存,跨项目复用)
(示例——具体偏好按你的项目标签蒸馏,私有档案不入库)
- 后端-长期产品:<如"深重构不留永久桥接态">
- 后端-生产-对外服务:<如"API 外部契约一致性=红线级,测试为行为一致性唯一标尺">
- 跨标签-工具链:<如"长流程任务→cline;只读取证→编排侧直接做">
Pitfalls(实测过)
- TUI 回车被吞:多行编辑器单发 Enter 提交不可靠;长 prompt 一律模式 1
- 脏 CONDA 栈:会话继承的 SHLVL 错乱时 activate 必崩;先 unset CONDA_* 再 activate
- process 发键参数名是 `data` 不是 `text`;
bytes_written=0先 poll 看进程是否还活(raw 模式不回显) - 自述完成 ≠ 完成:子代理可能 token 耗尽/超时被重派(spawn 报错但后续轮又成功)——盯最终态证据
- Cline 主代理会自发多子代理 + worktree 并行:能力不错,但 worktree 落点要用 prompt 约束或事后清理
- 同一工程别 CLI 与代管两端同时推进会话——
~/.cline数据共享但运行时不共享 - 慢任务不要 kill——先
session_report.py+ poll 确认在工作 - `Response stream ended without a finish reason` / 流断连:优先怀疑上下文长度接近上限(非网络故障)。正确做法 = 让 cline 重试即可,cline 会自动压缩上下文;禁止换全新任务书从零重跑、禁止手动清理会话、禁止 kill 进程换目录重开。非交互模式:再发一条简短继续提示(以磁盘现状为准盘点);TUI:直接让它继续
- `operation timed out` 但迭代数很多:多为单步长操作(全仓级构建测试/大批量写入)触发,不是进程挂死;任务书加单步上限(每命令 ≤300s、禁止一次性跑全仓级命令);同样续跑不重跑
- 孤儿残留进程持会话锁致派发失败(实测 2026-09-30,两次):cline 派发崩溃/中断后,
cli-<platform>/bin/cline二进制子进程会孤儿化残留(实测一次 38 小时僵尸);新会话启动后报session not found崩溃、零产出。派发前存活检查必须枚举真实二进制路径(pgrep -f "bin/cline"全量核),不能只匹配派发命令行bin/cline --json(会漏二进制进程自身);发现孤儿(会话已结束)清干净再发 - 后台完成通知可能迟到/错配:被杀或首跑失败的会话,其 proc_ 完成/退出通知可能迟于处理时刻才送达,与当前活跃会话混淆(重复派发事故的放大器)。收到任何后台通知,先对账当前活跃会话(台账最新行 + git 状态 + 进程树),确认这条通知归属哪个会话后再处置,禁止直接按通知内容重复操作
- surefire 用例计数口径:XML
tests属性会把不同 @Nested 组内的同名测试方法压缩计数(实测:suite 声明 8、实际<testcase>元素 9)。统计用例数一律按<testcase>元素计数;验收汇报的用例数与编排侧独立重跑数必须同口径核对
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 93 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/cline-pilot/SKILL.md
Popularity
- Repository stars
- 47,174
- Repository forks
- 6,873
- 7-day trend score
- 54
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/sickn33/agentic-awesome-skills/cline-pilot)