메뉴
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 个任务