Agent Skills
› Hmbown/Codewhale
Hmbown/Codewhale
GitHub将大型可并行目标拆分为有限工作单元，协调现有代理工具执行、集成并验证结果。明确触发，不发明新编排引擎或发布部署。
Install All Skills
npx skills add Hmbown/Codewhale --all -g -y
Skills in Collection (49)
将大型可并行目标拆分为有限工作单元，协调现有代理工具执行、集成并验证结果。明确触发，不发明新编排引擎或发布部署。
处理需要协调子任务的大型并行目标
需要将大任务分解为多个独立单元进行执行和整合
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
指导主Agent将并行、边界清晰的任务委派给子Agent执行，涵盖任务拆分、上下文配置及结果验证。
需要将复杂任务拆分为多个独立子任务
需要并行执行代码审查或测试
npx skills add Hmbown/Codewhale --skill delegate -g -y
用于显式更新指定依赖范围，通过阅读发布说明、应用更新并修复破坏性变更，最后利用项目测试构建门控进行验证的自动化流程。
需要更新特定依赖版本
处理依赖升级中的破坏性变更
npx skills add Hmbown/Codewhale --skill dependency-update -g -y
用于创建、编辑和检查 Word 文档 (.docx)，支持备忘录、报告等。利用 python-docx 或 pandoc 处理，优先保留原件并验证内容。
需要生成或修改 Word 文档
提取 Word 文档内容
将其他格式转换为 Word
npx skills add Hmbown/Codewhale --skill docx -g -y
提供飞书/Lark集成指南，涵盖Bot、文档、表格及审批流开发。强调使用环境变量管理凭证，避免硬编码，并指导MCP服务器配置与API调用流程。
用户询问飞书或Lark相关功能
需要集成飞书机器人、文档或审批流
配置飞书OpenAPI或MCP服务
npx skills add Hmbown/Codewhale --skill feishu -g -y
管理 Codewhale 集群运行和 Worker，通过分类状态（瞬态/任务/验证器失败）选择安全操作或升级。支持重启、检查日志及生成升级草稿，严格遵循权限边界，禁止直接读取敏感文件或发送未授权消息。
需要管理或监控 Codewhale 集群运行时状态
Worker 运行异常需进行故障排查与分类
判断是否应重启 Worker 或升级给人类处理
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 服务器及工具集成。涵盖本地 stdio 与远程 HTTP/SSE 传输选择，遵循安全与结构化规范，提供 Codewhale CLI 操作指南及从定义边界到测试的完整工作流。
创建 MCP 服务器
配置 MCP 工具集成
调试 MCP 连接或服务
npx skills add Hmbown/Codewhale --skill mcp-builder -g -y
指导Agent优先通过MCP Registry发现并启动专用服务器，而非使用本地脚本或Shell命令执行数据获取、服务调用及自动化任务。
需要访问数据库或第三方API
涉及媒体处理或文档转换
需要浏览器自动化
常规工具集缺乏特定能力
npx skills add Hmbown/Codewhale --skill mcp-discovery -g -y
处理PDF文件的通用技能，支持读取、提取文本、OCR识别、拆分、合并、旋转、水印、填表及创建等功能。强调工具选择策略、结果验证及数据安全，适用于以PDF为核心输入输出的各类任务场景。
需要读取或解析PDF内容
对PDF进行拆分、合并或格式转换
从扫描版PDF中提取文字
生成或修改PDF文档
npx skills add Hmbown/Codewhale --skill pdf -g -y
将已充分理解的任务转化为包含依赖关系和验证点的有序实施计划，利用Codewhale原生状态管理，等待授权后执行。
任务目标明确但需分解步骤
需要梳理工作依赖关系
npx skills add Hmbown/Codewhale --skill plan -g -y
用于生成 Codewhale 本地插件包，包含版本化清单、命名空间技能及安全信任审查。指导创建 plugin.toml 及技能结构，配置 MCP 服务，执行验证与启用流程，确保符合 v0.9.1 加载器规范。
用户希望创建本地 Codewhale 插件包
需要初始化插件骨架并配置技能清单
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进行正确性评估
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 Agent 技能（Skill）。指导用户定义技能边界、编写 SKILL.md 文件及元数据，规范目录结构与写作规则，并判断何时使用 Skill 而非 MCP 或插件。
需要创建新的 Agent 技能
想要更新或改进现有技能
咨询技能与 MCP/插件的选型
npx skills add Hmbown/Codewhale --skill skill-creator -g -y
用于管理 Codewhale 技能的生命周期，包括查找、安装、更新、信任及移除技能。支持从 GitHub 或本地文件夹操作，并提供技能脚手架创建功能，帮助用户高效配置和管理 AI 助手扩展能力。
用户想要安装新的社区或第三方技能
用户需要更新已安装的技能
用户询问可用的技能列表
用户希望创建一个新的技能模板
npx skills add Hmbown/Codewhale --skill skill-installer -g -y
检测项目测试栈，运行针对性测试，在授权下创建或更新测试，并诚实报告覆盖率与缺口。
用户要求运行测试
用户要求添加或改进测试
npx skills add Hmbown/Codewhale --skill test -g -y
针对 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 应用流程
需检查渲染状态或网络请求
npx skills add Hmbown/Codewhale --skill webapp-testing -g -y
用于创建、编辑、分析和验证电子表格工作簿（包括XLSX/CSV/TSV），支持表格数据处理、公式计算及图表生成。
处理电子表格数据
分析表格数据
生成或修改公式
验证数据准确性
npx skills add Hmbown/Codewhale --skill xlsx -g -y
在发布工作完成前执行自动化门控扫描和手动QA验证，确保构建、测试及TUI交互正常，作为合并或发布的证据。
准备宣布发布工作完成
PR合并到发布分支后
npx skills add Hmbown/Codewhale --skill codew-release-qa-sweep -g -y
用于在真实环境中验证 Codewhale 变更，通过构建、原子安装和本地二进制文件手动测试，确保运行时行为正确。
需要证明代码变更在实际产品中有效
要求构建或安装本地二进制文件进行试吃
npx skills add Hmbown/Codewhale --skill cw-dogfood -g -y
在代码变更合并前执行验证梯度的技能，涵盖格式检查、区域测试及CI预算校验，确保变更安全可用。
确认变更完成或准备合并时
运行dogfood构建前
需证明变更安全性时
npx skills add Hmbown/Codewhale --skill cw-gates -g -y
用于生成代理接管提示、延续笔记或会话摘要的技能，确保交接内容基于实时状态，清晰区分已完成、疑似和阻塞项，便于后续代理准确继承上下文。
结束进行中工作的会话
请求为其他代理提供接管指令或状态摘要
npx skills add Hmbown/Codewhale --skill cw-handoff -g -y
用于将已验证的代码变更安全地合并到主分支，处理分支策略、提交规范、贡献者署名及冲突解决，确保符合门禁要求。
需要提交或合并代码时
处理他人PR的冲突或署名
在门禁通过后执行合并操作
npx skills add Hmbown/Codewhale --skill cw-land -g -y
在开始编码或接手任务前，通过Git命令确认当前仓库状态、分支、工作树及版本信息，确保操作基于最新的真实代码环境，避免编辑错误位置。
开始新的开发会话
接手他人工作
不确定当前工作目录或分支状态时
npx skills add Hmbown/Codewhale --skill cw-orient -g -y
在编写代码前，通过搜索现有模块和依赖，避免重复实现。强制复用已有功能或标准库，确保变更范围最小化并绑定到单一可审查切片。
创建新功能
进行重构
升级现有功能
计划新建模块前
npx skills add Hmbown/Codewhale --skill cw-slice -g -y
批量将GitHub Issue分配给里程碑或负责人，包含严格的前置校验与结果验证流程，确保操作准确且无副作用。
需要批量移动Issue到指定发布里程碑
需要批量指派Issue给特定负责人
npx skills add Hmbown/Codewhale --skill gh-assign-issues -g -y
在GitHub上关闭已解决Issue前，强制验证修复代码是否真正落地并留存证据。通过CLI核实提交记录与分支状态，发布致谢评论后执行关闭操作，确保流程严谨且尊重贡献者。
需要关闭标记为已解决的GitHub Issue
合并PR后需关联关闭对应Issue
清理里程碑中已修复的Issue
npx skills add Hmbown/Codewhale --skill gh-close-issues -g -y
该 Skill 用于对 GitHub Issue 进行覆盖度分类。通过获取 Issue 详情并结合当前代码审查，判断其状态（已解决、快速修复、需设计或延期），生成带证据引用的覆盖率矩阵报告，辅助维护者决策。
需要评估特定里程碑或标签下的 Issue 处理进度
要求基于当前代码事实对 Issue 进行分类和证据引用
npx skills add Hmbown/Codewhale --skill gh-compile-issues -g -y
将单个社区PR合入发布分支，保留作者署名并验证通过，随后致谢。用于在审批后安全着陆代码并维护贡献者信用。
需要合入单个社区PR到发布分支
验证PR代码、测试和CI状态并准备提交
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队列，通过代码、测试和CI检查评估合并可行性，针对实际发布分支而非main分支生成DIRECT-MERGE等处置建议，辅助维护者决策。
维护者询问PR队列状态或可合并项
版本发布前需整理社区贡献
需要对每个PR进行合并性评估并给出处置建议
npx skills add Hmbown/Codewhale --skill gh-find-prs -g -y
用于在发布前高效筛选高价值低风险的社区PR和Issue，通过自动化命令评估合并安全性、验证代码变更并处理贡献者署名，生成优先级行动列表。
需要快速清理拥挤的PR/Issue队列
希望在发布前最大化新贡献者的落地
寻找安全的快速修复或已实现的Issue
npx skills add Hmbown/Codewhale --skill gh-treasure-hunt -g -y
作为docx技能的兼容别名，引导用户加载并遵循docx技能的实际工作流。
用户提及documents技能
需要文档处理但使用了旧称
npx skills add Hmbown/Codewhale --skill documents -g -y
演示文稿处理技能的兼容别名，指向 pptx 技能。用于加载并遵循 pptx 的实际工作流程，建议优先直接加载 pptx。
用户需要生成或编辑 PPTX 文件
调用 presentations 别名时
npx skills add Hmbown/Codewhale --skill presentations -g -y
xlsx技能的兼容别名，用于加载和处理电子表格文件。实际工作流需遵循xlsx技能规范。
需要读取或生成Excel文件
处理.xlsx格式数据
npx skills add Hmbown/Codewhale --skill spreadsheets -g -y
