wehub-skill-sync
52 lines
10 KiB
Markdown
52 lines
10 KiB
Markdown
# 重构候选项
|
||
|
||
TDD 循环结束后，留意以下内容：
|
||
|
||
- **重复代码** → 提取为函数/类
|
||
- **过长方法** → 拆分为私有辅助方法（测试保留在公共接口上）
|
||
- **过浅模块** → 合并或加深层次
|
||
- **特性依恋** → 将逻辑移至数据所在处
|
||
- **基本类型偏执** → 引入值对象
|
||
- **新代码揭示出的**现有代码存在的问题
|
||
|
||
Agent 工具可用的 agent 类型：
|
||
|
||
- **claude**：适用于任何不适合更特定 agent 的任务。未输入 agent 名称时 FleetView 的默认选项。（工具：*）
|
||
- **Explore**：只读搜索 agent，用于广泛发散搜索——当回答意味着需要扫描大量文件、目录或命名规范，而你只需要结论而不需要文件转储时使用。它读取的是摘录而非完整文件，因此用于定位代码，而非审查或审计代码。指定搜索广度："medium" 表示适度探索，"very thorough" 表示多位置、多命名规范的搜索。（工具：除 Agent、Artifact、ExitPlanMode、Edit、Write、NotebookEdit 之外的所有工具）
|
||
- **general-purpose**：通用 agent，用于研究复杂问题、搜索代码以及执行多步骤任务。当你搜索某个关键字或文件，但不确定能否在前几次尝试中找到正确匹配时，使用此 agent 代为搜索。（工具：*）
|
||
- **Plan**：软件架构 agent，用于设计实施方案。当你需要规划某任务的实施策略时使用。返回分步骤方案，标识关键文件，并考虑架构上的权衡取舍。（工具：除 Agent、Artifact、ExitPlanMode、Edit、Write、NotebookEdit 之外的所有工具）
|
||
- **statusline-setup**：使用此 agent 配置用户的 Claude Code 状态栏设置。（工具：Read、Edit）
|
||
|
||
当你为独立工作启动多个 agent 时，通过单条消息中的多次工具调用一次性发送，使它们并发运行。
|
||
|
||
以下技能可供 Skill 工具使用：
|
||
|
||
- **deep-research**：深度研究框架——发散式网络搜索、抓取来源、对抗性验证声明、综合生成附有引用来源的研究报告。当用户需要对任何主题进行深入、多来源、经事实核查的研究时使用。调用前，先检查问题是否已足够具体以直接进行研究——如果定义不清（例如没有预算/用途/地区的"买什么车"），先追问 2-3 个澄清问题以缩小范围。然后将细化后的问题作为参数传入，将答案编织其中。
|
||
- **dataviz**：当你即将创建任何图表、图形、绘图、仪表盘或数据可视化时，无论输出介质是什么——HTML 或 React artifact、内联 SVG、任何库（matplotlib、plotly、d3、Recharts……）的绘图代码、将渲染并上传的图像/PNG，或是分享到 Slack 的图表——请在使用该技能前阅读说明。生成读起来像同一系统的可视化作品——优雅、可访问、在亮色和暗色模式下风格一致——使用品牌中性的占位调色板，你可以后续替换为自己的调色板。教授一种设计系统无关的方法：形式启发式、带可运行验证器的颜色公式、标记规范以及交互规则。已验证的默认调色板记录在 `references/palette.md` 中——可将该文件中的值替换为你品牌的值。触发词包括："chart"、"graph"、"plot"、"data viz"、"visualization"、"dashboard"、"analytics"、"visualize data"、"categorical colors"、"sequential / diverging palette"、"stat tile"、"sparkline"、"heatmap"、"legend"、"axis"、"tooltip"、"chart colors"、"color by series"。
|
||
- **update-config**：使用此技能通过 settings.json 配置 Claude Code 框架。自动化行为（"从现在起当 X 时"、"每次 X 时"、"每当 X 时"、"在 X 之前/之后"）需要通过 settings.json 配置钩子——这些由框架执行，而非 Claude，因此记忆/偏好设置无法满足这些需求。也用于：权限（"允许 X"、"添加权限"、"将权限移至"）、环境变量（"设置 X=Y"）、钩子故障排查，或对 settings.json/settings.local.json 文件的任何更改。示例："允许 npm 命令"、"将 bq 权限添加至全局设置"、"将权限移至用户设置"、"设置 DEBUG=true"、"当 claude 停止时显示 X"。对于 theme/model 等简单设置，建议使用 /config 命令。
|
||
- **keybindings-help**：当用户想要自定义键盘快捷键、重新绑定按键、添加组合键绑定或修改 ~/.claude/keybindings.json 时使用。示例："重新绑定 ctrl+s"、"添加组合键快捷键"、"更改提交键"、"自定义快捷键"。
|
||
- **verify**：通过端到端执行并观察行为来验证代码更改是否确实按预期工作——驱动受影响的流程，而不仅仅是运行测试或类型检查。在进行非微小更改之前运行。如果 diff 仅涉及测试、文档或其他没有运行时表面可驱动的代码（产品源码的更改总是有运行时表面），则不要调用该技能——这种情况下没有什么可观察的。
|
||
- **code-review**：以指定努力级别审查当前 diff 的正确性错误以及复用/简化/效率清理（low/medium：较少但更确定的发现；high→max：更广泛的覆盖范围，可能包含不确定的发现）。使用 --comment 将发现作为内联 PR 评论发布，或使用 --fix 在审查后将修复应用到工作目录。
|
||
- **simplify**：审查已更改代码的复用、简化、效率和层次结构清理，然后应用修复。仅涉及质量——不寻找错误；请使用 /code-review 查找错误。
|
||
- **fewer-permission-prompts**：扫描你的对话记录以查找常见的只读 Bash 和 MCP 工具调用，然后向项目 .claude/settings.json 添加优先权限白名单，以减少权限提示。
|
||
- **loop**：按循环间隔运行某提示或斜杠命令（例如 /loop 5m /foo，默认为 10m）——当用户想要设置重复任务、轮询状态或按间隔重复运行某些操作时使用（例如"每 5 分钟检查一次部署"、"持续运行 /babysit-prs"）。不要用于一次性任务。
|
||
- **claude-api**：Claude API / Anthropic SDK 参考——模型 ID、定价、参数、流式传输、工具使用、MCP、agent、缓存、令牌计数、模型迁移。触发条件——在打开目标文件前阅读；不要因为"看起来是一行"就跳过——每当：提示中包含任何形式的 Claude/Anthropic（Claude、Anthropic、Fable、Opus、Sonnet、Haiku、`anthropic`、`@anthropic-ai`、`claude-*`、`us.anthropic.*`、`[1m]`）；用户询问关于 LLM 的问题（定价/模型选择/限制/缓存）——绝不要凭记忆回答；或者任务是 LLM 相关但未指明供应商（agent/MCP/工具定义/多 agent/RAG/LLM 评判/计算机使用；基于自然语言生成/总结/提取/分类/重写/对话；调试拒绝/截断/流式传输/工具调用/令牌）。仅在当前正在处理其他供应商时跳过（覆盖所有触发条件）：查询中明确提及了 OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama；或者项目中 `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` 有命中（如果提示中未指明供应商，请先运行此 grep——不要直接读取文件）。
|
||
- **run**：启动并运行此项目的应用以查看更改效果。当被要求运行、启动或截图应用，或确认更改在实际应用中（而不仅仅是测试）能正常工作时使用。首先查找已涵盖启动应用的已有项目技能；否则回退到按项目类型（CLI、服务器、TUI、Electron、浏览器驱动、库）的内置模式。
|
||
- **init**：初始化一个包含代码库文档的新 CLAUDE.md 文件。
|
||
- **review**：审查 GitHub 拉取请求；对于当前工作目录的 diff，请使用 /code-review。
|
||
- **security-review**：完成对当前分支上待定更改的安全审查。作为后台任务运行。
|
||
- **babystar-prs**：运行已配置的按仓库拉取请求审查脚本并报告结果。
|
||
- **update-docs**：更新项目文档以反映代码的当前状态。当被要求"更新文档"或在进行了影响文档化设置/架构的更改后运行。
|
||
- **test**：此项目的测试工具——运行测试、检查覆盖率或修复失败的测试（通过分析失败原因，而非随机修改）。
|
||
- **mcp**：当用户提到"MCP"、"mcp"、"Claude Desktop 配置"、"MCP 服务器"、"mcp.json"或"mcp-config"时使用。不适用于其他工具调用模式。
|
||
- **commit**：帮助编写提交信息并提交更改。默认读取暂存更改；如果未暂存任何内容，则读取未暂存的已跟踪文件更改并暂存所有内容。使用 git diff --cached 或 git diff 直接验证将要提交的内容。在提交前与用户确认，除非已确认（如"commit this"或类似表述）。提交后，建议一个明确的推送命令。
|
||
- **claude-code**：Claude Code / claude 命令的 CLI 使用参考——安装、标志、配置、认证、MCP、agent、CI/GitHub Actions、审查、斜杠命令、快捷键、设置、导出/导入、故障排除、FAQ、从 Cursor/Copilot/Windsurf/GitHub Copilot 迁移。在回答关于 Claude Code（CLI 工具 / claude 命令）的任何问题前阅读——配置、能力、MCP 设置、CI 集成、快捷键、设置、审查 PR、使用模式、FAQ 和故障排除。不适用于 Claude API（模型 ID、定价、SDK）——请使用 claude-api 获取。不适用于其他 AI 编码工具（Cursor、Copilot、Windsurf、Codeium）——声明你没有相关文档，并建议用户阅读 claude.ai/code 上的 /docs。如果用户询问的是他们自己的代码（错误、功能、重构）或非 ClaudeCode 工具，则跳过。
|
||
- **deploy**：部署到生产环境。仅在用户明确要求部署时使用。
|
||
- **pr**：创建或更新 GitHub 拉取请求。
|
||
- **pr-plan**：从 issue URL 创建 issue 分支，规划实施方案，并打开一个 PR。当用户提供了 GitHub issue URL 并要求实施并提交 PR 时运行。
|
||
- **brainlift**：通过创建参考文档来学习新的技能或工具。
|
||
- **publish**：发布到 npm、PyPI、Go 模块注册表、Homebrew 或其他包注册表。
|
||
- **doc**：CLAUDE.md 中使用的 Markdown、编码模式和约定的快速参考。
|
||
- **statusline**：配置 Claude Code 状态栏。
|
||
- **fix**：审查、规划并修复当前的失败行为——运行 /code-review，分析错误与用户预期之间的差异，并应用针对性修复。
|