Claude Skills by val1813

- 资源命名用复数名词（/users, /orders），避免动词 - HTTP方法语义：GET查询、POST创建、PUT全量更新、PATCH部分更新、DELETE删除 - 状态码：200成功、201已创建、204无内容、400参数错误、401未认证、403无权限、404不存在、409冲突、422验证失败、500服务端错误 - 分页：支持 ?page=1&size=20，响应包含 total/pages/current 元数据 - 错误响应统一格式：{"code": int, "message": str, "details": [...]} - 认证：Bearer Token 放 Authorization header，不放 URL 参数 - 版本控制：URL前缀 /api/v1/ 或 Accept header - 自动检测框架（Flask/FastAPI/Express/Spring）并适配对应路由注册方式 - FastAPI 优先用 Pydantic model 做请求/响应校验 - Express 用 router.route() 链式注册同路径不同方法

- 从traceback最后一行开始，找到出错的文件和行号 - 检查相关的import和依赖 - 关注异常类型对应的常见原因（KeyError→字典key拼写/缺失，TypeError→参数类型不匹配，AttributeError→对象为None）

- 国产LLM统一用 OpenAI 兼容接口格式（/v1/chat/completions） - DeepSeek base_url: https://api.deepseek.com，Qwen: https://dashscope.aliyuncs.com/compatible-mode/v1 - 流式响应：stream=True + SSE解析，逐chunk拼接content字段 - token计费：输入/输出分别计价，用tiktoken或API返回的usage字段统计 - 限流处理：捕获429状态码，指数退避重试（1s/2s/4s），最多3次 - 超时设置：连接超时10s，读取超时60s（长文本生成可加到120s） - prompt工程：system message定角色，few-shot放user/assistant交替 - 温度参数：代码生成用0.0-0.3，创意文本用0.7-1.0 - 错误处理：区分可重试错误（429/500/503）和不可重试错误（400/401） - 长文本：超过模型max_tokens时自动截断或分段处理

- 默认用Google风格docstring，项目已有NumPy风格则跟随 - 一行摘要用祈使句（"计算xxx"而非"这个函数计算xxx"） - Args段：每个参数一行，格式 `name (type): 描述` - Returns段：写明类型和含义，多返回值用tuple说明各元素 - Raises段：只列主动raise的异常，不列底层传播的 - 示例（Examples）：给出可直接运行的doctest片段 - 类docstring写在class行下方，描述职责而非实现 - 中文项目用中文写docstring，英文项目用英文，混合项目跟随已有风格 - 私有方法（_前缀）可省略docstring，公开API必须有 - 装饰器不影响docstring位置，始终写在def下一行

你是FastAPI专家。

- 遵循 Go 官方风格指南（Effective Go） - 错误处理：`if err != nil { return err }` 模式，不要忽略错误 - 命名：驼峰命名，导出用大写开头，包名小写单词 - 接口命名：单方法接口用 `-er` 后缀（Reader, Writer, Closer） - 避免 `init()` 函数，除非绝对必要

- 遵循 Google Java Style Guide - 类名 PascalCase，方法/变量 camelCase，常量 UPPER_SNAKE_CASE - 包名全小写，反向域名（com.example.project） - 每个公共类一个文件，文件名与类名一致

- Mapper接口方法名与XML中id一一对应，namespace为接口全限定名 - 动态SQL标签：<if test=""> 条件拼接、<choose>/<when>/<otherwise> 多分支、<foreach> 集合遍历 - ResultMap：一对一用<association>，一对多用<collection>，嵌套查询用select属性 - 参数传递：单参数直接用#{param}，多参数用@Param注解或封装DTO - #{} 预编译防注入，${} 字符串替换仅用于动态表名/列名 - 分页：配合PageHelper插件，Mapper方法前调用PageHelper.startPage() - 批量操作：insert用<foreach>拼接VALUES，update用<foreach>+CASE WHEN - 缓存：一级缓存SqlSession级别默认开启，二级缓存需在XML加<cache/> - 通用字段（create_time/update_time）用拦截器自动填充 - XML文件放在 resources/mapper/ 目录，与接口包路径对应

