用途
assess 用于对某个 PR 或代码变更进行只读评估,将其与原始用户请求、权威需求、可用的 Blueprint、仓库规则、测试以及基线行为进行对照,关注正确性与代码质量等问题。评估本身不承担实现或修复职责:Construct 负责实现,Diagnose 负责更广泛的缺陷与风险调查。assessment.md 只是结果,绝不构成批准、认证或合并授权。
主要能力
- 确定精确的 target/base/head,只建立一次当前权威、基线事实与请求的变更范围。
- 先从权威来源推导需求、从 base/head 推导变更,再读取 PR 描述、评论、审计或既往评审;后者只作为可能补充候选问题的线索,不能用来消除问题。
- 对使用到的外部目标、权威、证据、证明或诊断做快照;Git/仓库本地事实无需快照。必需的外部时效性未知时判定为 blocked。
- 评估结果为只读操作:不修复、不编辑目标、不合并、不批准、不修改 GitHub。
- 结果优先级:不可得或相互矛盾的权威/证据/证明导致无法可信评估时为 blocked;否则输出 findings,报告在限定评估范围内发现的每一个独立实质缺陷;否则为 clear。
使用方式
若在当前上下文中撰写或规划了该变更,需按 Bounded Delegation Protocol 将整个阶段交给全新上下文的负责人,且不读取其他内容;该要求也在任何其他委派之前执行。
否则先阅读 assess 指引;若存在已密封的 Blueprint,读取 Blueprint 证据;若已有更早的评估,则进行增量评审。
将最小评估包模板复制到技能与目标仓库之外,并按指引中的包字段填写,模板没有默认结论。先 prepare,密封时只接受被忽略的 .first-four-hours/assessments/<slug>/assessment.md。
准备命令:
python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
--input slug=<slug> --format json prepare
python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
--input bundle=/absolute/assessment-bundle.json \
--input output=<prepared output_path> --format json run
完成校验命令:
python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
--input output=<prepared output_path> --format json check
当前性、深度、合规性、严重度、发现项、局限性、是否需要 Diagnose 以及最终结果由 agent 判断;脚本只校验形态、精确的 Git/快照身份与新鲜度、定位符、输出安全性与完整性。
密封并校验完成后,报告密封结果、路径以及每个发现项的严重度与缺陷,不作出超出该结果的批准或就绪声明。最后给出一个可选的下一步:一个围栏式的、自包含的提示词,写明其所需的仓库、issue、PR 或产物;或说明无需下一步。仅当用户回答“yes”才开始,通过其指定的技能执行;charter、diagnose 或 ticket 步骤由用户以其 /<skill> 命令运行。
适用场景
适用于在代码评审或变更验收前,对 PR/代码改动进行结构化、可追溯的独立评估,尤其需要对照 issue/spec 与验收标准、仓库规则、测试和基线行为判断正确性与质量时。
限制
- 只读,不做修复、编辑、合入、批准或 GitHub 变更。
- assessment.md 不构成批准、认证或合并权限。
- 依赖外部信息时需快照;要求的外部时效性无法确定时结果为 blocked。
- 当前性、深度、严重度等判断由 agent 作出,脚本仅做形态与完整性校验。
- 资料未提供收费、价格、平台支持范围等信息。