常用skills 大全1. api-endpoint作用: API 开发规范响应模型SSE/流式处理WebSocket 流程触发条件: 涉及 src/routers//*.py、src/api//*.py 文件或任务包含 “endpoint”, “api”, “router”, “websocket”, “sse”, “streaming”核心内容:StandardResponseModel 统一响应包装器SSE/流式端点必须使用 JSONResponseWebSocket 聊天流程错误响应格式2. architecture.md - 系统架构作用: 系统架构、安全层、外部集成触发条件: 任务包含 “architecture”, “system design”, “security”, “integration”, “nacos”, “rabbitmq”核心内容:FastAPI 服务器和业务处理 Worker多层安全架构HMAC-SHA256、JWT、用户上下文、AES 加密外部集成Nacos、Redis、Reranking、RabbitMQLLM 提供商集成3. coding-rules.md - 编码规范 ⭐作用: Python 3.11 编码标准类型提示、导入、注释、错误消息触发条件: 涉及 src//*.py、tests//*.py 文件或任务包含 “code”, “implement”, “function”, “class”核心规则:禁止 Optional[x]必须使用 x | None禁止在函数内导入必须在文件顶部导入客户端消息用英文代码注释用中文返回类型必须具体如 dict[str, Any] 而非 dict4. database-patterns.md - 数据库模式作用: 数据库模式、异步 SQLAlchemy、CRUD 操作、时间戳字段规则触发条件: 涉及 src/database//*.py、/models/**/*.py 文件或任务包含 “database”, “model”, “sqlalchemy”, “migration”, “timestamp”关键规则:时间戳字段必须使用 server_defaultfunc.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 AgentPython 3.11 标准验证e. 展示给用户f. 用户批准后提交8. testing.md - 测试指南作用: 测试指南、pytest 命令、测试结构、时间戳验证触发条件: 涉及 tests/**/*.py 文件或任务包含 “test”, “pytest”, “coverage”, “verify”核心内容:使用虚拟环境 Python 运行测试测试结构单元测试、集成测试、fixtures时间戳字段配置验证测试覆盖率目标 有文件夹的 Skills9. 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.py10. bugfix/ - Bug 修复工作流 作用: 系统化修复 AmaApi 代码库中的 Bug工作流程:a. 使用 grep 和文件读取识别根本原因b. 实现修复遵循现有代码模式c. 添加/更新测试用例d. 运行测试验证e. 记录变更如影响 API11. 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 处理本地 HTMLconsole_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.02017不使用 gh CLI 或 webReaderGitLab 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、schema18. gitnexus-impact-analysis/ - 影响分析 作用: 修改代码前的安全分析、影响范围评估工作流程:a. impact({target: “X”, direction: “upstream”}) - 查找依赖项b. READ gitnexus://repo/{name}/processes - 检查受影响的执行流程c. detect_changes() - 映射当前 git 变更到受影响流程d. 评估风险并报告给用户风险等级:d1: 将会中断直接调用者/导入者d2: 可能受影响间接依赖d3: 可能需要测试传递效应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.mdAPI 开发: 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.mdMR 审查: mr-review-inline/内部 GitLab所有 skills 都遵循项目的核心约束Python 3.11、异步优先、类型提示规范、中文注释/英文日志。