Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Scope Check(范围澄清)

只问真正会改变行为、架构、安全、外部影响或验收的选择。

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 检查这项功能开始前是否还有必须由我决定的范围。能从仓库查到的不要问我。

工作方式

事实 → 可逆选择 → 实质决定 → 有界问题 → 继续或等待输入

判断顺序

  1. 先读取仓库、文档和当前状态;
  2. 识别 Agent 可以安全处理的可逆决定;
  3. 找出会实质改变结果的缺失选择;
  4. 把它压缩成一个可回答的问题;
  5. 继续不依赖该答案的工作。

什么情况下会提问

会提问 不会提问
两个方向会产生不同产品行为 可以从仓库查到的事实
涉及凭据、权限或外部发布 低风险、容易撤销的实现细节
涉及不可逆删除或数据边界 不影响验收的轻微偏好
缺少目标会改变验收标准 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。

安装

需要先安装 GitNode.js。以下命令都在终端中运行。

方式一:Clone 后安装(推荐)

git clone https://github.com/iamyijane/scope-check.git
cd scope-check
npx skills add .

安装程序会自动识别本机已有的 Agent,并询问安装到当前项目还是全局环境、使用符号链接还是复制文件。首次使用时,直接按交互提示选择即可。

方式二:从 GitHub 直接安装

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

About

只澄清会改变范围、架构、安全、外部动作或验收的关键选择。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors