用途:assess 用于对代码、设计或方案做结构化质量评估,回答“这是否够好”。调用方式为按技能名调用,例如 assess backend/app/services/auth.py、assess our caching strategy、assess --model=opus the current database schema。
主要能力:按六个维度评分(正确性、可维护性、安全性、性能、可测试性、简洁性),加权计算综合分与等级,并给出优缺点、替代方案比较、改进建议与工作量估算。评分要求 file:line 证据,缺少证据的分数不计分。
工作量档位:low/medium 只跑部分维度;high(默认)跑全部六维并含优缺点;xhigh 额外一次针对不确定性与注意事项的评估,并输出每个维度的置信度。xhigh 在未实现该档位的模型上会静默回退为 high。
参数解析:支持 --model=(如 opus、sonnet、haiku、fable 或完整 ID)与 --effort=;工作量优先读 CLAUDE_EFFORT 环境变量,显式 --effort= 覆盖优先。目标若为代词或空,会回溯对话中最近的明确对象;仅当对话为空时才询问。
流程:先探测 MCP 与检查续跑状态,用 AskUserQuestion 确认评估维度(完整/仅代码质量/安全重点/快速评分),再进入目标理解、范围发现(文件上限 30)、六维评分、优缺点分析、替代方案比较、改进建议、工作量估算与报告。
限制与说明:Phase 2 由 Workflow 脚本 assess-fanout.js 执行;无 Workflow 工具时回退到 Agent 工具。high 最多 4 个单向参考性反驳者,xhigh 为 3 个反驳者的多数票;反驳不会抬高分数或把 fail 翻成 pass。跨模型反驳需配置 ORK_ALT_MODEL_CMD,默认关闭。--render= 默认 both,json-render 模式需用 render-spec.mjs --check 校验,失败则回退为仅 markdown;验证失败不得写入不完整 spec。