Audit 是 bkit-claude-code 中的一个用户可调用技能,主要用于查看审计日志、决策追踪和会话历史,帮助用户了解 AI 在开发流程中的行为与决策过程,提升透明度。
用途
该技能面向需要追踪 AI 自动化流程的用户,提供对审计日志和决策记录的查询能力。它记录并展示 PDCA 事件(如阶段转换、门禁通过/失败等)在内的多种动作类型,共 19 种 ACTION_TYPES。
主要能力
Audit 提供以下子命令:
- 无参数(默认,等同于 log):显示最近的审计日志条目。读取当天 .bkit/audit/YYYY-MM-DD.jsonl 日志;若当天日志为空或少于 20 条,则同时读取前一天的日志。解析 JSONL 条目后,按时间倒序显示最后 20 条,每条包含时间戳、动作、功能和详情。
- log:显示最近 20 条审计日志条目。
- trace <feature>:显示指定功能的决策追踪。读取 .bkit/decisions/YYYY-MM-DD.jsonl 中的决策追踪文件,筛选匹配指定功能的条目,按时间顺序展示决策链及理由。
- summary:显示每日或每周审计摘要。读取当天(可选过去 7 天)的审计日志,按动作类型聚合计数,计算关键指标,包括总动作数、阶段转换次数、自动化与手动比例、错误/恢复事件、平均信任分数变化,并展示格式化摘要及每周趋势。
- search <query>:按动作类型、功能名称或日期范围搜索审计日志。解析查询以确定过滤类型:若匹配动作类型则按动作过滤,若匹配功能名称则按功能过滤,若匹配日期(YYYY-MM-DD)则按日期过滤,否则进行全字段全文搜索。读取 .bkit/audit/ 下相关 JSONL 文件,应用过滤后返回最多 50 条匹配结果,按时间顺序显示。
使用方式
通过斜杠命令调用,例如:
- /audit
- /audit log
- /audit trace user-auth
- /audit summary
- /audit search "phase_transition"
- /audit search "user-auth"
- /audit search "2026-03-18"
- /audit search "error"
文件位置与格式
- .bkit/audit/YYYY-MM-DD.jsonl:JSONL 格式,每日审计日志条目。
- .bkit/audit/summary/:JSON 格式,预计算的每日/每周摘要。
- .bkit/decisions/YYYY-MM-DD.jsonl:JSONL 格式,决策追踪条目。
模块依赖
- lib/audit/audit-logger.js 的 readAuditLog():读取审计条目。
- lib/audit/audit-logger.js 的 searchAuditLog():搜索/过滤条目。
- lib/audit/decision-tracer.js 的 getDecisionTrace():读取决策追踪。
保留策略
- 审计日志:保留 30 天,通过每日钩子自动清理。
- 决策追踪:保留 30 天,与审计日志关联。
- 总存储预算:100MB,超出时自动修剪最旧数据。
适用场景
适用于需要审查 AI 在开发流程中的阶段转换、决策依据、自动化级别变化、检查点创建、错误与恢复等事件的场景,帮助团队追踪功能开发过程中的关键节点。
限制
资料未提供关于收费、价格、平台兼容性、性能效果等方面的信息,暂未提供。