用途:以交互方式追踪系统跨层流程,覆盖 CODE、API、AUTH、DATA、NETWORK 五层,把追踪结果存入 SQLite 并支持多格式导出,用于安全审计、合规、文档、调试、架构评审等场景。主要能力:一个会话可含多个命名流程,支持分支与合并等非线性结构;记录 tuple(节点)与 edge(关系),关系包括 TRIGGERS、READS、WRITES、VALIDATES、TRANSFORMS、BRANCHES、MERGES;可记录 findings;导出 json、yaml、md、mermaid 或全部;导出前用 validate 校验,生成带入口标记、步骤编号、图例的 Mermaid;提供 git 合并/差异驱动与可选 CSV 备份。使用方式:先读 schema.sql,再检查 .audit/audit.db 是否存在;不存在才可 audit.py init。常用命令如 python .claude/skills/audit-flow/scripts/audit.py list / show <session> / show <session> <flow> / export <session> / validate <session>;git 集成用 audit.py git-setup,合并用 db-merge %O %A %B;CSV 有 csv-export、csv-import、csv-merge <theirs_dir>。交互流程要求向用户询问会话名、用途与粒度(fine 约 50-200 tuple,coarse 约 10-30 tuple),决策点询问是否深入、标记关注或添加 finding,导出时询问格式。限制与规则:SQLite 是唯一事实来源,上下文窗口不可信;.audit/audit.db 已存在时禁止 init、删除、DROP TABLE 或重建,只允许 list、show、export 或 INSERT;写数据须逐条 INSERT,引用 ID 前先查询 DB,每 5 个 tuple 用 show 检查点;BRANCHES 边必须带条件;观察性结论应记为 finding,不得用 VALIDATES 串联观察;节点 40+ 警告、60+ 报错须拆分;所有图表必须由 audit.py export 生成,不得手写 Mermaid。Git 冲突时按会话名合并,较新 updated_at 生效。收费、价格与具体平台支持资料未提供。
audit-flow
通用与其它
更新于 10-16 02:32