
plan-first
先议后行——AI 协作变更任务的议行分离机制 skill(Claude Code / DeepSeek Harness / ZCode 通用)
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up plan-first (claude-skill project) into my current project. Found on https://claudeers.com/plan-first Repo: https://github.com/hongshuxifan321/plan-first Homepage/docs: — Detected install method: claude-skill → # copy this skill into .claude/skills/plan-first/ Category: productivity. Platforms: cli. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
# copy the skill dir into your project: # .claude/skills/plan-first/ (or ~/.claude/skills/plan-first/ for all projects)
git clone https://github.com/hongshuxifan321/plan-first
// compatibility
| Platforms | cli |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | — |
| Pricing | open-source |
| Language | — |
plan-first:先议后行
一个 AI 协作机制 skill:任何会产生变更的任务,先出方案、等用户确认后才执行(议行分离)。适用于 Claude Code / DeepSeek Harness / ZCode 等支持 skills 机制的 Agent。
解决什么问题
AI 拿到任务就闷头改,改完才发现方向不对。plan-first 把「讨论方案」和「动手执行」强制分开:方案未获确认,不产生任何持久影响——不改文件、不跑有副作用的命令、不 push、不发布。
工作流程
- 判定级别:A 只读(直接做)/ B 小事(一句话确认)/ C 常规(完整方案块)/ D 复杂(方案块 + 阶段确认点)
- 输出方案块(C/D 类):目标、方案选项与取舍、影响范围(含是否触及红线)、验证方式、待确认点
- 等确认:用户说「执行 / OK / 动手」才开工;收到修改意见则更新方案再来一轮
- 执行纪律:TodoWrite 建清单、逐项执行逐项验证、被阻塞就停下问、不自动 commit/push
- 阶段确认(仅 D 类):一次批准只覆盖到下一个确认点
红线动作(删除文件 / git push / 改密钥 / 装全局依赖 / 对外发布)即使方案已确认,仍单独再问一次。
安装
把 SKILL.md 放进对应 Agent 的 skills 目录即可,无需其他文件:
| Agent | 目录 | 触发方式 |
|---|---|---|
| Claude Code | ~/.claude/skills/plan-first/ | /plan-first 或触发词 |
| DeepSeek Harness | ~/.dsh/skills/plan-first/ | /plan-first 或触发词 |
| ZCode | ~/.zcode/skills/plan-first/ | $ 菜单或触发词(skills 不进 / 菜单) |
触发词:「先议后行」「先商量」「方案先行」「议行分离」「先出方案」「plan first」。
三侧差异
三侧正文一字不改;仅 frontmatter description 的触发措辞按侧适配(ZC 侧无 / 命令,写为「用户主动调用时直接运行」)。本仓库以 CC/DSH 版为准。
同系列 skill
- agenttime——会话回顾散文
- econ-cn-docx——经管论文中文排版
// faq
What is plan-first?
先议后行——AI 协作变更任务的议行分离机制 skill(Claude Code / DeepSeek Harness / ZCode 通用). It is open-source on GitHub.
Is plan-first free to use?
plan-first is open-source, so it is free to use.
What category does plan-first belong to?
plan-first is listed under productivity in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/plan-first)
// retro hit counter
[](https://claudeers.com/plan-first)
// reviews
// guestbook
// related in Productivity
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Open source repository of plugins primarily intended for knowledge workers to use in Claude Cowork
Garry's Opinionated OpenClaw/Hermes Agent Brain
An open-source alternative to Claude Cowork (powered by opencode)