Audit Start

/start — 审计会话启动 + Context 恢复

触发方式

/start "任务描述"

为什么需要 /start

每次工作都应该在审计会话中进行。没有会话意味着：

• hooks 产出的审计数据归入自动创建的 auto_ session，缺少任务描述
• /end 无法做完整性检查
• 日报中的任务总览缺少描述

/start 的成本极低（创建一个目录 + 一个 JSON 文件），收益是让所有后续操作都有上下文。

执行步骤

1. 创建审计会话

# 1. 生成 session_id
SESSION_ID="adhoc_$(date +%Y%m%d_%H%M)"

# 2. 创建目录
mkdir -p .claude/runs/${SESSION_ID}

# 3. 写入 session.json
cat > .claude/runs/${SESSION_ID}/session.json  .claude/runs/.current_session

> ⚠️ 第 4 步是关键：.current_session 文件是 /start 和 Stop hook 之间的握手协议。 > Stop hook 读取此文件来确定 audit_buffer 归档到哪个 session 目录。 > 如果不写这个文件，Stop hook 会创建一个 auto_ session，与 /start 的 session 脱节。

2. Context 恢复（如果 .claude/runs/ 目录存在历史数据）

按以下优先级加载：

Level 0 — 索引摘要:

• 读取 .claude/runs/index.json，获取最近 5 条 entry 的 id + task + status

Level 2 — 用户修正（最重要）:

• 在最近的 audit_trail.jsonl 和 audit_blocks.jsonl 中搜索 user_correction
• 这些记录必须最先恢复——丢了会重犯错误

Level 1 — 任务状态:

• 读取最新的 .claude/runs/daily/*_daily.md（如果存在）
• §四 异常告警：有没有未解决的问题？
• §六 昨日待办：有没有未完成的任务？
• §七 明日待办：今天该优先做什么？
• 读取最新的 .claude/runs/daily/*_morning_review.md（如果存在）

检查未完成会话:

• 扫描 .claude/runs/adhoc_*/session.json，找 status: "in_progress" 的会话
• 如果有，提示用户是否继续上次未完成的任务（如果继续，复用旧 session_id 而非创建新的）

3. 输出上下文恢复摘要

审计会话已创建: adhoc_20260320_1400
任务: {用户的任务描述}

上下文恢复摘要（基于 .claude/runs/ 审计记录）：

最近活动：
  - {最近 3 条完成的任务}

⚠️ 用户修正记录（必须遵守）：
  - {所有 user_correction 记录}

待解决问题：
  - {未关闭的异常/告警}

今日推荐优先级：
  - {morning_review 中的推荐}

预期 Record 类型：
  [数据] / [变更] / [对话] — 根据任务描述预判

所有后续 [AUDIT] 块请使用 batch_id = {session_id}

4. 注意事项

• 如果 .claude/runs/ 目录不存在，自动创建，跳过 context 恢复
• 如果没有历史审计数据，正常启动，不报错
• session_id 在整个会话期间保持不变，所有 [AUDIT] 块共享此 id
• 如果已有活跃 session（.current_session 文件存在且对应 session 状态为 in_progress），提示用户是否要结束旧 session 再创建新的

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: RickyTong1
• Source: RickyTong1/audit-harness
• License: MIT

Install and usage instructions live in the source repository linked above.