Agent Skills
返回列表
💻

Sofagent 变更机器审阅

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e71c0c4e/cordis-plugin-sofagent-audit。

技能介绍

要解决的问题

在 Cordis 里接 Sofagent 工作流时,变更审阅往往还停留在人工扫 diff 或零散 lint:既难对齐团队统一的规则集,也难在 工具调用节点(如 tools/pre-execute、tools/result、fs/write-intent)上留下可复核的审计痕迹。本插件面向「机器审阅」场景,把审阅逻辑与 sofagent 主线里的 @sofagent/audit 对齐,而不是另起一套互不兼容的检查脚本。

核心能力与工作方式

插件随 sofagent 主线在 SkillHub 发布,版本与主仓一致。审阅链路大致包括:

  • 24 条规则:作为机器审阅的显式规则集,可与 runRules 一类能力衔接。
  • git diff 硬证据:以 diff 作为审阅输入的客观依据,减少「口头声称已改」与事实不一致的情况。
  • 节点级审计:在 seam 层面关注 tools/result、tools/pre-execute、fs/write-intent 等关键点,便于回放「谁在什么节点写了什么、执行前后状态如何」。

整体上,它是 Cordis 侧 DSH 插件家族中的一员,职责是桥接 @sofagent/audit,把变更机器审阅嵌进既有 agent 管线,而非单独提供一个通用静态分析 CLI。

适用边界与注意点

  • 安装与检索走 SkillHub(skillhub install cordis-plugin-sofagent-audit);资料中说明 npm 通道未开通,不要按普通 npm 包假设分发路径。
  • 能力深度依赖 sofagent 审计实现与规则定义,排障时应对照 sofagent 主仓 及 docs/changelog/v1.4/v1.4.0.md 等变更说明。
  • 若团队没有统一的 git 提交流程或不愿在 agent 节点暴露写盘/执行意图,节点级审计的价值会打折扣;规则集也需与真实代码库约定一致。

使用场景

  • 合并 PR 前用 24 条规则对 git diff 做自动审阅并留下可复核结论
  • 在 agent 调用 `tools/pre-execute` 与 `tools/result` 时记录节点级审计供事后回放
  • 通过 `fs/write-intent` seam 核对自动化改文件前的写盘意图是否符合规范
  • SkillHub 部署 Cordis + Sofagent 管线时需与主线 `@sofagent/audit` 保持同一套 runRules

适合人员

  • 维护 KongFangXun/sofagent 主仓、要在 Cordis 里启用 DSH 审计插件的后端工程师
  • 负责 agent 工具链合规、需要在 pre-execute/result 节点留痕的安全或平台同学
  • 在 SkillHub 集成 Sofagent 工作流、不想维护第二套审阅脚本的集成开发者
  • 用 git 流程管控发布、希望审阅输入固定为 diff 硬证据的技术负责人