Agent Skills
› Hmbown/CodeWhale
Hmbown/CodeWhale
GitHub将大型可并行目标拆分为有界工作单元，协调现有代理工具执行，并整合验证结果。适用于需要协调子任务的复杂并行工作场景。
Install All Skills
npx skills add Hmbown/CodeWhale --all -g -y
Skills in Collection (43)
将大型可并行目标拆分为有界工作单元，协调现有代理工具执行，并整合验证结果。适用于需要协调子任务的复杂并行工作场景。
需要将大任务拆解为多个并行子任务
需要协调多个代理或工作区协同完成目标
npx skills add Hmbown/CodeWhale --skill batch -g -y
用于高价值或模糊任务的多方案并行生成与评审。通过独立生成候选解，依据明确标准进行统一评判并验证后应用最优结果，提升复杂决策质量。
存在多种可行解决方案的复杂设计或实现任务
需要对比评估不同调试或解释策略的高风险场景
npx skills add Hmbown/CodeWhale --skill best-of-n -g -y
辅助新贡献者快速上手，安全检查仓库同步状态、执行构建及CI验证门控，并生成变更摘要。严格只读操作，不自动修改工作树或发起网络请求。
新贡献者首次克隆仓库后需要确认环境就绪
开发者离开一段时间后回来需检查代码同步和构建状态
npx skills add Hmbown/CodeWhale --skill contributor-onboarding -g -y
根据数据生成图表、仪表盘或可视化解释，确保编码清晰并附带来源说明。
需要数据可视化
生成图表或仪表盘
npx skills add Hmbown/CodeWhale --skill dataviz -g -y
用于复现、最小化、定位故障根因，并区分诊断与修复。适用于失败、崩溃及回归问题，强调先查明原因再行动，避免盲目修补症状。
代码运行失败或报错
出现偶发性测试不通过
系统崩溃或异常退出
输出结果不符合预期
发现功能回归
npx skills add Hmbown/CodeWhale --skill debug -g -y
指导在多步编码、研究或验证任务中，通过拆分父级推理与子代理并行执行来优化工作流。明确保留架构决策和最终审查于父级，将独立探索、机械编辑等任务委派给子代理，并提供具体的提示词构造与验证规范。
需要并行处理多个独立子任务
任务可拆分为探索、编辑和验证阶段
npx skills add Hmbown/CodeWhale --skill delegate -g -y
用于显式更新指定依赖范围，通过阅读发布说明处理破坏性变更并修复问题，最终验证构建和测试是否通过。
需要更新特定依赖版本
解决依赖升级导致的兼容性问题
npx skills add Hmbown/CodeWhale --skill dependency-update -g -y
用于创建、编辑和检查 Word 文档（.docx），支持备忘录、报告等格式。通过 python-docx 或 pandoc 处理，优先在 workspace 中操作并保留原件，最后验证内容。
用户要求生成 Word 文档
用户需要修改现有 .docx 文件
用户需要提取 Word 文档文本
npx skills add Hmbown/CodeWhale --skill docx -g -y
提供飞书/Lark集成开发指南，涵盖机器人、文档、表格及审批流等API调用与MCP配置，强调安全凭证管理及官方接口使用。
飞书集成
Lark API
飞书消息发送
飞书文档操作
飞书MCP配置
npx skills add Hmbown/CodeWhale --skill feishu -g -y
用于管理 Codewhale Agent Fleet 运行状态，通过分类工作器状态并执行重启或升级操作。提供标准化排查流程与安全边界约束，确保故障处理的可追溯性与安全性。
需要检查 Agent 集群或工作器状态
Agent 任务失败需进行故障排查与恢复
需要总结或上报 Agent 运行结果
npx skills add Hmbown/CodeWhale --skill fleet-manager -g -y
专注于有意、响应式且无障碍的UI实现与视觉QA，拒绝通用占位布局，强调设计层级与状态处理。
需要高质量UI实现
进行视觉验收测试
涉及无障碍访问需求
npx skills add Hmbown/CodeWhale --skill frontend-design -g -y
用于在会话结束或上下文耗尽时，生成紧凑的交接文档，确保后续会话无需重建即可继续工作。适用于用户请求交接、长运行任务状态持久化等场景。
用户明确请求 handoff/pass the baton
会话即将结束或上下文不足
长运行操作需要状态检查点
npx skills add Hmbown/CodeWhale --skill handoff -g -y
用于路由 Codewhale 自身使用问题（命令、配置、快捷键等），引导至官方文档或内置诊断工具，禁止凭记忆回答。
用户询问如何安装或使用 Codewhale
查询特定命令参数或配置文件路径
npx skills add Hmbown/CodeWhale --skill help -g -y
用于执行已授权且范围明确的开发任务，强调最小化变更集、比例验证及严格遵循接受标准。适用于代码实现阶段，确保变更可控并报告结果。
用户提出明确的代码修改需求
执行已批准的实施方案
需要小范围功能实现
npx skills add Hmbown/CodeWhale --skill implement -g -y
当需求缺乏关键产品或实现选择且无法通过工具发现时，通过单次结构化提问澄清模糊点。记录答案并生成简短规范，若用户拒绝则基于假设继续执行。
需求缺少关键决策点
实现方案不明确
npx skills add Hmbown/CodeWhale --skill interview -g -y
用于设计、构建、配置和调试 MCP 服务器及工具集成。涵盖传输协议选择、安全配置及 Codewhale 命令使用，提供从定义边界到测试的完整工作流。
创建或配置 MCP 服务器
调试 MCP 工具集成
npx skills add Hmbown/CodeWhale --skill mcp-builder -g -y
优先通过 MCP Registry 发现并启动专用服务器以完成任务，而非使用本地命令或自定义代码。涵盖数据获取、服务调用及工作流自动化等场景。
需要执行数据库访问、浏览器自动化、媒体处理等专用能力任务
当前工具集缺乏所需能力且涉及第三方 API 或服务集成
npx skills add Hmbown/CodeWhale --skill mcp-discovery -g -y
处理PDF文件的核心技能，支持读取、提取文本、OCR、拆分、合并、旋转、加水印、填表、创建及加密解密等操作。强调保留原件、选择可靠工具并验证输出质量与安全性。
需要读取或解析PDF内容
需要对PDF进行拆分或合并操作
需要从扫描件中通过OCR提取文本
需要生成或修改PDF文件
npx skills add Hmbown/CodeWhale --skill pdf -g -y
将已明确的任务转化为包含依赖关系和验证步骤的执行计划，并写入系统原生状态。用于在任务理解充分但无单一明显操作时进行工作排序与规划。
需要制定有序实施计划
任务目标清晰但需分解步骤
npx skills add Hmbown/CodeWhale --skill plan -g -y
用于生成本地 Codewhale 插件包，包含版本化清单、命名空间技能及安全信任审查流程。
用户希望创建本地 Codewhale 插件包
需要初始化插件目录结构和 manifest 文件
npx skills add Hmbown/CodeWhale --skill plugin-creator -g -y
用于创建、编辑、检查和验证 PowerPoint (.pptx) 幻灯片演示文稿。提供布局选择、内容密度优化及重新打开验证的工作流指南。
需要制作或修改 PPT 文件
检查幻灯片结构或标题
npx skills add Hmbown/CodeWhale --skill pptx -g -y
用于外部事实研究，如查阅发布说明、文档和现有技术。强调优先使用一手来源，注意日期与版本，区分事实与推断，并列出未决问题。
需要查询最新技术文档或发布说明
进行现有技术调研或竞品分析
npx skills add Hmbown/CodeWhale --skill research -g -y
用于对代码变更、PR或指定变更集进行只读的正确性审查。按严重程度列出发现，提供文件/行证据，指出剩余风险和缺失测试，并给出合并建议。
审查代码差异(diff)
评审Pull Request(PR)
检查特定变更集的正确性
npx skills add Hmbown/CodeWhale --skill review -g -y
用于审查安全漏洞、认证授权缺陷、密钥泄露及信任边界风险，评估可利用性并提供修复建议。
寻找应用中的安全漏洞
检查认证和授权缺陷
排查密钥泄露风险
评估不安全的信任边界
npx skills add Hmbown/CodeWhale --skill security-review -g -y
在明确行为后简化代码，降低复杂度并提升清晰度。要求保持行为不变，将清理与正确性修复分离，通过小步验证确保修改安全。
用户希望提升代码可读性
代码逻辑过于复杂需要重构
npx skills add Hmbown/CodeWhale --skill simplify -g -y
用于创建或优化 Codewhale 技能，指导用户定义技能边界、编写 SKILL.md 文件及遵循最佳实践。适用于需要新建技能、更新现有技能或判断是否应使用技能而非其他扩展机制的场景。
用户想要创建新的 Codewhale 技能
用户希望更新或改进现有的 Codewhale 技能
用户需要指导如何区分技能与 MCP、Hooks 或插件
npx skills add Hmbown/CodeWhale --skill skill-creator -g -y
用于管理Codewhale技能的安装、更新、信任及移除。支持从GitHub或本地目录获取技能，提供列表、激活、脚手架生成等功能，并强调在安装社区技能前需审查安全性。
用户请求安装新技能
用户询问可用技能列表
用户需要更新或卸载已安装的技能
npx skills add Hmbown/CodeWhale --skill skill-installer -g -y
检测项目测试框架，运行针对性测试，在授权下创建或更新测试，并诚实报告覆盖率与缺失情况。
用户要求运行测试
用户要求添加或改进测试
npx skills add Hmbown/CodeWhale --skill test -g -y
针对DeepSeek V4思维模式的多步骤任务最佳实践，通过验证引用、启用子代理校验及精确路径定位，防止幻觉和计划执行失败。
使用 deepseek-v4-pro 或 v4-flash 进行多步规划
涉及多个文件的代码修改与执行
npx skills add Hmbown/CodeWhale --skill v4-best-practices -g -y
用于对真实应用、API或CLI进行端到端验证，通过执行并收集可观测证据（如输出、日志）来证明功能正常，区别于仅依赖单元测试。
需要证明真实系统表面功能正常
要求提供端到端验证的可观测证据
npx skills add Hmbown/CodeWhale --skill verify -g -y
用于在真实浏览器环境中启动或复用本地 Web 应用，等待就绪后检查 DOM、控制台和网络状态，基于观察到的状态驱动操作并记录通过/失败的证据，以验证 Web 应用流程。
需要验证 Web 应用端到端流程
需要在真实浏览器上下文中测试 UI 交互
npx skills add Hmbown/CodeWhale --skill webapp-testing -g -y
用于创建、编辑、分析和验证电子表格工作簿（如XLSX/CSV/TSV），支持表格处理、公式计算及图表生成，确保数据准确性与可审计性。
需要处理Excel或CSV文件
进行表格数据分析或公式计算
npx skills add Hmbown/CodeWhale --skill xlsx -g -y
用于在发布前执行自动化门禁扫描和手动QA验证，确保代码质量与功能正常。
确认发布工作完成
合并PR到发布分支后
验证发布候选版本
npx skills add Hmbown/CodeWhale --skill codew-release-qa-sweep -g -y
批量将 GitHub Issue 分配至里程碑或指定负责人，通过预检和逐条验证确保操作准确，仅变更归属而不产生额外评论。
需要将多个 Issue 批量归类到特定发布里程碑
需要批量指派 Issue 给具体负责人
npx skills add Hmbown/CodeWhale --skill gh-assign-issues -g -y
验证代码修复是否真正落地后关闭 GitHub Issue，通过引用 commit SHA 或文件路径提供证据，并向报告者致谢。严禁仅凭标题或标签关闭，确保准确性与社区友好性。
需要关闭已修复的 GitHub Issue
合并 PR 后关联关闭对应 Issue
检查 Milestone 中 Issue 的实际解决状态
npx skills add Hmbown/CodeWhale --skill gh-close-issues -g -y
自动化审查GitHub Issue，结合当前代码验证并分类处理状态（已完成、快速修复、需设计或延期），生成带证据的覆盖率矩阵报告。
需要评估版本里程碑中Issue的覆盖情况
批量梳理和分类GitHub Issue的处理优先级
npx skills add Hmbown/CodeWhale --skill gh-compile-issues -g -y
将社区PR安全合并至发布分支，保留作者署名与机器可读信用，验证CI通过后致谢。
批准合并单个社区PR
需要保留贡献者署名并致谢
npx skills add Hmbown/CodeWhale --skill gh-credit-harvest -g -y
用于在 CodeWhale 项目中创建高质量、可执行的 GitHub Issue。涵盖从收集证据、检查重复项到撰写标题、正文及标签的完整工作流，确保问题清晰且具备可验证性。
发现 bug 或回归问题需要追踪
提出新功能或产品改进建议
社区报告或 PR 中提及需独立跟踪的缺陷
npx skills add Hmbown/CodeWhale --skill gh-file-issue -g -y
用于审查开源PR队列，基于代码和测试而非标题评估每个PR在真实发布分支上的可合并性。通过对比CI状态和模拟合并，给出直接合并、收割、延期或关闭的建议，辅助维护者进行版本发布前的贡献筛选。
维护者询问PR队列状态或可合并项
发布前扫描社区贡献以并入活跃分支
需要对PR进行逐条可合并性评估和建议
npx skills add Hmbown/CodeWhale --skill gh-find-prs -g -y
自动化扫描GitHub仓库的PR和Issue队列，基于价值与风险比筛选出安全、低风险的社区贡献（如新作者PR、已实现的Issue、小修复），生成优先级行动列表并处理署名，辅助发布前快速清理。
发布前需要快速清理积压的PR和Issue
PR/Issue队列拥挤，需要优先处理高价值低风险项
希望最大化收录新贡献者
npx skills add Hmbown/CodeWhale --skill gh-treasure-hunt -g -y
documents 是 docx 技能的兼容性别名，用于加载并遵循 docx 技能的实际工作流程。
用户请求处理文档文件
npx skills add Hmbown/CodeWhale --skill documents -g -y
该 Skill 是 pptx 的兼容性别名，用于加载和遵循 pptx 的实际工作流。
用户需要生成或编辑 PPTX 演示文稿
npx skills add Hmbown/CodeWhale --skill presentations -g -y
xlsx技能的兼容性别名，用于加载并遵循xlsx技能的实际工作流。
需要处理Excel文件时
npx skills add Hmbown/CodeWhale --skill spreadsheets -g -y
