القائمة
Session 记录写入方法论——文件格式模板、踩坑经验四段式记录、时间戳获取规则、最低合法答案、归档聚合指引、Stop hook 检测正则。触发场景：(1) 写 session 记录，(2) 记录踩坑经验，(3) Session 结束前整理，(4) 用户说"记录"、"recording"、"踩坑"。铁律：必须 date 命令获取时间戳。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
归档管理——Task 归档与 Recording 物理归档的双轨机制、触发条件、手动步骤、验证清单。触发场景：(1) 终态任务数超阈值，(2) session 文件数超阈值，(3) 用户说"归档"、"archive"、"清理"
纠偏与误判排查方法论——退化信号检测、四行重写模板、止损序列、六类泛化误判排查表、与 BLOCKED 的边界判定。触发场景：(1) 出现退化信号（反复纠偏/目标漂移/证据缺失等），(2) 需要纠偏恢复，(3) 排查误判，(4) 判断是 correction 还是 BLOCKED，(5) 用户说"纠偏"、"偏了"、"不对"、"重写"、"止损"、"误判"
积木式能力验证方法论——判断「直接做 vs 先验证」、将不确定性分层隔离、沉淀可复用能力资产。触发场景：(1) 讨论技术可行性或方案选型，(2) 评估某个实现的不确定性，(3) 决定直接集成 vs 先做 Demo 验证，(4) 分析能力复用或知识沉淀策略，(5) 用户说"积木"、"Demo"、"能力验证"、"不确定性"
产品文档工具——正向（需求→文档）或逆向（代码→文档）两种模式。触发场景：(1) 为已有产品还原/补全文档，(2) 为新功能/模块编写产品文档，(3) 用户说"写文档"、"还原文档"、"doc"、"产品文档"
阶段边界决策锚点——四段式判断（启动/实施/验收/纠偏），含正例/反例/边界例。覆盖：基线失败处理、不确定性决策、入口门控、大幅度判定、执行偏差分级、并行串行选择、超前实施、Done 人工确认、blocked_by 判定、循环依赖、continuous_mode 续跑、recording 写入时机、decisions.md 写入时机。触发场景：(1) 需要做阶段边界决策，(2) 判断幅度大小，(3) 选择并行还是串行，(4) 判断是否需人工确认，(5) 用户说"判断"、"决策"、"幅度"、"并行"、"确认"
产品需求分析方法论——竞品分析、用户画像、需求优先级排序、迭代层次设计、方案对比、非功能性需求分类。触发场景：(1) 讨论产品规划或功能设计，(2) 进行需求分析或竞品调研，(3) 设计迭代路径或优先级排序，(4) 用户说"PRD"、"需求文档"、"竞品分析"、"产品规划"、"需求优先级"、"迭代规划"、"方案对比"
| name | drec |
| description | Session 记录写入方法论——文件格式模板、踩坑经验四段式记录、时间戳获取规则、最低合法答案、归档聚合指引、Stop hook 检测正则。触发场景：(1) 写 session 记录，(2) 记录踩坑经验，(3) Session 结束前整理，(4) 用户说"记录"、"recording"、"踩坑"。铁律：必须 date 命令获取时间戳。 |
| allowed-tools | ["Bash","Read","Write","Edit"] |
| effort | low |
| hooks | {"Stop":[{"hooks":[{"type":"command","command":"python3 ${CLAUDE_SKILL_DIR}/../hooks/scripts/stop_integrity.py 2>/dev/null || true"}]}],"SubagentStop":[{"hooks":[{"type":"command","command":"python3 ${CLAUDE_SKILL_DIR}/../hooks/scripts/subagent_stop.py 2>/dev/null || true"}]}]} |
Session 记录写入规范：每次 session 结束前的必做事项。
写入 Session 标题前必须先运行命令获取真实时间戳：
date '+%Y-%m-%d %H:%M:%S'
2026-04-18 16:49:42 → 写 ## Session 2026-04-18 16:49:42## Session 2026-02-26 （续）## Session YYYY-MM-DD HH:MM:SS
### Task#N: [标题] → [状态]
**实施内容**: - [工作项]
**验收验证**: - [x] [acceptance] ([方法])
**提交**: commit [hash]
### 下一步: [计划]
### 本次踩坑/经验
- [类别] 现象 → 根因 → 误判 → 正确做法
### 错误追踪表（可选）
| 时间戳 | 工具 | 错误摘要 | 尝试 | 解决方式 | 类别 |
禁止 YAML front matter：Session 文件禁止以 --- 开头。--- 在 Markdown 中是 front matter 语法，渲染器会将包裹内容当作元数据隐藏。
## Session 2026-04-14 18:44:09--- 再跟 ## Session ...约束级别：必填，不可省略。每个 session 必须显式写入此字段。
### 本次踩坑/经验
- [类别] 现象描述 → 根因分析 → 错误判断 → 正确做法
类别标签（六类泛化模式对齐）：
环境漂移 / 数据缺口 / 读层现象 / 路由护栏契约 / 验证误读 / 分层未拆清 / 其他
### 本次踩坑/经验
- [环境漂移] 本地测试通过但 CI 超时 → CI 环境缺少代理配置导致网络超时 → 误判为代码性能问题 → 应先检查 CI 环境变量和网络配置再定位代码
- [验证误读] 单元测试全部 PASS 但功能不工作 → 测试 mock 了关键依赖导致假阳性 → 误判为已完成 → 应补充集成测试或端到端验证
### 本次踩坑/经验
本轮无显著误判，实施路径符合预期。
注意：最低合法答案仅用于确实无踩坑的 session。任何判断偏差、意外阻塞、返工或环境问题都必须按四段式记录。
Stop hook 用以下正则检测必填字段是否存在：
# 匹配本次踩坑/经验字段是否存在
PITFALL_PATTERN = re.compile(
r'^###\s*本次踩坑[\/]?经验\s*\n'
r'(.*\n)*'
r'.+', # 至少有一行内容
re.MULTILINE
)
# 最低合法答案专用匹配
PITFALL_MINIMAL_PATTERN = re.compile(
r'###\s*本次踩坑[\/]?.*经验.*无显著误判.*符合预期',
re.DOTALL
)
匹配语义：
归档时（recording/ 文件数超阈值），扫描所有即将归档的 session 文件中的 ### 本次踩坑/经验 段落，按类别聚类后追加到 project-pitfalls.md。每条必须标注具体 session 文件名作为来源（如 session-2026-04-18-213522.md），禁止写归档文件名或占位符；归档文件内按 ## Source: 分隔符追踪所属 session。
当同一工具连续失败时，Hook 自动追踪并注入分级提示：
| 尝试 | 策略 | 注入内容 |
|---|---|---|
| 1/3 | 诊断并修复根因 | 温和提醒：诊断根因，如有踩坑考虑记录 |
| 2/3 | 更换根本不同的方法 | 强烈建议：换工具/换文件/换策略 |
| 3+/3 | 广泛重新思考或升级用户 | 阻止继续：质疑假设，考虑升级 |
状态持久化：/tmp/diwu_ctx_<pid>_errtrack JSON 文件，冷却窗口默认 60 秒。
复杂 session（多次工具失败、多轮纠偏）中，建议在踩坑记录后追加表格：
### 错误追踪表（可选）
| 时间戳 | 工具 | 错误摘要 | 尝试 | 解决方式 | 类别 |
|--------|------|---------|------|---------|------|
| 01:30:05 | Bash | npm install E403 | 2 | 使用镜像源 | 环境漂移 |
大任务实施过程中记录中间进度：
### Checkpoint @ 步骤3/8
进度: 完成 auth 模块重构，payment 模块进行中
已修改: src/auth.ts(+120/-80), src/models/user.ts(+15/-5)
下一步: 步骤4 payment 模块重构 → 步骤5 集成测试
回滚方式: git checkout -- src/auth.ts src/models/user.ts
或 git reset --soft HEAD~1（如已提交）
CONTINUOUS MODE COMPLETE - 所有可执行任务已完成
已完成: Task#A, Task#B | 剩余: Task#X(InDraft), Task#Y(BLOCKED)
本轮连续完成 N 个任务