ben2pc/auriga-workflow

澄清并记录领域模型、模块边界、职责分配、依赖方向、关键接口、数据流和迁移方案。当新功能的技术方案不显然，或用户要求架构优化、领域建模、改善领域模型、重新划分职责或边界、调整分层与依赖、规划架构演进时使用。

简化函数、类、文件内部及局部协作代码，降低真实维护成本。当用户明确要求重构、简化、清理代码、处理代码质量评审意见，或对指定目录或模块做坏味道普查时使用。

当用户要求审查拉取请求、执行 /deep-review、将拉取请求标记为待审（Ready for Review），或请求正式 / 全面代码审查时触发。

代码讲解员——仅当用户显式选择 docent 时使用。接收一个关于现有代码、模块或组件的自然语言问题或仓库路径，由单个专职子代理定位并通读实际代码，生成一份自包含、可离线打开的交互式 HTML 讲解报告，帮助人类建立对当前架构、关键关系和代码证据的正确心智模型。

管理工程中的文档资产与长期上下文。当用户要求新建、更新、整理、合并、压缩、归档或删除 README、运行手册、公共接口文档、架构文档、ADR、变更日志、代码注释、AGENTS.md 或项目规则，代码变化造成文档事实漂移，长期文档出现过程流水账，arch-design 的已确认决定需要长期沉淀，或需要为工程师与 Agent 分别维护可发现、低冗余的项目上下文时使用。

管理 Git 分支、工作树、提交、拉取请求和历史整理的完整生命周期。当需要确认仓库状态、创建或切换分支与工作树、组织提交、创建或更新拉取请求、进入 Ready、处理评审与持续集成反馈、合并，或执行 rebase、squash、amend、force-push 等历史改写时使用。

当用户要求设置自主目标、自动跑完、跑到 PR Ready、跑到深度评审收敛、跑到合并、启动 /goal，或明确选择 goalify 将已澄清的需求或当前工作进展交给长程自主运行时使用。

将已确认的非平凡需求改动拆成完整、可验证、可集成的实施单元，并按依赖顺序增量落地。当任务涉及多文件、跨文件重构、跨切面修改、多个可分离结果或执行已确认计划时使用；纯文档、纯配置或单一明确的小修改不触发。

当用户要求创建自定义审查者、添加项目专属审查者、扩展 deep-review，或调用 /reviewer-creator 时使用；在 docs/rules/review/ 下生成结构规范的审查者文件。

当用户要求复盘、总结、沉淀当前会话，分析最近一段时间的 Claude Code 或 Codex 使用方式，wrap up this session、extract takeaways、recent usage insights，或从会话中提取可复用经验时使用；先让用户选择单会话复盘或最近 30 天洞察，再生成对应的离线 HTML 报告。

基于实际代码与产品事实澄清新增或改变外部可见行为的需求。当用户提出新功能、公共 API、CLI、schema、用户流程变化，要求写 spec、梳理需求、挑战想法或定义验收契约，或者带来一句话需求、PRD、原型、Figma 链接或已有规格时使用。

当用户要求诊断或修复错误、测试失败、异常行为或性能退化时使用；永久修复前先建立可重复的问题验证路径，无法立即复现时建立线上证据采集路径。

在实现新增或改变可观察行为的功能或配置、已确认根因的缺陷修复或重构时使用；也用于判断本次验证证据是否需要沉淀为永久测试。先按风险选择当前证据，只有稳定契约、真实回归风险、可靠自动化接缝和正向维护收益同时成立时才新增永久测试。