用途
Audit Trail 用于提供决策历史的双向遍历，帮助用户理解决策为何做出、决策之后发生了什么，并支持在多次验证会话中搜索特定模式。
主要能力
双向遍历
- 向前："这个决策之后发生了什么？"
- 向后："我们为什么做出这个决策？"
- 搜索："显示所有安全评审的拒绝记录"
持久化层
- 内存存储——仅当前会话
- 文件存储——.claude/coherence-audit/ 目录
- Git 提交——在提交信息中记录决策理由
使用方式
查看会话审计轨迹
/audit-trail show session-abc123
返回某个验证会话的完整决策历史。
按条件搜索
/audit-trail search security critic rejections
查找所有安全评审行使否决权的会话。
向后追溯
/audit-trail why was token storage changed to httpOnly
将决策通过评审评估追溯到原始需求。
向前追溯
/audit-trail what files depend on auth/middleware.ts
显示变更的下游影响（暴露分析）。
审计日志格式
{
"session_id": "session-abc123",
"timestamp": "2026-02-03T14:30:00Z",
"user": "reggie",
"operation": "coherence-check",
"scope": {
"files": ["src/auth/login.ts"],
"operation": "refactor to JWT"
},
"plan": {
"acceptance_criteria": [
"All tests pass",
"No OWASP violations",
"httpOnly cookies used"
],
"critics": ["code", "security", "domain"]
},
"iterations": [
{
"iteration": 1,
"code_critic": {"verdict": "approve", "reason": "..."},
"security_critic": {"verdict": "veto", "reason": "XSS in error msgs"},
"domain_critic": {"verdict": "approve", "reason": "..."}
},
{
"iteration": 2,
"code_critic": {"verdict": "approve", "reason": "..."},
"security_critic": {"verdict": "approve", "reason": "Fixed XSS"},
"domain_critic": {"verdict": "veto", "reason": "Missing audit log"}
},
{
"iteration": 3,
"all_critics": "approve"
}
],
"final_status": "approved",
"cost": {"tokens": 15420, "overhead_pct": 38.6},
"files_changed": ["src/auth/login.ts", "src/auth/middleware.ts"]
}
存储位置
会话文件
路径：.claude/coherence-audit/{session_id}.json
在每次验证会话后创建，包含完整的决策历史。
Git 提交信息
格式：
feat(auth): refactor to JWT tokens
Verified by Code Coherence (session-abc123)
- 3 iterations required
- Security critic caught XSS vulnerability
- Domain critic ensured audit trail present
Critics: code✓ security✓ domain✓
Files: src/auth/login.ts src/auth/middleware.ts
搜索索引
路径：.claude/coherence-audit/index.json
维护所有会话的可搜索索引，以便快速查询。
搜索查询
按评审
/audit-trail search "security critic rejections"
按文件
/audit-trail search "changes to src/auth/**"
按日期范围
/audit-trail search "sessions from 2026-02-01 to 2026-02-03"
按迭代次数
/audit-trail search "sessions with >4 iterations"
暴露分析
当被引用的事实被修正时，识别下游影响：
/audit-trail exposure analyze "token storage decision"
返回所有依赖该令牌存储方式的会话，以便评估变更的影响。
附加资源
- references/traversal-examples.md——详细查询示例
- references/audit-schema.md——完整的审计日志 JSON schema
适用场景
适用于需要追踪代码变更决策来源、审查评审否决记录、评估变更下游影响，以及维护决策可追溯性的开发与验证流程。
限制
关于该技能的具体安装方式、收费情况、支持平台及运行环境要求，资料中暂未提供。