用途
audit-export 用于将完整的 CocoAudit 审计轨迹导出为一份可直接交付给利益相关方的合规文档。它面向需要审计留痕、合规审查或对外说明完整事件记录的场景,强调“逐字、完整、不可覆盖”。
主要能力
- 读取 lifecycle/audit.md,该文件是只追加(append-only)的事实来源。
- 统计事件块总数,事件块以行首的
## [标识。 - 生成时间戳,格式为
YYYY-MM-DDTHH-MM-SSZ,其中冒号替换为连字符以保证文件系统安全。 - 将头部信息与完整逐字轨迹写入
.cocoplus/audit-export-[timestamp].md。 - 若请求了特定格式,则调用
reporting/report-export,参数为--source <exported-md> --format <markdown|html|pdf> --out-dir .cocoplus/audit-exports。 - 向开发者输出导出路径、事件总数以及导出渲染器状态。
- 每次调用都使用唯一时间戳,绝不覆盖先前的导出文件,因此对每次导出而言是幂等的。
使用方式
以 $audit export 触发。技能会按步骤执行:读取审计源文件、统计事件块、生成时间戳、写入 Markdown 导出文件;如指定格式,再通过共享导出器生成 Markdown、HTML 或 PDF。
退出标准
- 导出文件已写入
.cocoplus/audit-export-[timestamp].md。 - 开发者能看到路径与事件总数。
- 未覆盖任何先前的导出文件。
- HTML 导出通过
reporting/report-export提供;若未配置 PDF 渲染器,则报告渲染器状态。
限制与注意事项
- 审计源文件必须逐字完整导出,不能选择性读取或过滤事件。
- 同一天多次导出时,时间戳包含时间部分,因此每次导出唯一且非破坏性。
- PDF 输出取决于是否配置了渲染器;未配置时仅报告状态。
- 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。