- 使用python-docx库生成，Document()创建空文档 - 中文正文字体：宋体/仿宋，标题：微软雅黑/黑体，英文：Times New Roman - 正文字号：小四（12pt），标题逐级递增（二号→小三→四号） - 首行缩进：paragraph_format.first_line_indent = Cm(0.74)（两个中文字符） - 行距：1.5倍行距，paragraph_format.line_spacing = 1.5 - 页边距：上下2.54cm，左右3.17cm（Word默认值） - 表格：Table(rows, cols)，首行深色背景+白色加粗文字，内容行交替底色 - 页眉页脚：section.header.paragraphs[0] 设置文字，页码用WD_ALIGN_PARAGRAPH.CENTER - 标题层级：add_heading(text, level=1/2/3)，自动生成目录结构 - 图片插入：add_picture(path, width=Cm(14)) 居中显示 - 保存前不要忘记 document.save(filename)

- 使用python-pptx库，Presentation()创建，slide_layouts选择版式 - 三明治结构：封面页（标题+副标题+日期）→ 内容页 → 总结页 - 不用默认白底，设置深蓝/深灰背景或渐变填充提升质感 - 商务配色：主色深蓝#003366，辅色#0066CC，强调色#FF6600，文字白色或浅灰 - 每页内容不超过5个要点，每个要点一行不超过15字 - 字号：标题28-36pt，正文18-24pt，注释14pt - 图表嵌入：用chart_data构建，优先柱状图/饼图/折线图 - 布局：标题在顶部1/5区域，内容占中间3/5，底部留白或放页码 - 动画/切换：代码生成时不加动画（python-pptx不支持），提示用户手动添加 - 母版：如有企业模板.pptx，用Presentation(template_path)加载

- 使用openpyxl库，Workbook()创建，ws = wb.active获取活动sheet - 表头样式：深色背景（#003366）+白色加粗字体+居中对齐 - 斑马纹：奇偶行交替浅灰（#F2F2F2）和白色背景 - 冻结首行：ws.freeze_panes = 'A2'，冻结首行+首列用'B2' - 列宽自适应：遍历列取max(len(str(cell.value)))设置column_dimensions - 数据验证：DataValidation(type="list", formula1='"选项1,选项2"') - 条件格式：ColorScaleRule/CellIsRule高亮异常值 - 公式：直接写Excel公式字符串如'=SUM(B2:B100)'，不用Python计算 - 数字格式：金额'#,##0.00'，百分比'0.00%'，日期'YYYY-MM-DD' - 合并单元格：ws.merge_cells('A1:D1') 用于标题行 - 边框：thin边框包围数据区域，表头用medium底边框

- 每次只做一种重构，不混合多种变更，便于验证行为一致 - 代码坏味道识别：重复代码→提取函数、过长函数→拆分、深层嵌套→提前返回/卫语句 - SOLID原则：单一职责（类只做一件事）、开闭（扩展开放修改关闭）、依赖倒置（依赖抽象不依赖具体） - 提取函数：3行以上重复代码或逻辑独立片段，命名体现意图而非实现 - 简化条件：复杂if/else链改为策略模式或查表法 - 消除魔法数字：提取为命名常量，放在文件顶部或配置中 - 参数过多（>4个）：封装为数据类/字典/配置对象 - 重构前确保有测试覆盖，重构后运行测试验证行为不变 - 不改变公开API签名，除非调用方也在重构范围内 - 大范围重构分步提交：先提取→再替换调用→最后删除旧代码

- 每个值有且仅有一个所有者 - 借用规则：任意数量的 `&T` 或恰好一个 `&mut T` - 生命周期标注：编译器无法推断时才手动标注 - 避免不必要的 `.clone()`，优先使用引用 - 使用 `Cow<'_, str>` 延迟克隆决策

