SuperAPI AI 工具集

scope

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

用途:Scope 决定一个任务究竟要做什么,并把它写下来,避免后续环节靠猜。它不负责研究、设计或构建,也不验证自身,只能被检查形式,无法被检查契约是否正确,因此它是一次与人的对话,而不是一张表单。

主要能力:把契约记录为任务自身文件夹中的 alignment.json,与 task.json、task.md 并列;旁边的 alignment.md 由它渲染供人阅读,且不会被反向解析。所有写入都通过 scope-actions.sh 完成;拒绝 surfaces 提议时运行 surfaces-actions.sh decline。两者都在本技能的授权内,无需询问即可运行,其他 Bash 命令仍需批准。

使用方式:先确定运行模式。任务上写明 autonomous 或 light 时,全程自主执行,并在每次写入调用中传 --run-mode autonomous;其他情况(包括没有活动任务)默认交互式,传 --run-mode interactive 或不传。read 不需要运行模式。Scope 只针对已存在的任务运行,不创建任务,也不为没有文件夹的名字搭建占位。需要先解析活动项目自身的文件夹(含 project.json,而非代码文件夹)。任务为给定的 <taskId>,或对话中已激活的任务;两者都未知,或 <projectPath>/tasks/<task-id> 下没有 task.json,则用一行说明并指出 task 技能,然后停止。

读取现有内容:运行 "${CLAUDE_PLUGIN_ROOT}"/skills/scope/scripts/scope-actions.sh read "<task_folder>",输出契约存在与否、路径、标准与非目标 id、目标是否已设置。存在表示更新,先读该文件;不存在表示首次运行。首次运行还要直接读 task.md,以及存在时的 alignment.v5.md。

起草与对话:三种姿态——reflect and refine(已有目标与大部分契约,渲染并展示,问哪里不对或缺失)、draft and confirm(有一些但不足以反映,起草整份契约)、explore openly(确实什么都没有,问一个开场问题:完成后什么应当为真)。首次运行先起草全部字段,通过 init、set-goal、add --author designer 和 add-non-goal 写入,再渲染并整体展示一次,只问哪里不对或缺失。每条修正对应一次写入:目标或预期结果用 set-goal,标准或非目标用 update,新增标准用 add,删除用 remove,新增非目标用 add-non-goal;人改写或新增的标准立即记为 --author owner。

验收标准:是任务完成后人能看见的结果,用用户故事式措辞,从代码之外书写,不点名类、文件或阶段。每条需起草结果、验证子句,以及由机器还是人检查。作者只有 designer 与 owner 两个值,缺失答案绝不算 owner。不要传 verdict,它保持未回答直到任务结束评审。

非目标:主动询问而非等待。草案包含来源明确提到的非目标,也包含探针,每个探针给出 in 或 out 的推荐答案,默认按 out 写入。

自动化测试:每个任务问一次是否有自动化测试,推荐 yes,除非调用行、task.md 或人说明没有。答案属于契约,approve 时一并签署。light 任务不问也不运行 set-tests。

测试与检查:Scope 不搭建任何东西,只使用已开启的类型。读取 <projectPath>/project.json:surfaces.e2e.enabled 为 true 时,每条标准的验证子句写为 machine 并指明自动化测试;surfaces.visualRegression.enabled 为 true 时,检查任务改动的界面是否已有基线,有则成为一条验证子句指明视觉回归检查必须通过的标准,没有则成为一条“创建其基线是本任务自身工作”的标准。

限制:不创建任务、不搭建测试、不自我验证;契约正确性只能由人判断;alignment.md 不会被解析回读;除 read 外的调用在任务于其 worktree 中构建而当前窗口在别处时以退出码 79 拒绝,需按提示的路线重试。资料未提供收费、价格与平台信息。