diwu-workflow

记录架构决策（ADR），输出到 .doc/adr/ 目录

纠偏恢复命令——当 AI 偏离主线时，按五步协议重新回到目标/主线/现象/验证四个锚点

将不确定性隔离为可复用的能力验证单元，输出 Demo 规格与目录结构

产品文档工具，支持正向（需求→文档）和逆向（代码→文档）两种模式

初始化项目的 Claude Code Agent 工作流结构——编排器模式。创建 CLAUDE.md、rules、agents、skills symlink、dtask.json、recording/、checks/ 等完整工作流骨架。触发场景：(1) 新项目初始化工作流结构，(2) 已有项目刷新/升级 diwu-workflow 配置，(3) 用户说"初始化"、"init"、"初始化工作流"、"dinit"。编排器模式：交互式步骤（信息收集/迁移检测/架构约束/git 初始化/验证清单）在主代理上下文执行，I/O 密集型步骤（代码库扫描/资产同步/文件创建）分发给子代理并行处理。

当需要编写 API 测试、设计测试策略或验证接口契约时触发。典型场景：设计测试金字塔策略（契约测试/集成测试/E2E 分层覆盖）、验证 OpenAPI/Swagger 规范与实际实现的一致性、编写边界用例与异常输入覆盖（空值/超长/特殊字符注入）、根据技术栈选择测试框架（Python pytest/JS Jest/Go testing）。Use proactively when writing API tests, designing test strategy, or validating interface contracts.

当需要设计新 API、选型数据库或排查服务端性能问题时触发。典型场景：评审 RESTful/GraphQL schema 设计（请求格式/版本控制/错误处理）、审查数据库 schema 与索引策略（规范化 vs 反范式化）、评估服务端分层架构选型（MVC/CQRS/微服务）、设计缓存策略（本地缓存/Redis/CDN 层级）。Use proactively when designing APIs, choosing database tech, or diagnosing backend performance.

当需要搭建 CI/CD 流水线、容器化应用或设计部署流程时触发。典型场景：设计 GitHub Actions/GitLab CI 流水线（构建/测试/部署阶段编排）、编写 Docker Compose/K8s 容器化配置、选择部署策略（蓝绿部署/金丝雀发布/滚动更新）、配置 Prometheus/Grafana 监控告警规则。Use proactively when setting up CI/CD, containerizing apps, or designing deployment pipelines.

代码库调查、架构分析、文件搜索、技术调研专家。当需要深入理解代码库结构、追踪依赖关系、分析模块边界时使用此代理。

当需要做前端技术选型、重构前端架构或优化加载性能时触发。典型场景：对比并选择状态管理方案（Redux/Zustand/Pinia/Jotai 适用边界）、评审组件架构（原子设计/复合组件拆分粒度）、制定构建优化策略（code splitting/tree shaking/lazy loading）、分析包体积并规划按需加载路径。Use proactively when doing frontend tech selection, refactoring architecture, or optimizing bundle size.

归档管理——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) 用户说"判断"、"决策"、"幅度"、"并行"、"确认"

18 hooks across 11 events