zflow

指导稳定的 RPC、存储协议和接口设计。在设计节点间 RPC、存储协议语义、模块边界或任何公共接口时使用。在定义 gRPC service、对象存储或文件系统语义、节点间的类型契约，或确立组件边界时使用。

自动化 CI/CD 流水线设置。在设置或修改构建和部署流水线时使用。当需要自动化质量门禁、在 CI 中配置测试运行器，或建立部署策略时使用。当需要处理 CI 上不稳定（flaky）的测试时使用。

进行多维度代码审查。在合并任何变更之前使用。在审查由你自己、另一个智能体或人类编写的代码时使用。当需要在代码进入主分支之前评估其跨多个维度的质量时使用。当需要评估变更的正确性、可读性、架构与性能，或审查 PR/diff 时使用。

为清晰性而简化代码。在重构代码以提高可读性而不改变行为时使用。当代码可以正常工作但比应有的更难阅读、维护或扩展时使用。在审查已积累不必要复杂性的代码时使用。当组件过度设计、过于炫技而难以维护时使用。当需要清理越来越难读懂的代码时使用。

验证系统的一致性与持久性承诺。在设计或修改复制协议、写路径、崩溃恢复逻辑时使用。当需要证明已确认的写入不丢失、副本间不发散、崩溃后能恢复到一致状态，或评审 fsync/校验和/事务语义时使用。

优化智能体上下文设置。在开始新会话、智能体输出质量下降、在不同任务之间切换，或需要为项目配置规则文件和上下文时使用。

指导系统化的根因调试。当测试失败、构建中断、行为不符合预期，或遇到任何意外错误时使用。当需要系统化地找到并修复根本原因而非猜测时使用。当服务崩溃（panic）、空指针异常、或之前通过的测试突然挂掉时使用。当生产环境间歇性报错、需要定位根因时使用。当测试或构建昨天还通过、今天就挂了时使用。

管理弃用和迁移。在移除旧系统、API 或功能时使用。在将用户从一个实现迁移到另一个实现时使用。在决定是否维护或淘汰现有代码时使用。

记录决策和文档。在做出架构决策、修改公共 API、发布功能，或需要记录未来工程师和智能体理解代码库所需的上下文时使用。

在每个非平凡决策生效之前，对其进行全新上下文的对抗性审查。当正确性比速度更重要时、在不熟悉的代码中工作时、当风险很高时（生产环境、安全敏感逻辑、不可逆操作），或任何自信的输出现在验证比以后调试更便宜的时候使用。在高风险迁移或上线前，压力测试（压测）计划中隐藏的故障模式时使用。

通过受控故障注入验证系统的容错能力。在验证节点宕机、网络分区、磁盘慢盘/坏盘、时钟漂移等故障路径时使用。当系统声称具备容错/高可用能力但缺乏故障路径证据时、上线前需要验证恢复流程时，或需要建立常态化混沌工程实践时使用。

结构化 Git 工作流实践。在进行任何代码变更时使用。在提交、创建分支、解决冲突，或需要跨多个并行流组织工作时使用。在进行版本发布、选择语义化版本号升级、打 Tag 或编写 Changelog 时使用。

通过结构化的发散和收敛思维，将原始想法精炼为清晰、可操作的概念。当想法仍然模糊时、在承诺制定计划之前需要压力测试假设时，或想要在收敛之前扩展选项时使用。触发词："ideate"、"refine this idea"或"stress-test my plan"。触发词也包括"压测一下我的方案"、"头脑风暴"。

增量交付变更。在实现任何涉及多个文件的变更或功能时使用。当你即将一次性编写大量代码，或感觉一个任务太大无法一步到位时使用。

提取用户真正想要的，而非他们认为自己应该想要的。通过一次一个问题的访谈实现，直到对底层意图达到约 95% 的置信度。当需求不具体时使用（"给我建个 X"但没有说明"为谁"或"为什么是现在"），当用户显式调用时使用（"interview me"、"grill me"、"are we sure?"、"stress-test my thinking"），或当你发现自己在任何计划、规格或代码存在之前就开始静默地填补模糊需求时使用。

对基础设施组件（分布式存储、网络服务、数据面组件）进行仪表化，使集群的生产行为可见且可诊断。在添加日志、指标、追踪或告警时使用。在发布任何运行在集群上的功能且你需要证据证明它有效时使用。当出现节点/磁盘/链路异常但从现有数据中无法定位是哪台机器、哪块盘、哪条链路时使用。

优化分布式系统、存储引擎和网络服务的性能。当存在延迟或吞吐需求、怀疑性能回归、p99/p999 尾延迟或 IOPS 需要改进、读写放大需要收敛，或分析揭示了瓶颈时使用。当服务越来越慢需要 profile 并提速、需要用 fio 等压测工具调优队列深度、或排查 RPC 延迟尖峰、重试风暴、网络重传时使用。

将工作分解为有序任务。当你有一个规格或明确需求，需要将工作分解为可实现的 task 时使用。当一个 task 感觉太大无法开始时、需要估算范围时，或并行工作可行时使用。

准备基础架构生产上线。当准备升级分布式系统、存储引擎或网络组件时使用。当需要上线前检查清单、滚动升级与灰度计划、数据迁移与一致性校验，或需要回滚与降级预案时使用。

将每个实现决策扎根于官方文档。当需要权威、有来源引用的代码且不包含过时模式时使用。当使用任何正确性很重要的框架或库构建时使用。

在编码之前创建规格。当开始一个新项目、功能或重大变更且尚无规格时使用。当需求不清晰、模棱两可，或仅作为模糊想法存在时使用。当需要起草 PRD（产品需求文档）时使用。

创建和管理 Stage 文档——串联一轮工作中的所有技能产出物（MISSION、应然文档、实现计划、实然文档、ADR、验证结果），记录应然与实然的差异及其原因，并在封版时提炼学习摘要。当用户显式请求"创建 Stage""开始一个 Stage""封版 Stage"时使用。Stage 创建完全由用户决定，无自动触发条件。

以测试驱动开发。在实现任何逻辑、修复任何缺陷或更改任何行为时使用。当需要证明代码可行、缺陷报告到来，或即将修改现有功能时使用。在按红-绿-重构（red-green-refactor）循环实现功能时使用。当需要在修复 bug 前先写一个失败测试、或在动手实现前先想清楚需要哪些测试时使用。

发现并调用智能体技能。在开始会话或需要发现哪个技能适用于当前任务时使用。这是一个元技能，管理所有其他技能如何被发现和调用。