tiers

按风险与验证深度给开发任务分级（L0–L4）并路由到对应工作流的 Claude Code / Codex 插件。Claude Code 里通过 / 菜单使用；Codex 里会在开发需求中自动触发。

接到一个开发需求，先判它属于哪一级（从 L0 大型改造到 L4 文案微调），再走对应的工作流——减少“小改动当大事做”的过度工程，也减少“大改动当小事做”的漏测回归。插件还能跨 session 续行、按你的纠正自我进化，并可选接入 codegraph 做客观判级。

它能做什么

• 分级决策树（L0–L4）+ 判级加固：显式判级输出、tie-breaker（拿不准走更严级别）、边界示例表。
• 跨 session 续行：每个项目一份状态文件，脚本独占读写，换会话不丢进度。
• 跨项目自主进化：你纠正判级 → 积累 → 同类够阈值 → 提案把规则固化进 skill（人工放行）。
• codegraph 判级集成：装了 code-review-graph 时用客观风险分校准级别；没装则自动降级为纯人工判级。
• 依赖 doctor + 内置兜底：检测 skills / CLI / MCP 能力，输出 base / enhanced / full 模式；缺增强依赖时不阻塞核心工作流。
• 对抗评审 provider 分层：没有外部模型时走内置 checklist；有平台子代理、多模型或外部 CLI 时升级为只读交叉评审。
• 统一外部 Agent 委派：一个 external-agent skill + scripts/external_agent.py runner，按"搜集 / 实现 / 交叉审核"路由到 codex / cursor / grok / mimo / opencode / antigravity（agy）；--mode review（只读二次意见）或 --mode delegate（授权后可写），--SESSION_ID 多轮续接、--format json 归一输出。委派不降级工作流，主 Agent 负责核验。

安装

Claude Code（推荐，从 GitHub 安装）

在 Claude Code 里：

/plugin marketplace add whrjunluo/tiers
/plugin install dev-workflow@tiers

• 安装时选 user scope，让所有项目、终端与桌面/网页客户端都生效。
• 装完完全重启 Claude Code（退出进程重开，不只是新开对话），让 skill 与 hook 加载。
• 验证：/ 菜单出现 dev-workflow:dev-workflow、dev-workflow:grill-me、dev-workflow:external-agent。

Codex（从源码安装）

git clone https://github.com/whrjunluo/tiers.git
cd tiers
bash bin/install-codex

install-codex 是机器级一次性安装，会：把仓库注册为 Codex 本地 marketplace、在 config.toml 启用插件、把 dev-workflow、grill-me 与 external-agent 三个 skill 链接进 $CODEX_HOME/skills/（默认 ~/.codex，旧同名 skill 先备份）、初始化全局数据区。装完重启 Codex 或新开会话。

加 --install-deps 会一并把伴侣 skill 装好（Codex 走 skill 文件，非 /plugin）：

bash bin/install-codex --install-deps
# 自动 npx skills add：obra/superpowers（L1 完整链）、mattpocock/skills（grill-with-docs）

不加则只打印这两条命令，让你手动决定。

Cursor（从源码安装）

git clone https://github.com/whrjunluo/tiers.git
cd tiers
bash bin/install-cursor

install-cursor 是机器级一次性安装，会：把 dev-workflow、grill-me、external-agent 三个 skill 链接进 ~/.cursor/skills/（旧同名 skill 先备份）、初始化跨工具统一的全局数据区。装完 Reload Window 或完全重启 Cursor，让 skill 索引重新加载。

• 验证：Agent 里输入 / 能看到 dev-workflow / grill-me / external-agent，或直接描述开发需求触发自动判级。
• 同样支持 --install-deps 一并安装伴侣 skill（npx skills add）。
• 关于 hook：Cursor 的 beforeSubmitPrompt（对应 Claude 的 UserPromptSubmit）只能放行/拦截、不能向模型注入上下文，故不安装"判级纠正提醒"hook。该能力由常驻的 dev-workflow skill 兜底——判级被纠正时 Agent 会主动用 learnings.sh 记录，进化功能完整，仅少了 Claude/Codex 上那层自动提醒。

Cursor 也认 .cursor-plugin/plugin.json，所以本仓库同时是一个合法的 Cursor 插件；若日后上架 Cursor Marketplace 或用本地插件目录（~/.cursor/plugins/local/）安装，同一份 skills/ 可直接复用。

安装后可随时跑 doctor 看当前能力等级：

bash bin/doctor --repo <你的项目路径>

初始化项目（可选）

首次使用时数据区会自动创建，通常无需手动初始化。只有当你想让插件额外做这两件事时，才在项目根目录运行 bin/init：

1. 把续行状态文件加进项目 .gitignore
2. 检测到 code-review-graph 时，可选为本项目注册 codegraph MCP（解锁 Mode B 事前依赖查询）

# Codex / 已 clone 源码：在你的 clone 目录下
bash bin/init [--repo <项目路径>] [--yes]

# Claude Code（插件装在缓存里）：让 dev-workflow skill 帮你初始化当前项目即可

使用

装好后无需手动跑脚本。新开会话，直接描述你的开发需求即可，不需要提 dev-workflow：

帮我给订单列表加一个批量导出

