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
协助新贡献者快速上手，检查仓库同步状态、构建及运行验证门禁，生成变更摘要。全程只读，不自动修改工作区或执行网络操作。
新克隆仓库初始化
检查本地与主分支差异
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 文档
用户需要修改现有 .docx 文件
用户需要提取 Word 文档内容
npx skills add Hmbown/CodeWhale --skill docx -g -y
提供飞书/Lark集成开发指南，涵盖Bot、文档、表格及审批流对接。强调安全使用环境变量存储凭证，支持MCP服务器配置与OpenAPI调用，指导从认证到验证的完整工作流。
用户询问飞书或Lark集成
需要配置飞书机器人或MCP服务
npx skills add Hmbown/CodeWhale --skill feishu -g -y
用于管理 Codewhale Agent Fleet 运行及 Worker 的 Skill。支持状态分类、故障排查、重启或升级处理，确保操作安全并记录凭证。
管理 Agent Fleet 运行
Worker 状态分类与排查
决定重启或升级策略
npx skills add Hmbown/CodeWhale --skill fleet-manager -g -y
专注于生产意图明确、响应式且无障碍的UI工作，执行视觉QA而非通用组件组装。涵盖受众澄清、设计层级、响应式实现及验收标准比对。
需要创建响应式和可访问的UI界面
执行前端视觉质量检查
npx skills add Hmbown/CodeWhale --skill frontend-design -g -y
用于在会话结束、上下文不足或长任务中断时，生成紧凑的决策就绪交接文档。通过收集Git、PR及CI状态，持久化关键上下文，确保新会话无需重建即可无缝继续工作。
用户请求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
用于设计、构建、配置和调试 Model Context Protocol (MCP) 服务器及工具集成，涵盖本地 stdio 与远程 HTTP/SSE 传输协议，提供 SDK 实现指南及 Codewhale 命令工作流。
创建 MCP 服务器
配置 MCP 连接
调试 MCP 工具集成
npx skills add Hmbown/CodeWhale --skill mcp-builder -g -y
指导优先使用MCP Registry发现并启动专用服务器，而非本地脚本或Shell命令，以获取数据库、浏览器自动化等专业化能力。
需要调用第三方API或服务
执行媒体处理或文档转换
进行浏览器自动化操作
访问特定数据库
npx skills add Hmbown/CodeWhale --skill mcp-discovery -g -y
提供PDF文件的读取、提取、拆分、合并、旋转、水印、表单填写、OCR及创建等处理功能，支持验证页面数量和文本提取准确性。
需要读取或提取PDF内容
需要拆分、合并或修改PDF结构
需要对扫描版PDF进行OCR识别
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或变更集进行只读的正确性审查。通过按严重程度列出带文件行证据的发现，指出残留风险和缺失测试，最后提供合并与风险摘要，确保审查结果可操作且重点突出。
需要审查代码差异或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 技能，提供技能定义、结构规范、编写规则及更新指南。
用户希望创建新技能
用户需要更新现有技能
用户询问何时应使用技能而非其他扩展机制
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或flash的思考模式处理多步任务
需要生成或执行涉及多个文件的复杂计划
npx skills add Hmbown/CodeWhale --skill v4-best-practices -g -y
用于对真实应用、API或CLI进行端到端验证，通过执行并捕获输出、日志等证据来证明功能正常，而非仅依赖单元测试。
需要验证真实系统行为
要求提供端到端运行证据
npx skills add Hmbown/CodeWhale --skill verify -g -y
用于在真实浏览器环境中启动或复用本地应用，等待就绪后检查DOM、控制台和网络状态，基于观察到的状态驱动交互流程，并记录通过/失败的证据以验证Web应用功能。
需要端到端验证Web应用流程
需要基于实际渲染状态进行交互测试
npx skills add Hmbown/CodeWhale --skill webapp-testing -g -y
用于创建、编辑、分析和验证电子表格工作簿（包括 XLSX/CSV/TSX），支持表格分析、公式计算及图表处理。
需要处理 Excel 或 CSV 数据
进行表格数据分析与验证
npx skills add Hmbown/CodeWhale --skill xlsx -g -y
用于在发布前执行自动化门禁扫描和手动QA验证，确保代码合并就绪。涵盖格式检查、测试运行、构建及TUI场景验证，防止未充分测试的代码进入生产环境。
准备宣布发布工作完成或PR可合并时
将PR合入发布分支后、发布边界前
验证真实发布分支上的候选版本时
npx skills add Hmbown/CodeWhale --skill codew-release-qa-sweep -g -y
批量将 GitHub Issue 分配给里程碑或负责人，包含预检和验证步骤，确保操作准确无误且不产生额外评论。
需要批量移动 Issue 到指定里程碑
需要批量分配 Issue 给特定负责人
里程碑重命名后需重新关联 Issue
npx skills add Hmbown/CodeWhale --skill gh-assign-issues -g -y
验证代码修复已合并后关闭GitHub Issue，通过引用具体提交或文件行号确认修复，并发送致谢评论。
需要关闭已修复的Issue
PR合并后需关联关闭Issue
npx skills add Hmbown/CodeWhale --skill gh-close-issues -g -y
将 GitHub Issues 分类为已解决、快速修复、设计或延期，通过拉取 Issue 详情并检查当前代码生成覆盖率矩阵报告。
需要评估 GitHub Issues 处理状态
生成版本覆盖率和 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队列，基于代码和测试而非标题判断合并可行性。针对实际发布分支进行合并冲突检测与CI状态分析，为每个PR生成DIRECT-MERGE、HARVEST等处置建议，辅助维护者决策。
询问PR队列状态或可合并项
发布前社区贡献筛选
需要PR合并性评估与建议
npx skills add Hmbown/CodeWhale --skill gh-find-prs -g -y
用于在发布前快速扫描 GitHub PR/Issue 队列，筛选高价值低风险任务（如新手 PR、已实现 Issue、小修复），生成带贡献者认证的优先级清单，辅助人工审批后执行。
PR/Issue 队列拥挤需要优先排序
发布前需最大化收录社区贡献
npx skills add Hmbown/CodeWhale --skill gh-treasure-hunt -g -y
documents是docx技能的兼容性别名，用于向后兼容。实际工作流需加载并遵循docx技能规范执行，建议优先使用docx。
用户调用名为documents的技能时
npx skills add Hmbown/CodeWhale --skill documents -g -y
这是一个兼容性别名技能，用于指向并加载 pptx 技能的主体工作流。旨在提供向后兼容，建议优先直接加载 pptx 技能。
用户请求处理 PPTX 演示文稿相关任务
系统需要加载 presentations 别名时
npx skills add Hmbown/CodeWhale --skill presentations -g -y
xlsx技能的兼容性别名，用于加载和遵循xlsx技能的实际工作流程。
需要处理Excel文件时
npx skills add Hmbown/CodeWhale --skill spreadsheets -g -y
