mcpField
R
risk-classification

risk-classification

github.com/atholaAgent 工作流343100 次安装1 天前更新
代码仓库

关于 risk-classification

面向 Agent 和编排器的任务风险分类技能,低风险任务使用文件模式启发式判断,高风险任务通过可逆性评分进一步评估。它还按风险等级设定验证、审批和自动化要求。

主要功能

  1. 01四级风险模型
  2. 02基于文件模式的启发式分类
  3. 03高风险任务可逆性评分
  4. 04分级验证与并行安全规则
  5. 05风险元数据和自动化默认值

适用场景

  1. 01分配任务前评估风险
  2. 02为变更设定验证要求
  3. 03判断任务能否并行执行
  4. 04对关键任务要求人工审批

安装

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

$npx skills add https://github.com/athola/claude-night-market --skill risk-classification

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

包含的文件

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

modules/
automation-tiers.md
heuristic-classifier.md
readiness-levels.md
tier-definitions.md
verification-gates.md

详细介绍

风险分类

概述

为 Agent 任务提供内联风险分类,采用 4 级模型(GREEN/YELLOW/RED/CRITICAL)。低风险级别使用快速启发式文件模式匹配,高风险级别则委托给 Skill(attune:war-room-checkpoint),进行完整的可逆性评分。

适用场景

  • 在分配任务给 Agent 前评估风险
  • 确定任务完成所需的验证要求
  • 判断任务间并行执行是否安全
  • 在任务清单中添加风险标记

不适用场景

  • 单文件的简单更改(默认视为 GREEN)
  • 战略性架构决策(改用完整的 Skill(attune:war-room))
  • 非代码任务(仅涉及文档、配置注释)

4 级风险模型

级别颜色范围示例验证
GREEN安全单个文件,可轻松撤销测试文件、文档、工具无需验证
YELLOW谨慎模块级、用户可见组件、路由、视图冲突检查并通过测试
RED危险跨模块、安全/数据迁移、身份验证、数据库架构War-room RS、完整测试和审查
CRITICAL停止不可逆、受监管数据删除、生产环境部署War-room RS 和人工批准

混合路由

Task received
    |
    v
Heuristic classifier (file patterns)
    |
    ├── GREEN/YELLOW → Apply tier, continue
    |
    └── RED/CRITICAL → Invoke Skill(attune:war-room-checkpoint)
                        for reversibility scoring (RS)
                        |
                        └── RS confirms or adjusts tier

采用混合方式的原因:GREEN/YELLOW 分类快速且确定性强(文件模式匹配)。RED/CRITICAL 任务值得投入完整可逆性分析所需的开销,因为出错的代价很高。

任务元数据扩展

在任务元数据中添加风险级别,供下游使用:

{
  "id": "5",
  "subject": "Add user authentication",
  "metadata": {
    "risk_tier": "YELLOW",
    "risk_reason": "Modifies src/components/LoginForm.tsx (user-visible component)",
    "classified_at": "2026-02-07T22:00:00Z"
  }
}

没有 risk_tier 元数据的任务默认设为 GREEN(向后兼容)。

就绪级别

4 级就绪级别系统按级别提供清晰的风险 分类和所需控制措施:

级别名称适用情形所需控制措施
0常规影响范围小,易于回滚基本验证、回滚步骤
1关注用户可见的更改审查、负向测试、回滚说明
2提升安全/合规/数据对抗性审查、风险清单
3严重不可逆、受监管人工确认、两步验证

完整的级别定义、选择决策树和集成指南,请参阅 modules/readiness-levels.md。

渐进式自主性

风险分类决定对更改进行验证的严格程度。 自动化级别决定 Agent 行动的自主程度,以及何时必须 交还控制权。每个风险级别都有默认的自动化级别 (GREEN 对应 A3 自主运行,CRITICAL 对应 A0 手动操作);预先授权的 降级触发条件会在重复失败、信心下降、风险陡增或仓库状态不匹配时, 将 Agent 降低一个级别,而不是在相同级别重新提示。有关级别表和降级 触发条件,请参阅 modules/automation-tiers.md;有关从中读取 讲解/产出模式选择的内容,请参阅 imbue:assisted-mastery。

模块参考

  • tier-definitions.md:详细的级别标准、边界和覆盖机制
  • heuristic-classifier.md:自动分类的文件模式规则
  • verification-gates.md:各级别的验证要求和并行安全矩阵
  • readiness-levels.md:包含各级别所需控制措施的 4 级风险系统
  • automation-tiers.md:各级别的自主性默认设置和降级触发条件

集成模式

# In your skill's frontmatter
dependencies: [leyline:risk-classification]
面向任务生成器

在任务格式中追加 [R:TIER] 标记:

- [ ] T012 [P] [US1] [R:YELLOW] Create LoginForm component in src/components/LoginForm.tsx
面向编排器

分配任务前检查风险级别:

if task.risk_tier in ["RED", "CRITICAL"]:
    invoke Skill(attune:war-room-checkpoint) for RS scoring
    if CRITICAL: require human approval before proceeding

退出标准

  • 每项任务都已分配风险级别(明确指定或默认设为 GREEN)
  • RED/CRITICAL 任务均已获得 war-room-checkpoint RS 评分
  • 已通过指定级别的验证关卡
  • 不存在禁止组合级别的并行执行
  • 每项任务都带有自动化级别;触发降级时, 均记录降级原因

评论

支持 Markdown