插件会先判级、输出一行结论，再按对应流程执行：

级别 = L2｜理由 = 改已有逻辑，有回归风险

如果新会话没有自动判级，通常是 Codex 还没重新加载 skill 索引。先重启 Codex；排查时再临时点名 dev-workflow，看 skill 是否已安装成功。

能力模式

dev-workflow 不要求用户先装齐所有伴侣 skill/MCP 才能使用。运行：

bash bin/doctor --repo <项目路径>

会输出当前模式：

doctor 还会输出对抗评审能力：

平台内子代理和多模型能力由运行时检测：如果当前 Codex/Claude 暴露 subagent 工具，dev-workflow 会优先使用平台子代理；用户明确允许多模型时，再给 reviewer 分配不同模型。没有这些能力时不阻塞，退回内置 checklist。

默认不会静默安装依赖。需要自动安装可脚本化依赖时，显式运行：

bash bin/doctor --repo <项目路径> --install-deps

MCP、Figma 授权、外部 agent 登录这类需要用户权限的能力只会给出下一步，不会自动改本机授权状态。

调用外部 Agent（可选）

external-agent 支持多个独立 CLI：codex / cursor / grok / mimo / opencode / antigravity（各自的安装与登录见下方「依赖」表；--list 查当前已装可用的）。它们是独立 agent、各自鉴权，不是同一 agent 的不同模型。

个人免费账号及 Google AI Pro/Ultra 用户使用 Gemini 相关能力时，先安装并登录 Antigravity CLI（gemini CLI 个人版已停用）：

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy

之后可要求主 Agent“用 external-agent / agy / cursor-agent / grok 独立审查这次改动”。底层 runner 也可直接使用：

# 只读独立审查当前改动
python3 <plugin-root>/scripts/external_agent.py --agent antigravity \
  --cd "$PWD" --context git --PROMPT '独立审查当前改动，只报告有证据的问题'

# 授权后让 agent 实现（可写，限定在 --cd 内）
python3 <plugin-root>/scripts/external_agent.py --agent codex \
  --cd "$PWD" --mode delegate --format json --PROMPT '实现 X，输出 diff'

--agent 可选 codex / cursor / grok / mimo / opencode / antigravity（--list 查可用）。--mode review（默认，只读二次意见）/ --mode delegate（授权后可写）。--context git 把分支、git status、diff 摘要与当前 diff 作为共享上下文附加到任务前；研究类问题用 --context none。--format json 归一为 {success, SESSION_ID, agent_messages}，--SESSION_ID 多轮续接。runner 用保守权限参数、不会静默回退到别的 agent。不要把密钥、.env 内容或无关私有文件发送给外部 Agent。

脚本路径

所有脚本在仓库根目录的 scripts/ 下（不在 skills/dev-workflow/ 下）。以仓库根为 <plugin-root>：

<plugin-root>/scripts/workflow-state.sh check     # 正确
<plugin-root>/skills/dev-workflow/scripts/...      # 错误，此路径不存在

workflow-state.sh check 在新项目没有状态文件时会输出「无续行状态」并正常退出。

分级速查

codegraph 集成（可选，三层降级）

数据存哪（代码与数据分离，更新插件不丢数据）

依赖

必需：bash、awk、python3、git

不装这些也完全可用：核心路径会走内置协议；装上解锁更完整体验。bin/doctor 和 bin/init 会打印缺失能力；加 --install-deps 会自动安装可脚本化的依赖（superpowers 在 Claude 上仍需手动，见下）。

superpowers 在 Claude Code 须通过官方插件安装（命令行无法自动完成）；其他平台安装其 skill 文件即可。

内置 skills

• dev-workflow — 工作流路由主 skill。
• grill-me — L0/L1 设计文档定稿前追问一轮、补边界。Vendored from mattpocock/skills（MIT © 2026 Matt Pocock，见 LICENSES/grill-me-MIT.txt）。
• external-agent — 统一外部 agent 委派：一个 scripts/external_agent.py runner 路由到 codex / cursor / grok / mimo / opencode / antigravity（agy），支持 --mode review|delegate、--format text|json、--SESSION_ID 多轮、--context git、--list。codex/gemini 适配解析逻辑参考自 GuDaStudio/skills（MIT），其余为本仓原创，见 LICENSES/collaborating-skills-MIT.txt。

诊断脚本

• bin/doctor / scripts/dependency-doctor.sh — 输出当前机器和项目的能力矩阵；默认只检测，--install-deps 才安装可脚本化依赖。

平台兼容

同一份 skills/、scripts/ 服务三端：Claude Code 通过 .claude-plugin/，Codex 通过 .codex-plugin/，Cursor 通过 .cursor-plugin/（skill 链接进 ~/.cursor/skills/）。hooks.json 的"判级纠正提醒"hook 仅 Claude/Codex 启用；Cursor 不支持 prompt 提交时注入上下文，改由常驻 skill 兜底。脚本用 DEV_WORKFLOW_PLUGIN_ROOT / CODEX_PLUGIN_ROOT / CLAUDE_PLUGIN_ROOT / CURSOR_PLUGIN_ROOT 统一解析路径，无任何硬编码绝对路径。

License

MIT（grill-me 单独遵循其上游 MIT，见 LICENSES/）。