Agent Skills
› Hmbown/Codewhale
Hmbown/Codewhale
GitHub将大型可并行目标分解为有界工作单元，协调现有代理和分支工具执行，并集成验证结果。明确触发，不创建新编排引擎或发布部署。
Install All Skills
npx skills add Hmbown/Codewhale --all -g -y
Skills in Collection (54)
Showing top 50 of 54 by quality score. Use the install list command or open individual skills for the rest.
将大型可并行目标分解为有界工作单元，协调现有代理和分支工具执行，并集成验证结果。明确触发，不创建新编排引擎或发布部署。
需要协调多个子任务的大型并行目标
需要将大任务拆分为独立工作单元的场景
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
用于复现、最小化、定位故障并识别根本原因的调试技能。适用于失败、回归和崩溃场景，强调先诊断后修复，输出症状、复现步骤及根因分析。
程序出现崩溃或异常退出
测试结果不稳定或存在 Flake
输出结果与预期不符
发现功能回归问题
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工具处理文件，优先保留原件并在请求时进行就地编辑，最后通过重新打开和提取文本来验证结果。
需要生成或修改Word文档
从Word文档中提取文本内容
npx skills add Hmbown/Codewhale --skill docx -g -y
提供飞书/Lark集成指南，涵盖Bot、文档、表格及审批流开发。强调安全使用凭证，支持OpenAPI与MCP服务器配置，确保调用规范与安全验证。
用户请求飞书或Lark集成
需要配置飞书机器人或工作流
npx skills add Hmbown/Codewhale --skill feishu -g -y
用于管理Codewhale集群运行，通过分类Worker状态选择安全操作（重启或升级），遵循权限边界与证据审查流程。
需要管理或监控集群任务运行时
处理Worker故障、重试或升级决策
npx skills add Hmbown/Codewhale --skill fleet-manager -g -y
指导用户通过 Context Lens 控件移除已存储的事实记忆。明确禁止伪造删除操作或直接编辑文件，需引导用户在界面执行遗忘动作并验证结果。
用户要求忘记或删除某条记忆
用户希望清理上下文中的特定事实
npx skills add Hmbown/Codewhale --skill forget -g -y
专注于构建有意设计、响应式且无障碍的 UI 工作，并进行视觉质量保障，而非组装通用组件。强调受众澄清、层级设计及可视化验收。
需要实现符合设计规范的前端界面
执行前端 UI 的视觉质量检查
npx skills add Hmbown/Codewhale --skill frontend-design -g -y
管理Gmail邮件的技能，支持搜索、阅读、起草和发送邮件。指导API调用、OAuth权限管理及安全操作规范，如不随意删除或执行附件。
用户需要搜索邮箱内容
用户要求撰写或发送电子邮件
npx skills add Hmbown/Codewhale --skill gmail -g -y
管理Google日历技能，支持读取日程、检查可用性及创建或更新事件。涵盖OAuth配置、API调用及权限控制。
查询日历日程
检查时间可用性
创建日历事件
更新日历事件
npx skills add Hmbown/Codewhale --skill google-calendar -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
用于设计、构建、配置和调试 Model Context Protocol (MCP) 服务器及工具集成。指导选择传输协议、处理凭证、实现服务边界，并通过 Codewhale 命令进行初始化、验证和测试，确保结构化 JSON 输出与错误处理。
创建 MCP 服务器
配置 MCP 工具集成
调试 MCP 连接或传输问题
npx skills add Hmbown/Codewhale --skill mcp-builder -g -y
在会话缺失能力且本地工具无法解决时，通过 MCP Registry 搜索、安装并启动外部 stdio 服务器以扩展功能。作为最后手段的 fallback 机制，用于获取数据库、API 或协议客户端等外部服务支持。
本地工具和脚本无法满足任务需求
需要访问当前会话无权限的外部服务或协议
npx skills add Hmbown/Codewhale --skill mcp-discovery -g -y
处理PDF文件的读写、提取、拆分、合并、OCR及创建等操作，指导选择可靠工具并验证结果准确性。
需要读取或解析PDF内容
执行PDF文件编辑或转换任务
npx skills add Hmbown/Codewhale --skill pdf -g -y
在 macOS 上通过 osxphotos CLI 搜索本地照片库，根据用户意图查询并导出指定照片。支持按相册、日期等条件筛选，确保不修改原始库，仅返回匹配结果或导出副本。
查找特定时间或相册的照片
导出选定的本地图片
npx skills add Hmbown/Codewhale --skill photos -g -y
将已理解的任务转化为带依赖关系和验证步骤的有序实施计划，并写入系统原生状态，等待授权后执行。
任务目标明确但需拆解步骤
需要制定实施路线图
npx skills add Hmbown/Codewhale --skill plan -g -y
用于快速生成 Codewhale 本地插件包骨架，包含版本化清单、命名空间技能及信任审查流程。指导用户创建 plugin.toml，配置技能、命令、代理等组件，并执行验证与信任激活步骤，确保插件安全合规地集成到系统中。
需要创建新的 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
执行代码变更的 correctness review，分析调用方、契约及不变量，定位正确性、数据完整性及安全边界问题。输出行锚定发现、置信度评估及合并风险结论，用于 PR 审查而非风格检查或自动批准。
审查 Pull Request 或 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 技能，提供技能定义、结构规范、编写规则及创建流程，帮助判断何时使用技能而非 MCP 或插件。
需要创建新的 Codewhale 技能
想要更新现有技能内容
咨询技能与 MCP/工具/插件的选型建议
npx skills add Hmbown/Codewhale --skill skill-creator -g -y
管理Codewhale技能，支持查找、安装、更新、信任及移除社区或本地技能。提供标准化命令用于技能生命周期管理，确保在安装前审查内容并处理冲突。
用户询问可用技能列表
用户请求安装新技能
用户需要更新或移除已安装的技能
npx skills add Hmbown/Codewhale --skill skill-installer -g -y
该技能用于检测项目测试框架，运行最小必要测试集，在授权下创建或更新测试，并诚实报告覆盖率与缺口。旨在规范测试执行流程，确保测试有效性。
用户希望运行测试
用户希望添加或改进测试
npx skills add Hmbown/Codewhale --skill test -g -y
规范 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应用流程
验证UI交互和渲染状态
npx skills add Hmbown/Codewhale --skill webapp-testing -g -y
用于创建、编辑、分析和验证电子表格工作簿（包括XLSX/CSV/TS格式），支持表格数据处理、公式计算及图表生成，强调结构化表头与结果核验。
需要处理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
为新贡献者提供仓库上手路径，检查同步状态、执行构建与CI验证门禁，并生成变更摘要。全程只读或仅建议操作，不自动修改工作区，确保环境安全可控。
新克隆仓库的初始化检查
确认本地分支与主分支同步状态
验证代码能否通过CI门禁
npx skills add Hmbown/Codewhale --skill contributor-onboarding -g -y
用于验证用户可见变更的运行时行为，通过构建带版本戳的二进制、原子安装及在独立Shell中执行手动QA，覆盖单元测试无法触及的流媒体、路由隔离等问题。
需要验证TUI布局、流式传输或模型选择等用户可见变更
在发布候选前验证运行时行为修复
用户要求安装本地构建版本或进行Dogfood测试
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
在编码前查找现有行为归属，将变更限制为单一可审查切片，避免重复实现。通过搜索预存在模块并遵循契约规范进行编辑。
编写新功能代码前
重构或升级现有功能时
计划创建新模块、trait或配置结构体时
npx skills add Hmbown/Codewhale --skill cw-slice -g -y
批量将 GitHub Issue 分配给里程碑或负责人，通过 gh CLI 执行。包含预检（过滤 PR/关闭项）、精确匹配标题、逐条应用变更及结果验证，确保操作安全准确。
需要将多个 Issue 归入特定发布里程碑
需要批量指派 Issue 给特定负责人
里程碑重命名后需重新关联 Issue
npx skills add Hmbown/Codewhale --skill gh-assign-issues -g -y
验证GitHub Issue修复后关闭，通过Git日志和代码比对确认修复已合并，并致谢报告者。
Issue已修复需关闭
PR合并后关联Issue处理
npx skills add Hmbown/Codewhale --skill gh-close-issues -g -y
将GitHub Issue归类为覆盖矩阵，通过读取代码判断是否已解决，并分类为已完成、快速修复、需设计或延期，生成带证据的报告。
需要评估Issue覆盖情况
批量处理Milestone中的Issue
npx skills add Hmbown/Codewhale --skill gh-compile-issues -g -y
将社区PR合入发布分支，保留作者署名并验证通过，随后致谢贡献者。
需要合入特定社区PR
需保留代码贡献者署名
npx skills add Hmbown/Codewhale --skill gh-credit-harvest -g -y
用于在Codewale项目中创建高质量、可执行的GitHub Issue。通过收集证据、检查重复项、撰写结构化描述及选择标签，确保Issue具备可验证性和行动指引，提升维护效率。
发现软件缺陷或回归错误
提出新功能或产品改进建议
社区反馈或PR中暴露需独立追踪的问题
npx skills add Hmbown/Codewhale --skill gh-file-issue -g -y
用于审查开源仓库中待合并的PR，通过代码、测试和CI状态评估其针对实际发布分支的可合并性，并给出直接合并、收割或推迟等处置建议。
维护者询问PR队列状态
发布前社区贡献整理
需要PR可合并性评估
npx skills add Hmbown/Codewhale --skill gh-find-prs -g -y
