只问真正会改变行为、架构、安全、外部影响或验收的选择。
scope-check 会先读取项目中能够确认的事实,区分低风险可逆决定和必须由用户决定的事项。它不会把普通任务变成长篇需求访谈。
| 使用环境 | 调用方式 |
|---|---|
| ChatGPT 桌面端 | 在 Skills 中选择,或输入 @scope-check |
| Codex CLI / IDE 扩展 | 输入 $scope-check,或用 /skills 查看已安装 Skill |
| Claude Code、Cursor、Gemini CLI、GitHub Copilot | 在提示中明确写“请使用 scope-check” |
scope-check 只在明确调用时运行。
请使用 scope-check 检查这项功能开始前是否还有必须由我决定的范围。能从仓库查到的不要问我。
事实 → 可逆选择 → 实质决定 → 有界问题 → 继续或等待输入
- 先读取仓库、文档和当前状态;
- 识别 Agent 可以安全处理的可逆决定;
- 找出会实质改变结果的缺失选择;
- 把它压缩成一个可回答的问题;
- 继续不依赖该答案的工作。
| 会提问 | 不会提问 |
|---|---|
| 两个方向会产生不同产品行为 | 可以从仓库查到的事实 |
| 涉及凭据、权限或外部发布 | 低风险、容易撤销的实现细节 |
| 涉及不可逆删除或数据边界 | 不影响验收的轻微偏好 |
| 缺少目标会改变验收标准 | Agent 已有足够上下文的普通选择 |
可以继续:不存在必须由用户决定的阻断;等待输入:给出一个会改变结果的有界问题;条件继续:记录暂定假设,同时推进不依赖该选择的部分。
- 不替用户决定产品范围、权限、公开发布或不可逆删除;
- 不询问可以通过只读检查获得的事实;
- 不把审美偏好和普通实现细节默认升级为阻断;
- 没有关键问题时直接继续,不为了完整感而提问。
本 Skill 遵循 Agent Skills 开放标准,推荐使用 Skills CLI 安装到 Codex、Claude Code、Cursor、Gemini CLI、GitHub Copilot 等本地 Agent。
npx skills add 安装的是本地 Agent Skill,不会把 Skill 上传到 ChatGPT 账号。若要在 ChatGPT 网页端或移动端向其他用户分发,需要另行打包为 ChatGPT Plugin。
需要先安装 Git 和 Node.js。以下命令都在终端中运行。
git clone https://github.com/iamyijane/scope-check.git
cd scope-check
npx skills add .安装程序会自动识别本机已有的 Agent,并询问安装到当前项目还是全局环境、使用符号链接还是复制文件。首次使用时,直接按交互提示选择即可。
npx skills add iamyijane/scope-check| 目标 | 命令 |
|---|---|
| 当前项目,由安装程序选择客户端 | npx skills add . |
| 全局安装到 Codex | npx skills add . -g -a codex |
| 全局安装到 Claude Code | npx skills add . -g -a claude-code |
| 全局安装到 Cursor | npx skills add . -g -a cursor |
| 全局安装到 Gemini CLI | npx skills add . -g -a gemini-cli |
| 全局安装到 GitHub Copilot | npx skills add . -g -a github-copilot |
安装后运行 npx skills list 确认。
也可以把整个 scope-check 目录手动复制到客户端的 Skill 目录,确保 SKILL.md 位于 scope-check/ 的第一层:
| 客户端 | 项目内目录 | 全局目录 |
|---|---|---|
| Codex | .agents/skills/scope-check/ |
~/.codex/skills/scope-check/ |
| Claude Code | .claude/skills/scope-check/ |
~/.claude/skills/scope-check/ |
| Cursor | .agents/skills/scope-check/ |
~/.cursor/skills/scope-check/ |
| Gemini CLI | .agents/skills/scope-check/ |
~/.gemini/skills/scope-check/ |
| GitHub Copilot | .agents/skills/scope-check/ |
~/.copilot/skills/scope-check/ |
新增提问规则时,请说明它会改变什么结果,并提供一个不应提问的反例。不要把单次沟通偏好写成所有任务的固定流程。
MIT