- 分层架构：Controller→Service→Mapper/Repository，每层只依赖下一层 - 注解：@RestController处理请求、@Service业务逻辑、@Mapper数据访问、@Configuration配置类 - 依赖注入：优先构造器注入（不用@Autowired字段注入），便于测试 - 配置文件：application.yml分环境（dev/test/prod），敏感信息用环境变量${DB_PASSWORD} - AOP切面：@Aspect+@Around做日志/权限/耗时统计，切点表达式精确匹配 - 异常处理：@ControllerAdvice+@ExceptionHandler全局捕获，返回统一错误格式 - Starter自动配置：@ConditionalOnClass/OnProperty控制Bean加载条件 - Mapper接口对应XML：接口在java目录，XML在resources/mapper/，namespace全限定名匹配 - 事务：@Transactional加在Service方法上，只读查询加readOnly=true - 启动类

- EXPLAIN分析：关注type列（ALL全表扫描→需优化，ref/range/const为佳）、rows估算、Extra中的Using filesort/temporary - 索引设计：WHERE条件列建索引，联合索引遵循最左前缀原则，区分度高的列放前面 - 覆盖索引：SELECT的列都在索引中，避免回表（Extra显示Using index） - 避免索引失效：不在索引列上用函数/运算、不用前导%LIKE、注意隐式类型转换 - 子查询改JOIN：IN子查询改为INNER JOIN，EXISTS改为LEFT JOIN + IS NOT NULL判断 - 分页优化：深分页用WHERE id > last_id LIMIT n代替OFFSET，或延迟关联 - 批量操作：INSERT用批量VALUES（每批500-1000条），UPDATE用CASE WHEN批量 - COUNT优化：COUNT(*)让引擎选最小索引，不要COUNT(列名)除非需排除NULL - 大表JOIN：确保JOIN字段有索引且类型一致，小表驱动大表 - 锁优化：长事务拆短、避免SELECT...FOR UPD

每个测试严格分为 Arrange（准备数据）→ Act（执行操作）→ Assert（验证结果）三段，用空行分隔。

- Python 3.10+用内置类型（list[str], dict[str, int], str | None），低版本用typing模块 - Optional[X]等价于X | None，表示可能为None，不表示"可选参数" - 函数签名：所有公开函数标注参数类型和返回类型，内部函数可省略 - 泛型：TypeVar定义类型变量，Generic[T]创建泛型类，bound限制上界 - Protocol：结构化子类型（鸭子类型的静态版），定义接口不需要继承 - TypedDict：字典的精确类型，每个key有独立类型，total=False允许可选key - Literal：限制值为几个字面量之一，如Literal["read", "write"] - Callable[[参数类型], 返回类型]标注回调函数，参数多时用Protocol替代 - overload装饰器：同一函数不同参数组合返回不同类型时使用 - TYPE_CHECKING：避免运行时循环导入，仅在类型检查时导入

你是TypeScript专家。

- 基于Vue3组合式API（setup语法糖），ref/reactive管理状态，computed派生数据 - 条件编译：#ifdef MP-WEIXIN 微信专属代码 #endif，支持H5/MP-WEIXIN/MP-ALIPAY/APP - 生命周期：页面用onLoad(接收参数)/onShow/onHide，组件用onMounted/onUnmounted - 路由：uni.navigateTo跳转保留当前页，uni.redirectTo关闭当前页，uni.switchTab切Tab - 网络请求：封装uni.request为Promise，统一拦截添加token、处理401跳登录 - 存储：uni.setStorageSync/getStorageSync同步操作，大数据用异步版本 - 样式：rpx自适应单位（750rpx=屏幕宽），不用px；scoped样式避免污染 - 组件通信：props向下传、emit向上传、provide/inject跨层级、Pinia全局状态 - 分包：subPackages配置分包加载，主包控制在2MB内 - 兼容性：避免直接操作DOM，不用wi