| name | feature-dev |
| description | 面向复杂功能的代码库探索、架构决策、实现与质量审查工作流。仅在用户明确调用本 Skill，或功能明显涉及多个模块或系统、重要架构调整、兼容性决策、数据迁移或高风险实现时使用；不要用于范围清晰的小型或中型改动。 |
复杂功能开发
在充分理解现有代码的基础上完成复杂功能。遵循仓库根目录及相关子目录中的 AGENTS.md，将其作为编码规范的唯一事实来源。
工作原则
- 先追踪真实调用链、数据流、模块边界和相邻实现，再确定方案。
- 优先复用现有组件、Hooks、服务、类型和基础设施。
- 默认选择满足需求的最小完整改动，避免无关重构和预设式抽象。
- 只有缺失信息会明显改变业务结果、兼容性、数据安全或实现边界时才询问用户；轻微歧义根据现有代码合理判断并继续。
- 只在方案存在实质性差异时比较多个架构，不为形式完整而制造备选方案。
- 未经用户授权，不扩大任务范围或执行破坏性、不可逆操作。
1. 判断复杂度
先判断任务是否确实需要本工作流。
- 若任务范围清晰、局限于少量文件且不涉及重要架构决策，直接按常规开发流程完成，不强制执行后续阶段。
- 若涉及多个模块或系统、公共接口、数据迁移、复杂状态流或高风险兼容性，继续执行以下流程。
- 仅当任务包含三个以上相互依赖的阶段且计划能帮助跟踪进度时，使用当前环境提供的计划工具。
2. 探索代码库
- 阅读相关
AGENTS.md、包配置、架构说明和相邻实现。
- 追踪入口、调用链、状态变化、数据契约、错误处理和测试方式。
- 搜索可复用的类似功能与扩展点。
- 当存在多个可独立调查的问题且并行探索能明显提高效率时，按需启动探索代理；不要固定代理数量。要求代理返回结论、证据和关键文件列表，随后亲自阅读决定实现所必需的文件。
- 向用户说明会影响实现选择的关键发现；不要输出冗长的文件阅读流水账。
3. 补齐关键信息
根据代码证据识别真正阻塞实现的问题，例如业务边界、错误语义、权限、兼容性、迁移策略和不可逆操作。
- 能从源码、配置、类型、测试或现有行为中确定的信息，直接查明，不反问用户。
- 存在安全且符合项目惯例的默认方案时，说明必要假设并继续。
- 只有不同答案会造成明显不同的业务结果或风险时，集中提出少量具体问题并等待回答。
4. 确定方案
定义目标结构、职责边界、交互方式和兼容策略。
- 通常直接给出一个推荐方案及理由。
- 只有多个方案存在实质性取舍时，简要比较最小改动、长期可维护性和实施风险。
- 若推荐方案仍处于用户已授权的需求范围内，可直接实现。
- 只有方案会扩大范围、改变公共行为、引入数据风险或需要不可逆操作时，才请求用户确认。
5. 实现与验证
- 按选定方案实施最小且完整的修改。
- 严格遵循现有架构、命名、类型和平台规范。
- 保持公共接口和既有行为稳定，除非需求明确要求改变。
- 运行受影响 workspace 的针对性测试、类型检查、lint 或构建；避免默认执行整个大型仓库的全部检查。
- 分析验证失败，区分本次改动、环境问题和已有问题，不把未执行或失败的检查描述为通过。
6. 质量审查
检查功能正确性、边界情况、重复逻辑、抽象边界、项目规范和回归风险。
- 对高风险或跨模块改动，可按需并行委派彼此独立的审查方向；不要固定启动多个审查代理。
- 直接修复任务范围内明确且安全的问题。
- 无关问题只简短记录，不顺手扩大修改范围。
- 需要新增授权或会改变业务行为的问题，向用户说明后再处理。
7. 交付
简洁说明：
- 修改了什么。
- 关键架构或根因是什么。
- 执行了哪些验证以及结果。
- 仍存在的风险或未验证项。
不要生成用户未要求的计划文档、迁移指南或冗长过程复盘。
