菜单
归档管理——Task 归档与 Recording 物理归档的双轨机制、触发条件、手动步骤、验证清单。触发场景：(1) 终态任务数超阈值，(2) session 文件数超阈值，(3) 用户说"归档"、"archive"、"清理"
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | darc |
| description | 归档管理——Task 归档与 Recording 物理归档的双轨机制、触发条件、手动步骤、验证清单。触发场景：(1) 终态任务数超阈值，(2) session 文件数超阈值，(3) 用户说"归档"、"archive"、"清理" |
| context | fork |
| agent | general-purpose |
| model | haiku |
| allowed-tools | ["Read","Write","Edit","Bash","Grep","Glob"] |
| effort | low |
| paths | [".diwu/**"] |
| hooks | {"Stop":[{"hooks":[{"type":"command","command":"python3 ${CLAUDE_SKILL_DIR}/../hooks/scripts/stop_archive.py 2>/dev/null || true"}]}]} |
双轨机制：Task 轨道（Done/Cancelled → archive）+ Recording 轨道（旧 session → archive）。纯检测不自动执行。
| 轨道 | 触发条件 | 阈值（dsettings.json） | 产物位置 |
|---|---|---|---|
| Task 归档 | Done/Cancelled 数 ≥ threshold | task_archive_threshold（默认 20） | .diwu/archive/task_archive_YYYY-MM.json |
| Recording 归档 | 文件数 ≥ threshold 或 文件年龄 > days | recording_archive_threshold（默认 50）recording_retention_days（默认 30） | .diwu/archive/recording_YYYY-MM-DD.md |
.diwu/dtask 中 status 为 Done 或 Cancelled 的任务数量 ≥ task_archive_thresholdstop_archive.py → check_task_archive()[ARCHIVE_CHECK] 提示 + /darc 指引.diwu/recording/ 下 session 文件数 ≥ recording_archive_thresholdrecording_retention_days 天stop_archive.py → check_recording_archive()[ARCHIVE_CHECK] 提示 + /darc 指引1. 判断：运行 /darc 或查看 Stop hook 输出的 [ARCHIVE_CHECK] 消息
2. Task 归档：
a. 读取 .diwu/dtask，筛选 status=Done/Cancelled 的任务
b. 写入 .diwu/archive/task_archive_YYYY-MM.json（当月归档文件）
c. 从 dtask 中移除已归档任务（保留活跃任务）
3. Recording 归档：
a. 列出 .diwu/recording/ 所有 session 文件
b. 按时间排序，将最旧的 N-threshold 个文件内容追加到 .diwu/archive/recording_YYYY-MM-DD.md
c. 删除已归档的源文件（保留最新 threshold 个）
4. 踩坑聚合（必做）：
a. 扫描本次归档的 recording + 剩余 recording 中所有 `### 本次踩坑/经验` 段落
b. 归档文件内按 `## Source: session-xxx.md` 分隔符追踪每条踩坑所属的具体 session
c. 按 Layer 2 类别标签聚类（验证误读/分层未拆清/环境漂移/路由护栏契约等）
d. 追加写入 .diwu/project-pitfalls.md（不覆盖已有条目，追加新条目）
e. **来源列必须写具体 session 文件名**（如 `session-2026-04-18-213522.md`），禁止写占位符如"聚合来源"
f. 如无踩坑数据则跳过，在 summary 中标注 "0 new pitfalls"
5. 验证清单：
[ ] dtask 中无残留的 Done/Cancelled 任务（超出保留阈值的部分）
[ ] recording/ 文件数 < threshold
[ ] archive/ 目录下产物可读且 JSON/MD 合法
[ ] .last_archive_summary.json 已更新（含归档时间、数量、文件列表）
[ ] project-pitfalls.md 已更新（如有踩坑数据）或确认无新踩坑
{
"archived_at": "2026-04-19T10:30:00Z",
"source": ".diwu/dtask",
"tasks": [
{ "id": 1, "title": "...", "status": "Done", "completed_at": "..." },
{ "id": 2, "title": "...", "status": "Cancelled", "reason": "..." }
],
"count": 2
}
# Recording Archive: 2026-04-19
Archived from: .diwu/recording/
Session count: 5
Date range: 2026-03-01 ~ 2026-03-31
---
## Session 2026-03-01 09:00:00
（原 session 内容）
## Session 2026-03-05 14:22:33
（原 session 内容）
{
"last_archive_time": "2026-04-19T10:30:00Z",
"task_archived_count": 15,
"recording_archived_count": 5,
"archive_files": ["task_archive_2026-04.json", "recording_2026-04-19.md"]
}
stop_archive.py 是纯检测脚本，不执行物理归档：
| 函数 | 功能 | 返回值 |
|---|---|---|
check_task_archive(settings, tasks) | Done/Cancelled 数 vs 阈值 | (needs_archive, count, threshold, message) |
check_recording_archive(settings) | 文件数/年龄 vs 双条件 OR | (needs_archive, total, to_archive, thresh_days, message) |
check(settings, tasks) | 主入口，聚合两个检查 | [(level, message)] 结果列表 |
集成位置：stop_blocking.py 在 stop_archive_agg 调用后追加 stop_archive.check() 调用（try/except 包裹 import）。
输出格式：
[ARCHIVE_CHECK] Task 归档预警: 25 个终态任务 (阈值 20)。执行 /darc 开始归档。
[ARCHIVE_CHECK] Recording 归档预警: 62 个 session 文件 (阈值 50)。执行 /darc 开始归档。
stop_archive_agg.py 只做完整性检查；踩坑聚合由 /darc 手动步骤第 4 步执行）纠偏与误判排查方法论——退化信号检测、四行重写模板、止损序列、六类泛化误判排查表、与 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"、"需求文档"、"竞品分析"、"产品规划"、"需求优先级"、"迭代规划"、"方案对比"
Session 记录写入方法论——文件格式模板、踩坑经验四段式记录、时间戳获取规则、最低合法答案、归档聚合指引、Stop hook 检测正则。触发场景：(1) 写 session 记录，(2) 记录踩坑经验，(3) Session 结束前整理，(4) 用户说"记录"、"recording"、"踩坑"。铁律：必须 date 命令获取时间戳。