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
用于处理故障、回归和崩溃等问题的调试技能。通过复现、最小化、定位和根因分析，区分症状与根源，在授权前仅提供诊断证据而非直接修复。
系统出现故障或崩溃
出现不稳定的测试用例（flakes）
输出结果错误
代码行为发生回归
npx skills add Hmbown/CodeWhale --skill debug -g -y
指导主Agent将并行、边界清晰的子任务（如只读探索、机械编辑、测试运行）委派给子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 工具处理文件，确保保留原件并验证内容准确性。
需要生成或修改 .docx 文件
提取 Word 文档中的文本内容
将其他格式转换为 Word 文档
npx skills add Hmbown/CodeWhale --skill docx -g -y
提供飞书/语雀集成开发指南，涵盖Bot、文档、表格及审批流等OpenAPI调用与MCP配置。强调凭证安全与环境变量管理，指导从认证到验证的完整工作流，确保集成稳定可靠。
用户请求飞书或Lark相关功能集成
需要配置飞书机器人Webhook
涉及飞书文档、多维表格或审批流的读写操作
设置飞书MCP服务器
npx skills add Hmbown/CodeWhale --skill feishu -g -y
管理 Codewhale Agent Fleet 的运行与 Worker，通过分类状态选择重启或升级操作，确保执行安全并记录审计日志。
需要查看或管理 Agent 集群状态
Worker 运行失败需排查原因
需要重启或停止特定的 Agent Worker
npx skills add Hmbown/CodeWhale --skill fleet-manager -g -y
专注于构建有意、响应式且无障碍的用户界面，并执行视觉质量检查，而非组装通用组件。
需要设计高可用性UI时
进行前端视觉QA时
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
该 Skill 是 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 命令及完整工作流。
创建或配置 MCP 服务器
调试 MCP 工具集成
npx skills add Hmbown/CodeWhale --skill mcp-builder -g -y
指导Agent优先通过MCP Registry发现并启动专用服务器以解决任务，而非使用本地命令或自定义代码。涵盖注册表同步、匹配、安装及故障处理流程，旨在提升工具调用的标准化与效率。
需要调用数据库、浏览器或第三方API等专用能力
执行媒体转换、文档处理等特定操作
自动化工作流中缺乏当前工具集支持的功能
npx skills add Hmbown/CodeWhale --skill mcp-discovery -g -y
处理PDF文件的通用技能，支持读取、提取、OCR、拆分、合并、旋转、水印、填表及创建等操作。强调保留原件、选择可靠工具并验证输出质量。
需要读取或解析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 和 SKILL.md，规范 MCP 配置与安全限制，确保插件符合 v0.9.1 加载器约束。
用户需要创建本地 Codewhale 插件包
初始化插件结构并配置清单
npx skills add Hmbown/CodeWhale --skill plugin-creator -g -y
用于创建、编辑、检查和验证 PowerPoint (PPTX) 幻灯片演示文稿的技能。提供兼容性别名，并规范了布局选择、内容密度及文件校验的工作流程。
需要生成或修改 PPTX 文件
检查演示文稿的结构和内容
npx skills add Hmbown/CodeWhale --skill pptx -g -y
利用外部工具进行事实核查、文档查阅及生态变化研究，强调引用权威来源、版本意识和事实与推论分离。
查询官方发布说明
查找技术文档或先验案例
调研生态系统变更
npx skills add Hmbown/CodeWhale --skill research -g -y
用于对代码变更集进行只读正确性审查，按严重程度列出发现并提供文件行证据，最后给出合并与风险摘要。
审查 PR 或 diff
评估代码变更的正确性
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/MCP/Plugin），并规范 SKILL.md 的结构与编写规则。
需要创建新的 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 或 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/TSX格式的电子表格工作簿，支持表格处理、公式计算及图表生成。
需要处理电子表格文件
进行数据表格分析
操作Excel或CSV格式数据
npx skills add Hmbown/CodeWhale --skill xlsx -g -y
用于发布前验证的完整QA流程，包含自动化门禁扫描（格式、测试、构建、版本一致性）和手动TUI运行时检查，确保发布工作完成。
发布工作完成后验证
合并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，严格验证修复提交后致谢并关联证据。适用于确认修复落地、合并 PR 后收尾或里程碑清理场景，确保准确且尊重贡献者。
Issue 看似已通过主分支或发布分支的提交解决，需带致谢关闭
合并 PR 后需要关闭其修复的相关 Issue
进行里程碑清理，批量处理可能已修复的 Issue
npx skills add Hmbown/CodeWhale --skill gh-close-issues -g -y
自动分类GitHub Issue为已完成、快速修复、需设计或延期，通过检查当前代码并引用证据生成覆盖率矩阵报告。
需要评估Issue对代码的覆盖情况
批量处理里程碑下的Issue状态
npx skills add Hmbown/CodeWhale --skill gh-compile-issues -g -y
用于将社区PR合并至发布分支，保留作者署名并验证CI通过。流程包括获取PR、审查代码与测试、解决冲突、提交带Credit的Commit及感谢评论。
需要合并单个社区贡献到发布分支
需保留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等处置建议，辅助维护者进行发布前的贡献筛选与决策。
维护者询问PR队列状态或可合并项
发布前扫描社区贡献以并入活跃分支
需要对每个PR进行基于证据的合并性评估
npx skills add Hmbown/CodeWhale --skill gh-find-prs -g -y
自动化筛选GitHub仓库中低风险高价值的社区PR和Issue，通过代码审查和合并测试生成优先级行动列表及贡献者致谢计划。
发布前需快速清理积压的社区PR或Issue
需要优先处理低风险高价值任务以提高效率
npx skills add Hmbown/CodeWhale --skill gh-treasure-hunt -g -y
文档处理技能的兼容性别名，实际调用 docx 技能。用于加载和遵循 docx 的工作流程规范，建议优先直接使用 docx 技能。
需要处理 Word 文档
兼容旧版文档操作
npx skills add Hmbown/CodeWhale --skill documents -g -y
这是一个兼容性别名，用于指向 pptx skill。当需要处理演示文稿相关任务时，应加载并遵循 pptx skill 的实际工作流程，而非直接使用本别名。
用户请求创建或编辑 PPTX 文件
用户提及 presentations 且需生成幻灯片内容
npx skills add Hmbown/CodeWhale --skill presentations -g -y
此技能为 xlsx 技能的兼容性别名，旨在提供向后兼容支持。实际工作流需加载并遵循 xlsx 技能规范，建议优先直接使用 xlsx 技能。
用户尝试使用 spreadsheets 相关指令时
npx skills add Hmbown/CodeWhale --skill spreadsheets -g -y
