mcpField
C
cawplan-risk-assessment

cawplan-risk-assessment

github.com/cawcut测试与质量179 次安装2 天前更新
代码仓库

关于 cawplan-risk-assessment

面向执行 CawPlan A5 发版风险评估的 Agent 技能,规范历史查询、风险计算、报告解读与保存流程。它要求风险等级遵循 compute 结果,并通过用户确认和双重闸门控制保存。

主要功能

  1. 01按规则计算风险等级
  2. 02查询历史评估与阈值
  3. 03只读补充版本和工单上下文
  4. 04生成分层风险报告
  5. 05确认后按双闸门保存

适用场景

  1. 01计算某个版本的发布风险
  2. 02查看历史风险结论而不重算
  3. 03补充工单和执行失败背景
  4. 04用户确认后保存评估报告

安装

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

$npx skills add https://github.com/cawcut/skill-cawplan --skill cawplan-risk-assessment

安装后在 Claude Code 中输入/cawplan-risk-assessment确认已加载。

包含的文件

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

references/
compute-rules.md
save-rules.md
ux.md

详细介绍

来自项目 README

CawPlan Risk Assessment — A5 发版风险评估

cawplan skill check

硬门禁(MUST)

  1. 规则算等级、AI 做摘要:risk_level 以 compute 响应为准;Agent 不得自行重算或静默降级 CRITICAL。
  2. 保存须双闸:展示 compute 结果 → 用户确认 → --body-file + --dry-run → 提交闸 → --confirm 执行 save。
  3. 禁止把 A3 执行进度、cawplan-plan-track 的排期 risk/risk_reason 当作 A5 结论;禁止声称本结论等同于 A8 Ticket Report 的 Release Readiness。 允许调用 versions track / tickets search / execution failures 作只读上下文富化,须标注「不参与规则计算」。
  4. 禁止 cawplan api、直连 TestRail、A1/A2/A4/A8 写操作。
  5. 用户展示:友好字段名;product_id/version_id/UUID 默认隐藏;Agent 自行 AskUserQuestion(不写入 allowed-tools)。

Reference 加载(MUST)

时机Read禁止
开场无一次性 Read 全部 references
解析上下文 / compute / 富化 / 解读 reasonscompute-rules.md—
输出模板 / 富化表 / runs 附录ux.md与 save-rules.md 一并 Read
保存 / override / 衔接 A4·A7save-rules.md—

允许命令

Step命令
辅助products list、versions list
只读富化(Step 4b)versions track <product_id> <version_id>
只读富化(Step 4b)tickets search --unique_ids <id1,id2,...>(无需 --time_range)
只读富化(Step 4b)qa-insights testrail execution failures <product_id> <version_id> [--run-id] [--limit]
阈值(可选)qa-insights risk-rules get <product_id>
历史qa-insights risk-assessment get <product_id> <version_id>
计算qa-insights risk-assessment compute <product_id> <version_id> [--ticket-id] [--plan-mapping-ids] [--no-refresh-execution]
保存qa-insights risk-assessment save <product_id> <version_id> --body-file <path> [--dry-run] --confirm

Workflow

Step动作Detail
0解析 product / version;可选 ticket_idcompute-rules.md §0
1意图分流:仅查历史 vs 重算 vs 保存compute-rules.md §Intent
2可选 risk-rules get(用户问阈值或 HIGH 原因)compute-rules.md §Rules
3可选 risk-assessment get(仅历史且未要求重算)compute-rules.md §Get
4risk-assessment compute(默认刷新执行数据)compute-rules.md §Compute
4b只读富化(compute 或 get 后;按 reason 条件触发;可并行)compute-rules.md §Enrich · ux.md §Enrich
5Agent 解读:摘要 + 分层报告;不改 risk_levelux.md §Output
6保存决策闸(用户未要求保存则停)save-rules.md §Prompts
7组装 body-file → --dry-run → 提交闸 → --confirmsave-rules.md §Save
8保存结果 + 文末衔接一句(A4/A7)save-rules.md §Handoff

用户明确「只要上次结论 / 不重算」 → 跳过 Step 4,走 Step 3 → 4b → 5。
用户明确「保存」但本会话无 compute → 先 Step 4 或确认沿用 get 记录后再 save。

输出概要

未保存:风险等级 + 发布/完成度上下文 + 覆盖率优先指标 + 富化详情表 + 建议行动 + 是否保存询问。
已保存:追加 saved_at、saved_by、note、ai_summary。
模板见 ux.md §Output、save-rules.md §Saved。

References

  • compute-rules.md — 上下文、compute/get、等级与 reasons 解读、富化触发
  • ux.md — 报告模板、富化表、runs 附录、建议行动展示
  • save-rules.md — 保存 body、override、确认闸、A4/A7 衔接

评论

支持 Markdown