Feature DevCAUTION

Skyroc 是一个基于 React 19 + TypeScript 的跨端前端工程化 monorepo:既提供开箱即用的 Web 中后台模板(Admin / RuoYi 对接版)和 Expo 移动端业务模板,也把请求、状态、日志、主题、双端 UI 组件库等能力沉淀为边界清晰的 workspace 包。

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: feature-dev
description: 面向复杂功能的代码库探索、架构决策、实现与质量审查工作流。仅在用户明确调用本 Skill,或功能明显涉及多个模块或系统、重要架构调整、兼容性决策、数据迁移或高风险实现时使用;不要用于范围清晰的小型或中型改动。
---

# 复杂功能开发

在充分理解现有代码的基础上完成复杂功能。遵循仓库根目录及相关子目录中的 `AGENTS.md`,将其作为编码规范的唯一事实来源。

## 工作原则

- 先追踪真实调用链、数据流、模块边界和相邻实现,再确定方案。
- 优先复用现有组件、Hooks、服务、类型和基础设施。
- 默认选择满足需求的最小完整改动,避免无关重构和预设式抽象。
- 只有缺失信息会明显改变业务结果、兼容性、数据安全或实现边界时才询问用户;轻微歧义根据现有代码合理判断并继续。
- 只在方案存在实质性差异时比较多个架构,不为形式完整而制造备选方案。
- 未经用户授权,不扩大任务范围或执行破坏性、不可逆操作。

## 1. 判断复杂度

先判断任务是否确实需要本工作流。

- 若任务范围清晰、局限于少量文件且不涉及重要架构决策,直接按常规开发流程完成,不强制执行后续阶段。
- 若涉及多个模块或系统、公共接口、数据迁移、复杂状态流或高风险兼容性,继续执行以下流程。
- 仅当任务包含三个以上相互依赖的阶段且计划能帮助跟踪进度时,使用当前环境提供的计划工具。

## 2. 探索代码库

1. 阅读相关 `AGENTS.md`、包配置、架构说明和相邻实现。
2. 追踪入口、调用链、状态变化、数据契约、错误处理和测试方式。
3. 搜索可复用的类似功能与扩展点。
4. 当存在多个可独立调查的问题且并行探索能明显提高效率时,按需启动探索代理;不要固定代理数量。要求代理返回结论、证据和关键文件列表,随后亲自阅读决定实现所必需的文件。
5. 向用户说明会影响实现选择的关键发现;不要输出冗长的文件阅读流水账。

## 3. 补齐关键信息

根据代码证据识别真正阻塞实现的问题,例如业务边界、错误语义、权限、兼容性、迁移策略和不可逆操作。

- 能从源码、配置、类型、测试或现有行为中确定的信息,直接查明,不反问用户。
- 存在安全且符合项目惯例的默认方案时,说明必要假设并继续。
- 只有不同答案会造成明显不同的业务结果或风险时,集中提出少量具体问题并等待回答。

## 4. 确定方案

定义目标结构、职责边界、交互方式和兼容策略。

- 通常直接给出一个推荐方案及理由。
- 只有多个方案存在实质性取舍时,简要比较最小改动、长期可维护性和实施风险。
- 若推荐方案仍处于用户已授权的需求范围内,可直接实现。
- 只有方案会扩大范围、改变公共行为、引入数据风险或需要不可逆操作时,才请求用户确认。

## 5. 实现与验证

1. 按选定方案实施最小且完整的修改。
2. 严格遵循现有架构、命名、类型和平台规范。
3. 保持公共接口和既有行为稳定,除非需求明确要求改变。
4. 运行受影响 workspace 的针对性测试、类型检查、lint 或构建;避免默认执行整个大型仓库的全部检查。
5. 分析验证失败,区分本次改动、环境问题和已有问题,不把未执行或失败的检查描述为通过。

## 6. 质量审查

检查功能正确性、边界情况、重复逻辑、抽象边界、项目规范和回归风险。

- 对高风险或跨模块改动,可按需并行委派彼此独立的审查方向;不要固定启动多个审查代理。
- 直接修复任务范围内明确且安全的问题。
- 无关问题只简短记录,不顺手扩大修改范围。
- 需要新增授权或会改变业务行为的问题,向用户说明后再处理。

## 7. 交付

简洁说明:

1. 修改了什么。
2. 关键架构或根因是什么。
3. 执行了哪些验证以及结果。
4. 仍存在的风险或未验证项。

不要生成用户未要求的计划文档、迁移指南或冗长过程复盘。

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (5)

.claude/skills/design-taste-frontend

.claude/skills/migrate-nativewind-to-uniwind

.claude/skills/migrate-oxfmt

.claude/skills/migrate-oxlint

.claude/skills/ui-ux-pro-max/data

Gates applied: no_behavioural_pass.