常用skills 大全

1. api-endpoint

• 作用: API 开发规范，响应模型，SSE/流式处理，WebSocket 流程
• 触发条件: 涉及 src/routers//*.py、src/api//*.py 文件或任务包含 “endpoint”, “api”, “router”, “websocket”, “sse”, “streaming”
• 核心内容:
  • StandardResponseModel 统一响应包装器
  • SSE/流式端点必须使用 JSONResponse
  • WebSocket 聊天流程
  • 错误响应格式

2. architecture.md - 系统架构

• 作用: 系统架构、安全层、外部集成
• 触发条件: 任务包含 “architecture”, “system design”, “security”, “integration”, “nacos”, “rabbitmq”
• 核心内容:
  • FastAPI 服务器和业务处理 Worker
  • 多层安全架构（HMAC-SHA256、JWT、用户上下文、AES 加密）
  • 外部集成（Nacos、Redis、Reranking、RabbitMQ）
  • LLM 提供商集成

3. coding-rules.md - 编码规范 ⭐

• 作用: Python 3.11+ 编码标准（类型提示、导入、注释、错误消息）
• 触发条件: 涉及 src//*.py、tests//*.py 文件或任务包含 “code”, “implement”, “function”, “class”
• 核心规则:
  • 禁止 Optional[x]，必须使用 x | None
  • 禁止在函数内导入，必须在文件顶部导入
  • 客户端消息用英文，代码注释用中文（）
  • 返回类型必须具体（如 dict[str, Any] 而非 dict）

4. database-patterns.md - 数据库模式

• 作用: 数据库模式、异步 SQLAlchemy、CRUD 操作、时间戳字段规则
• 触发条件: 涉及 src/database//*.py、/models/**/*.py 文件或任务包含 “database”, “model”, “sqlalchemy”, “migration”, “timestamp”
• 关键规则:
  • 时间戳字段必须使用 server_default=func.now()（数据库级），禁止 default=（应用级）
  • 所有数据库操作使用 async/await
  • 使用 CRUDBase 基类进行 CRUD 操作

5. development.md - 开发指南

• 作用: 本地开发设置、Docker 部署、日志记录
• 触发条件: 任务包含 “setup”, “install”, “docker”, “deploy”, “log”, “local”, “development”
• 核心内容:
  • 虚拟环境 Python 使用
  • 环境变量配置
  • Docker 部署
  • Loguru 日志使用

6. gotchas.md - 常见陷阱

• 作用: 已知问题、常见陷阱、调试模式
• 触发条件: 任务包含 “debug”, “error”, “fix”, “bug”, “issue”, “problem”, “troubleshoot”
• 常见陷阱:
  • SSE/流式端点的 ERR_INCOMPLETE_CHUNKED_ENCODING 错误
  • 数据库更新不持久（缺少 @transactional 装饰器）
  • 异步/SQLAlchemy 并发操作错误

7. multi-agent-code-review.md - 多代理代码审查

• 作用: 自动化代码审查工作流，使用专业化代理（code-reviewer、code-simplifier、python-pro）
• 使用场景: 每次代码变更都需要审查（新功能、Bug 修复、重构、数据库模型变更、API 端点添加）
• 工作流程:
  a. 编写代码
  b. Code Reviewer Agent（安全性、Bug 检查）
  c. Code Simplifier Agent（代码优化）
  d. Python-Pro Agent（Python 3.11+ 标准验证）
  e. 展示给用户
  f. 用户批准后提交

8. testing.md - 测试指南

• 作用: 测试指南、pytest 命令、测试结构、时间戳验证
• 触发条件: 涉及 tests/**/*.py 文件或任务包含 “test”, “pytest”, “coverage”, “verify”
• 核心内容:
  • 使用虚拟环境 Python 运行测试
  • 测试结构（单元测试、集成测试、fixtures）
  • 时间戳字段配置验证
  • 测试覆盖率目标

---

📂 有文件夹的 Skills

9. api-endpoint/ - RESTful API 端点生成器 🛠️

• 作用: 生成符合 FastAPI 最佳实践的 RESTful API 端点
• 使用方法: /api-endpoint create GET /repositories/{repository_id}/documents
• 核心功能:
  • 自动生成请求/响应模型
  • 端点实现（GET list/detail、POST create、PUT update、DELETE）
  • 测试代码生成
  • 文件上传、流式响应等特殊场景处理
• 包含模板: DELETE_delete.py、GET_detail.py、GET_list.py、POST_create.py、PUT_update.py、test_template.py

10. bugfix/ - Bug 修复工作流 🔧

• 作用: 系统化修复 AmaApi 代码库中的 Bug
• 工作流程:
  a. 使用 grep 和文件读取识别根本原因
  b. 实现修复（遵循现有代码模式）
  c. 添加/更新测试用例
  d. 运行测试验证
  e. 记录变更（如影响 API）

11. review/ - 代码审查 👁️

• 作用: 专家代码审查员
• 两种模式:
  • 模式 1: 本地变更审查（无 MR 号）- git status 和 git diff
  • 模式 2: MR 审查（指定 MR 号）- 使用内部 Git 命令（非 GitHub）
