agentleFS
fitlab-aifitlab-ai/agent-infra/.agents/skills/close-dependabot/SKILL.md

close-dependabot

Skill88 starsChanged 20 days agoMITView on GitHub

关闭 Dependabot 安全告警并记录理由。 当某条 Dependabot 安全告警已处理或需按理由关闭时使用。

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

关闭 Dependabot 告警

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

关闭指定的 Dependabot 安全告警并记录合理的关闭理由。

任务入参短号别名

如果 {task-id} 入参匹配 ^[#]?[0-9]+$(裸数字或带 # 前缀),先读取 .agents/rules/task-short-id.md 的「SKILL 入参解析」段执行解析;后续命令视 {task-id} 为解析后的全长 TASK-YYYYMMDD-HHMMSS 形式。

步骤开始:本地生命周期边界

安全告警 API 仍由本技能处理;若存在关联任务,步骤 7 只声明一个本地 lifecycle intent,由核心统一提交基础元数据、日志、归档目录和短号。

执行流程

1. 获取告警信息

执行前先读取 .agents/rules/security-alerts.md,然后运行 agent-infra-internal platform-security read --kind dependabot --number {alert-number},解析其 JSON 结果获取告警详情。

验证告警处于 open 状态。如果已被关闭/修复,告知用户并退出。

2. 展示告警详情

向用户展示关键信息:

安全告警 #{alert-number}

严重程度:{severity}
漏洞:{summary}
包名:{package-name}({ecosystem})
当前版本:{current-version}
受影响版本范围:{vulnerable-version-range}
修复版本:{first-patched-version}

GHSA:{ghsa-id}
CVE:{cve-id}

3. 询问关闭理由

提示用户选择理由:

  1. 误报 (False Positive) - 漏洞代码路径在本项目中未被使用
  2. 无法利用 (Not Exploitable) - 漏洞存在但在当前上下文中无法被利用
  3. 已有缓解措施 (Mitigated) - 通过其他方式缓解了风险(配置、网络隔离等)
  4. 无修复版本 (No Fix Available) - 无修复版本且风险可接受
  5. 仅开发/测试依赖 (Dev/Test Dependency Only) - 仅在开发/测试中使用,不在生产环境中
  6. 取消 - 不关闭告警

4. 要求详细说明

如果用户选择关闭(非取消),要求提供详细说明:

  • 最少 20 个字符
  • 必须清楚说明为什么可以安全关闭该告警
  • 应引用具体证据(代码搜索结果、配置等)

5. 最终确认

即将关闭安全告警 #{alert-number}:

告警:{summary}
严重程度:{severity}
原因:{选择的理由}
说明:{用户的说明}

确认?(y/N)

6. 执行关闭

将用户说明写入 {comment-file},然后运行 agent-infra-internal platform-security dismiss --kind dependabot --number {alert-number} --reason {api-reason} --comment-file {comment-file}。解析 JSON 结果,仅当关闭状态为 applied 或 no-op 时继续。

API reason 映射:

  • 误报 -> not_used 或 inaccurate
  • 无法利用 -> tolerable_risk
  • 已有缓解措施 -> tolerable_risk
  • 无修复版本 -> tolerable_risk
  • 开发/测试依赖 -> not_used

7. 记录到任务(如存在)

如果有关联任务(搜索 security_alert_number: <alert-number>):

agent-infra-internal task-lifecycle {task-id} close-dependabot --agent {standard-agent-token} \
  --alert-number {alert-number} --reason "{reason}"

仅 status=applied|no-op 视为本地归档完成。若 API 已关闭但 lifecycle 返回 failed,必须明确报告“远端已关闭、本地待恢复”,展示 recovery steps,并以同一 intent 重试;不得手工更新 task.md、移动目录或释放短号。

8. 告知用户

渲染下一步前先读取 .agents/rules/next-step-output.md,仅为已选场景调用统一 helper,并将 stdout 填入 {next-step-commands}。

可选沙箱清理提示(门控渲染):仅当同时满足 (1) .agents/.airc.json 存在 sandbox 字段、(2) 第 7 步按告警号定位到了关联任务、(3) 该任务 task.md 的 branch 存在且不是 main / master、(4) 任务状态与沙箱 workspace identity 已交叉校验且无冲突时,才渲染清理提示。状态和 identity 决定命令:仅 completed + task-bound 使用完整 {task-id};仅在明确核对为 branch-only 时使用 {branch};active 不渲染自动清理命令;blocked / archive 只渲染人工核对提示,不渲染命令。状态或 identity 缺失、冲突时整段省略;关闭告警本身不能推断任务已完成。该块独立于「下一步」语义。

使用 agent-infra-internal agent-client next-steps --skill complete-task --task-ref {task-ref} 生成本场景的 {next-step-commands}。

安全告警 #{alert-number} 已关闭。

告警:{summary}
严重程度:{severity}
原因:{reason}
说明:{explanation}

查看:{alert-url}

注意:如有需要,可在平台侧重新打开。

可选:清理本任务的沙箱
(仅在关联任务为 `completed` 且 identity 为 `task-bound` 时,使用完整任务 ID:)

ai sandbox rm {task-id}

(仅在明确核对 identity 为 `branch-only` 时,使用分支名:)

ai sandbox rm {branch}

下一步 - 完成并归档任务(如有关联任务):
{next-step-commands}

注意事项

  1. 谨慎处理高严重程度告警:Critical/High 告警需要在关闭前进行充分分析。建议先执行 import-dependabot + analyze-task。
  2. 真实的理由:关闭记录保存在平台中,可能会被审计。
  3. 定期复查:已关闭的告警应定期复查,因为代码变更可能使关闭理由失效。
  4. 优先修复:关闭应作为最后手段。优先考虑升级、替换或缓解。

错误处理

  • 告警未找到:提示 "Security alert #{number} not found"
  • 已关闭:提示 "Alert #{number} is already {state}"
  • 权限错误:提示 "No permission to modify alerts"
  • 用户取消:提示 "Cancellation acknowledged"

安全责任边界:关闭前必须保留准确的处置理由、影响说明和所需确认。不得为追求继续执行而推断风险已消失、代替授权人确认,或绕过平台要求的安全确认;其他可独立完成的本地整理仍可继续。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.