agentleFS
pengxiaozipengxiaozi/dsh-plugins/skills/plan-gate/SKILL.md

plan-gate

Skill6 starsChanged 24 days agoMITView on GitHub

首个需求先出「实施方案 + 涉及文件清单」并请求确认的执行闸门。当用户提出开发、改代码、加功能、修 bug、改页面/接口/样式等需求时使用;只在该需求的第一次回复时执行,用户确认后不再重复询问。

4 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions4 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 4

    1. NUX-Design/claude-skills-fable-opus★ 24same name
    2. eranw2000/multi-phase-skills-framework★ 10same name
    3. AgriciDaniel/plan-gate★ 9same name
    4. Ahsan-ire/rag-pipeline-v1★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

Files
SKILL.md

SKILL: plan-gate(先方案、后动手)

AI LOAD INSTRUCTION: 这是一个"执行前闸门"。用户的第一个需求消息到来时,先别改代码;用一两分钟做只读侦察,然后按下面的固定结构给出方案 + 文件清单,用 ask_user_question 请用户确认。确认后再执行。同一个需求只做一次,后续追问不要再重复整套方案。

1. 何时触发 / 何时不触发

触发(满足全部):

  • 用户第一次描述一个开发类需求(改代码、加功能、修 bug、改页面/样式/接口/配置、重构等);
  • 当前上下文里还没有针对这个需求给出过方案并得到确认。

不触发:

  • 同一需求确认后的后续追问、补充细节、报错跟踪;
  • 纯咨询、解释、代码阅读、方案讨论(用户没让你改);
  • 用户明确说"直接改 / 不用确认 / 按你说的做"——直接执行,但仍要先用一句话复述范围,并列出要改的文件;
  • 单字符/单行级别的明确小修(如"把标题改成 X"),一句话复述 + 直接改即可。

"只第一次"的红线:

  • 同一个需求只出一次完整方案;确认后进入执行,不要每一步都问"要不要继续";
  • 只有出现以下情况才再确认一次:用户提出新的独立需求;或执行中发现必须超出已列文件范围(此时只追加"增量方案 + 新增文件",不要重发整套)。

2. 允许的只读侦察(不改文件)

出方案前可以做只读动作把文件清单弄准:

  • read / grep / glob 目标代码;
  • 只读 shell(Get-ChildItem、Select-String、git status/diff 等);
  • 禁止在确认前 write/edit/mkdir/mv/rm,禁止跑构建/部署/长任务。

侦察控制在必要范围;如果确实看不完,就在方案里标记"待确认项",不要瞎猜路径。

3. 首次回复的固定结构(一次给全)

按以下 5 块输出,中文,正文控制在 250 字左右(表格不计):

  1. 理解:一句话复述需求("我理解你要的是……"),方便用户纠偏。
  2. 做法:3–7 步、按执行顺序、每步一句,写清先后依赖。
  3. 涉及文件:表格,必须具体到文件路径;标注操作与作用:

    操作文件改什么
    修改src/pages/school/expert/index.vue查询区加高校下拉、列表联动
    修改application/controllers/school/Info.phplists 方法接收 school_id 并过滤
    新建application/views/...(如确实需要)

    路径不确定的标 ? 并说明原因;按"前端 / 后端 / 配置 / 测试"分组或加"端"列。

  4. 假设与风险:最多 3 条,尤其写出"会改变范围"的假设(如"假设 school_id 字段已存在")。
  5. 不做的事:明确边界("不改导入导出/不动详情页"),防止范围膨胀。

最后必须用 ask_user_question 请求确认:

{
  "questions": [{
    "id": "confirm-plan",
    "header": "确认方案",
    "question": "按上面的做法和文件清单执行吗?",
    "options": [
      { "label": "执行(推荐)", "description": "按方案和文件清单开始改" },
      { "label": "先调整", "description": "我会告诉你改哪一步/哪些文件" },
      { "label": "取消", "description": "先不改" }
    ]
  }]
}

用户选"先调整"时:只针对差异重新给增量方案(改哪步、加/减哪些文件),然后再确认,不要整篇重发。

4. 确认后的执行规则

  • 先 todo_write:第一项"方案已确认",其余为方案步骤(可勾选);
  • 只改清单内的文件;发现清单外的问题 → 记入"后续项",不顺手改;
  • 需要超出清单(新增文件/改公共组件/动数据库/动配置)→ 暂停,给增量方案 + 新增文件,确认后再继续;
  • 用户说"不用确认了"后,不再出方案,直接按当前理解执行,但仍按上面的文件边界执行;
  • 交付时给对账表:每条用户要求/验收点 → 改在哪个文件(+ 关键位置)+ 静态自检结果;
  • 遵守项目自身规则(例如:不主动跑构建、不用浏览器工具、不造测试数据),需要验证时由用户执行。

5. 输出示例(缩略)

理解:专家列表查询区加"所属高校"筛选,按 school_id 过滤。

做法:① 确认 school_id 字段与字典来源 → ② 前端查询区加下拉 → ③ 列表请求携带参数 → ④ 控制器接参并过滤 → ⑤ 静态自检。

涉及文件:

操作文件改什么
修改src/pages/school/expert/index.vue查询区下拉 + 请求参数
修改application/controllers/school/Info.phplists 接收并过滤 school_id

假设:school_id 已在 expert_info 表;字典在 myconfig.php 的 school_list。不做:不改导入导出、不改详情页。

(随后 ask_user_question 请确认)

6. 反例(不要这样)

  • 先改代码再补方案;确认前就 write/edit;
  • 方案写成 20 行作文,或只说"我会优化相关文件"而不给具体路径;
  • 确认后每一步都问"要继续吗";
  • 每个新消息都重新出一遍完整方案(只在新需求或范围变化时增量确认);
  • 文件表里写"多个文件""相关页面"这种模糊项。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.