• 审查维度:
  • 代码质量（正确性、逻辑、项目约定）
  • 类型提示（Python 3.11+ 风格）
  • 性能影响
  • 安全考虑
  • 测试覆盖率

12. webapp-testing/ - Web 应用测试 🌐

• 作用: 使用 Playwright 测试本地 Web 应用的工具包
• 核心功能:
  • 验证前端功能
  • 调试 UI 行为
  • 捕获浏览器截图
  • 查看浏览器日志
• 辅助脚本: scripts/with_server.py - 管理服务器生命周期
• 示例:
  • element_discovery.py - 发现按钮、链接、输入
  • static_html_automation.py - 使用 file:// URL 处理本地 HTML
  • console_logging.py - 捕获自动化期间的控制台日志

13. mr-review-inline/ - MR 审查 + 内联评论 📝

• 作用: 内部 GitLab MR 审查，多角度代码审查，发布摘要评论到 Discussion 标签，在 Changes 标签添加绑定到特定 diff 行的内联评论
• 触发条件: “review MR”, “审查 MR”, “review merge request !NN”, “add inline comments to MR”, “在 MR 上标 inline 评论”，或 merge_requests/N URL
• 硬约束:
  • 仅限内部 GitLab: http://192.168.57.8/…，版本 10.0.0（2017）
  • 不使用 gh CLI 或 webReader
  • GitLab 10.0 没有 discussions/diff_versions REST API
  • 需要浏览器认证

---

📂 gitnexus/ 系列 - GitNexus 代码智能工具集 🔍

14. gitnexus-cli/ - GitNexus CLI 命令

• 作用: 运行 GitNexus CLI 命令（分析/索引仓库、检查状态、清理索引、生成 wiki、列出已索引仓库）
• 命令:
  • analyze - 构建或刷新索引
  • status - 检查索引新鲜度
  • clean - 删除索引
  • wiki - 从知识图生成文档
  • list - 显示所有已索引仓库

15. gitnexus-debugging/ - 调试 🐛

• 作用: 调试 Bug、追踪错误、询问失败原因
• 工作流程:
  a. query({query: “”}) - 查找相关执行流程
  b. context({name: “”}) - 查看调用者/被调用者/流程
  c. READ gitnexus://repo/{name}/process/{name} - 追踪执行流程
  d. cypher({query: “MATCH path…”}) - 自定义追踪

16. gitnexus-exploring/ - 代码探索 🔎

• 作用: 理解代码工作原理、追踪执行流程、探索不熟悉的代码部分
• 工作流程:
  a. READ gitnexus://repos - 发现已索引仓库
  b. READ gitnexus://repo/{name}/context - 代码库概览
  c. query({query: “”}) - 查找相关执行流程
  d. context({name: “”}) - 深入特定符号
  e. READ gitnexus://repo/{name}/process/{name} - 追踪完整执行流程

17. gitnexus-guide/ - GitNexus 指南 📖

• 作用: GitNexus 工具、资源、图模式参考
• 工具参考:
  • query - 流程分组代码智能
  • context - 符号 360 度视图
  • impact - 符号影响范围
  • detect_changes - Git-diff 影响
  • rename - 多文件协调重命名
  • cypher - 原始图查询
• 资源参考: context、clusters、cluster、processes、process、schema

18. gitnexus-impact-analysis/ - 影响分析 💥

• 作用: 修改代码前的安全分析、影响范围评估
• 工作流程:
  a. impact({target: “X”, direction: “upstream”}) - 查找依赖项
  b. READ gitnexus://repo/{name}/processes - 检查受影响的执行流程
  c. detect_changes() - 映射当前 git 变更到受影响流程
  d. 评估风险并报告给用户
• 风险等级:
  • d=1: 将会中断（直接调用者/导入者）
  • d=2: 可能受影响（间接依赖）
  • d=3: 可能需要测试（传递效应）

19. gitnexus-refactoring/ - 重构 🏗️

• 作用: 安全重命名、提取、拆分、移动代码
• 工作流程:
  a. impact({target: “X”, direction: “upstream”}) - 映射所有依赖项
  b. query({query: “X”}) - 查找涉及 X 的执行流程
  c. context({name: “X”}) - 查看所有入站/出站引用
  d. 规划更新顺序：接口 → 实现 → 调用者 → 测试
• 工具:
  • rename - 自动化多文件重命名
  • impact - 首先映射所有依赖项
  • detect_changes - 重构后验证
  • cypher - 自定义引用查询

---

🎯 使用建议

• 日常编码: coding-rules.md + gotchas.md
• API 开发: api-development.md + api-endpoint/ + database-patterns.md
• 代码审查: multi-agent-code-review.md + review/
• Bug 修复: bugfix/ + gotchas.md + gitnexus-debugging/
• 重构: gitnexus-refactoring/ + gitnexus-impact-analysis/
• 理解代码库: gitnexus-exploring/ + architecture.md
• MR 审查: mr-review-inline/（内部 GitLab）

所有 skills 都遵循项目的核心约束：Python 3.11+、异步优先、类型提示规范、中文注释/英文日志。