Files
Neo-ZQYY/docs/audit
Neo ec8f7d4e03 chore(audit): 清理 changes/changes/ 嵌套误产物目录 — audit-gap-recovery 收尾
按 docs/specs/audit-gap-recovery/tasks.md 阶段 2/4 完成:

阶段 2(B 类内容漂移,1 份)
决策:保留主目录版 2026-04-06__v1-cleanup-ddl-consolidation.md。
两版仅差 1 行路径(第 128 行):
  - 主目录版:cd c:/NeoZQYY && python tools/db/gen_consolidated_ddl.py
  - 嵌套版:   cd c:/Project/NeoZQYY && ...
主目录版是 2026-04-06 审计当天原始写法(与 v1 整理 commit 779b2f6 同期),
忠于历史真相;嵌套版是开发机迁移后批量路径替换过的版本,舍弃。
差异过小,不单独备份。

阶段 4(删除嵌套目录)
- rm -rf docs/audit/changes/changes/(本地删除,目录本就被 .gitignore 屏蔽,
  无 git 历史需清理)
- .gitignore 移除 docs/audit/changes/changes/ 临时屏蔽规则(嵌套目录已不复存在)
- 刷新 docs/audit/audit_dashboard.md,当前 128 条记录
  (主目录 129 份 md 中有 1 份 2026-03-24_fix_cfg_skill_type_missing_records.md
   因单下划线命名异常被 dashboard 脚本忽略,后续可重命名)

验证
- ls docs/audit/changes/*.md | wc -l = 129(原 33 + D 补追 96 = 129 ✓)
- ls docs/audit/changes/changes/ 返回 "No such file"(✓)
- git log --oneline -- "docs/audit/changes/" 有本次补追 + 清理 commit(✓)

audit-gap-recovery PRD 至此全部 4 阶段执行完毕。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 06:38:11 +08:00
..

审计目录docs/audit/

项目级统一审计落地点。所有模块ETL、后端、小程序、管理后台等的审计产物均写入此目录。

子目录与文件

目录/文件 说明
changes/ AI 逐次变更审计记录(<YYYY-MM-DD>__<slug>.md
prompt_logs/ Prompt 日志文件(每次 prompt 生成一个独立文件,按时间戳命名)
session_logs/ 全量会话记录(按 YYYY-MM/DD/ 分层),含双索引和 LLM 操作摘要。详见 SESSION-LOG-GUIDE.md
audit_dashboard.md 审计一览表(自动生成,勿手动编辑)
SESSION-LOG-GUIDE.md Session 日志使用指南(索引字段、查询方法、典型场景)

维护约定

  • prompt_logs/prompt-audit-log Hook 自动管理,请勿手动编辑
  • session_logs/agentStop Hook 自动提取,索引由提取脚本自动更新
  • audit_dashboard.md/audit 流程自动刷新,也可通过 python scripts/audit/gen_audit_dashboard.py 手动重新生成
  • 变更审计记录由 /audit 流程audit-writer 子代理)生成,包含 session_id 字段与 Session 日志双向关联
  • 历史记录(迁移前 ETL 子项目的审计)已合并至此目录

审计追溯链

Prompt 日志 ←→ Session 日志 ←→ 变更审计记录
(用户说了什么)   (AI 做了什么)   (正式变更文档)

通过 Prompt-ID 和 Session-ID 可在三者之间双向追溯。详见 SESSION-LOG-GUIDE.md