mcpField
A
assess

assess

github.com/akshay-diwadkar测试与质量174 次安装今天更新
代码仓库

关于 assess

assess 是用于只读评估特定变更的 Skill，会对照用户请求、权威要求、仓库规则和证据，生成经过检查的评估结果，不修改目标或授予批准。

主要功能

  1. 01比对确切目标、基线与提交
  2. 02审查要求和变更证据
  3. 03判定受阻、有发现或无发现
  4. 04封存并检查评估结果

适用场景

  1. 01依据请求评估 Pull Request
  2. 02在限定审查范围内发现重大缺陷
  3. 03记录评估限制和证据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/akshay-diwadkar/first-four-hours --skill assess

安装后在 Claude Code 中输入/assess确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

skill-protocol.json
agents/
openai.yaml
references/
assess-guidance.md
blueprint-evidence.md
delegation-protocol.md
delta-review.md
publishing.md
pull-requests.md
scripts/
_diagnostic_contract.py
_script_support.py
_skill_protocol_runtime.py
assess_contract.py
check_assessment.py
cli.py
prepare_assessment_workspace.py
publish_findings.py
seal_assessment.py
templates/
assessment-bundle.json

详细介绍

评估

权限依据

评估会将一个精确的目标／基准／头部与原始用户请求、权威要求、任何可用的 Blueprint、仓库规则、测试和基准行为进行核对。为所有使用过的外部目标、权限依据、证据、证明或诊断创建快照；Git／仓库本地事实不需要快照。所需外部信息的时效性未知时，结果为 blocked。

评估为只读操作：绝不修复或编辑目标、合并、批准或修改 GitHub。实现由 Construct 负责；更广泛的缺陷／风险调查由 Diagnose 负责。assessment.md 是结果，不是批准、认证或合并权限。发布其中的发现是 check 之后的单独步骤，且只有用户明确同意后才能进行。

评估

如果你在当前上下文中编写或计划了此项更改，请依照有界委派协议，将整个阶段交给一个全新上下文的负责人；不要阅读其他内容；任何其他委派之前也先阅读该协议。

否则，先阅读评估指南；如果存在已封存的 Blueprint，也阅读Blueprint 证据；如果已有较早的评估，也阅读差异审查；如果目标拉取请求的头部可能不在当前仓库中，也阅读拉取请求。一次性确定精确的目标／基准／头部、当前权限依据、基准事实和请求的差异。在阅读 PR 正文、评论、审计或先前审查之前，先根据权限依据推导要求，并根据基准／头部推导更改；这些内容只是提示，可能补充待查项，但绝不能据此排除待查项。

之后，无论更改规模如何，在确定评估方法之前都要先咨询 reason：完整审查还是差异审查、范围和深度。

编写并封存

将最简模板包复制到技能目录和目标仓库之外，并按照指南中的模板包字段填写；模板没有默认判定结果。先准备一个新的 slug；封存只接受已忽略的 .first-four-hours/assessments/<slug>/assessment.md，绝不替换现有文件。Agent 负责判断时效性、深度、合规性、严重程度、发现、局限性、是否需要 Diagnose 以及结果；脚本只验证格式、精确的 Git／快照身份及新鲜度、定位信息、安全输出和完整性。

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

结果优先级：若不可用或相互矛盾的权限依据／证据／证明妨碍得出可信结果，则为 blocked；否则，若在有界评估中发现任何独立且重要的缺陷，则为 findings；否则为 clear。assessment.md 仅包含简明结果。

完成

python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
  --input output=<prepared output_path> --format json check

按封存内容报告结果、路径，以及每项发现的严重程度、缺陷和情境；不得据此声称已批准或已具备就绪条件。若结果为 findings 且 target 是拉取请求 URL，则阅读发布说明，并提出发布这些发现。封存并检查一份当前的 assessment.md，且处理完任何发布提议后，立即停止。最后提供一个符合此结果的可选后续步骤：用代码围栏给出一个自包含提示词，写明所需的任何仓库、议题、PR 或工件；或者说明无需后续步骤。只有用户回复“yes”才会启动该步骤，并通过其中指定的任何技能执行；但 charter、diagnose 或 ticket 步骤必须由用户以 /<skill> 命令运行。

评论

支持 Markdown