Sofagent 变更机器审阅
将以下提示词粘贴到你的 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 硬证据的技术负责人