Agent Skills
› codewhale-hq/Codewhale
codewhale-hq/Codewhale
GitHub将大型并行目标拆分为有界工作单元，协调现有代理工具执行，并集成验证结果。适用于需要协调子任务的复杂并行工作，不创建新编排引擎或发布部署。
Install All Skills
npx skills add codewhale-hq/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 codewhale-hq/Codewhale --skill batch -g -y
用于高价值或模糊任务的多方案并行生成与择优评估。通过定义明确评分标准，独立生成多个候选方案并隔离验证，最终由评审者依据证据选出最优解，适用于设计、实现及调试等复杂场景。
需要对比多种解决方案的复杂任务
高 stakes 的设计或调试决策
存在多个合理路径且需择优的场景
npx skills add codewhale-hq/Codewhale --skill best-of-n -g -y
协助新贡献者快速上手，检查仓库同步状态、执行构建及CI验证门禁，并生成变更摘要。全程只读不修改工作区，确保操作安全透明。
新克隆仓库后的首次运行检查
需要确认本地代码与主分支同步状态
需要验证本地构建和测试是否通过
npx skills add codewhale-hq/Codewhale --skill contributor-onboarding -g -y
根据数据生成图表、仪表盘或可视化解释，确保编码清晰并附带来源说明。
需要生成数据图表
需要制作数据仪表盘
需要可视化数据解释
npx skills add codewhale-hq/Codewhale --skill dataviz -g -y
用于处理故障、崩溃及回归问题。遵循复现、最小化、定位根因的流程，区分症状与根本原因，仅在授权时修复，否则提供诊断证据。
程序崩溃或异常退出
输出结果错误或不一致
间歇性测试失败 (Flakes)
功能回归问题
npx skills add codewhale-hq/Codewhale --skill debug -g -y
指导在复杂任务中通过子代理并行执行聚焦工作，父代理保留架构与验证职责。涵盖启动、路由及模型选择策略。
需要并行处理多个独立子任务
将机械性编辑或探索性工作委派给子代理
npx skills add codewhale-hq/Codewhale --skill delegate -g -y
根据明确指定的依赖范围，读取更新日志，应用版本升级并修复破坏性变更，最后通过测试或构建验证。禁止自动全量更新或发布操作。
需要手动更新特定依赖包
处理依赖升级中的兼容性问题
验证依赖更新后的项目构建状态
npx skills add codewhale-hq/Codewhale --skill dependency-update -g -y
用于创建、编辑和检查Word文档（.docx）的技能，支持备忘录、报告等格式，利用python-docx或pandoc工具处理文件。
需要生成Word文档
编辑现有Word文件
npx skills add codewhale-hq/Codewhale --skill docx -g -y
提供飞书/ Lark 集成工作指南，涵盖机器人、文档、表格及审批流开发。强调安全使用环境变量管理凭证，避免硬编码，并指导 MCP 服务器配置与验证流程。
需要集成飞书或Lark功能
询问飞书API调用方法
配置飞书MCP服务器
npx skills add codewhale-hq/Codewhale --skill feishu -g -y
用于管理Codewhale集群运行和Worker的Agent技能。通过状态分类、证据审查和安全操作（如重启或升级）来调度任务，确保符合权限边界并记录结果。
需要查看或管理Codewhale集群运行状态
需要检查、重启或升级特定的Worker实例
需要处理集群运行的故障排查与升级
npx skills add codewhale-hq/Codewhale --skill fleet-manager -g -y
指导用户通过 Context Lens 控件删除已存储的事实或记忆。明确工具限制，禁止伪造删除操作，指引用户在界面上执行遗忘动作并确认结果。
用户要求忘记或删除某条记忆
用户请求移除存储的事实
npx skills add codewhale-hq/Codewhale --skill forget -g -y
用于构建有意设计、响应式且无障碍的前端 UI，执行视觉质量检查而非通用组件组装。涵盖受众分析、布局设计及实现流程。
需要创建符合无障碍标准的响应式界面
进行前端视觉质量验收
npx skills add codewhale-hq/Codewhale --skill frontend-design -g -y
提供 Gmail 邮件搜索、阅读、草稿撰写及发送能力。指导 API 配置与 OAuth 认证，强调最小权限原则和安全规范，如不执行附件、谨慎重试发送，确保用户授权明确。
用户要求搜索或读取电子邮件
用户要求撰写或发送邮件
npx skills add codewhale-hq/Codewhale --skill gmail -g -y
提供Google Calendar事件的读取、可用性检查及创建更新功能，指导OAuth配置与API调用细节。
查询日程安排
检查时间可用性
创建日历事件
更新日历事件
npx skills add codewhale-hq/Codewhale --skill google-calendar -g -y
用于在会话结束或上下文丢失前，通过收集Git、PR及CI等状态信息，生成紧凑的Markdown交接文档，确保后续会话能无缝继续而不需重建上下文。
用户请求交接（如handoff, pass the baton）
会话即将结束或上下文不足
长运行操作需要持久化状态检查点
npx skills add codewhale-hq/Codewhale --skill handoff -g -y
用于引导用户查询 Codewhale 自身使用方法的技能。作为路由器，根据问题类型将请求分发至命令、配置、快捷键或医生工具等官方表面，禁止凭记忆回答或输出手册内容。
询问如何安装或使用 Codewhale
查找特定命令、设置或快捷键
排查环境配置问题
npx skills add codewhale-hq/Codewhale --skill help -g -y
用于执行已授权或批准的计划，进行范围受限的代码实现与比例验证。强调最小化变更集、运行针对性验证并报告结果，防止越权操作和跳过验证。
用户请求实施明确的功能需求
根据批准的计划执行代码修改
需要小范围且连贯的代码变更
npx skills add codewhale-hq/Codewhale --skill implement -g -y
当需求缺失关键产品或实现决策且无法通过工具获取时，通过单次结构化提问引导用户确认，记录答案并生成简要规范。
需求缺少关键决策信息
无法通过现有工具或工作区发现事实
npx skills add codewhale-hq/Codewhale --skill interview -g -y
用于设计、构建、配置或调试 Model Context Protocol (MCP) 服务器及工具集成。涵盖传输协议选择、凭证处理、SDK 实现及验证测试，确保结构化 JSON 输出与安全配置。
创建 MCP 服务器
配置 MCP 集成
调试 MCP 工具
npx skills add codewhale-hq/Codewhale --skill mcp-builder -g -y
当本地工具无法完成任务时，用于发现、安装并启动公共MCP注册表中的服务器以补充缺失能力的回退技能。
本地工具和脚本无法满足任务需求
需要访问外部服务或数据库但当前会话无权限
npx skills add codewhale-hq/Codewhale --skill mcp-discovery -g -y
处理PDF文件的技能，支持读取、提取、分割、合并、旋转、水印、表单填写、OCR及创建等操作。提供工具选择建议，强调保留原文档、验证输出内容及OCR准确性。
需要读取或解析PDF内容
需要对PDF进行编辑如合并、拆分或加水印
需要从扫描版PDF中提取文本
npx skills add codewhale-hq/Codewhale --skill pdf -g -y
在 macOS 上通过 osxphotos CLI 搜索本地照片库并导出选定副本，支持按相册或日期过滤，严格遵循只读查询与指定路径导出规则。
用户需要查找本地照片库中的特定图片
用户请求将照片导出到指定位置
npx skills add codewhale-hq/Codewhale --skill photos -g -y
将已明确的任务转化为包含依赖关系和验证步骤的有序实施计划，并写入系统原生状态。
任务理解充分但无单一明显下一步操作
需要制定分步实施策略
npx skills add codewhale-hq/Codewhale --skill plan -g -y
用于生成 Codewhale 本地插件包，包含版本化清单、命名空间技能及安全信任审查流程。
创建新的 Codewhale 插件
生成插件清单和目录结构
npx skills add codewhale-hq/Codewhale --skill plugin-creator -g -y
用于创建、编辑、检查和验证 PowerPoint (.pptx) 演示文稿的技能。提供简单的布局系统选择、幻灯片密度优化及最终内容核验的工作流，确保演示文档的质量与一致性。
需要制作或修改PPT演示文稿
检查现有PPT文件的结构和内容
npx skills add codewhale-hq/Codewhale --skill pptx -g -y
用于通过外部工具进行事实核查、文档查阅及信息综合的 Skill。强调使用一手来源，注意日期和版本，区分事实与推断，并列出未决问题。
需要查询官方发布说明或文档
查找先验技术或生态系统变化
验证外部事实数据
npx skills add codewhale-hq/Codewhale --skill research -g -y
模拟资深开发者对PR或代码变更进行深度审查，聚焦正确性、数据完整性、安全边界及并发问题。通过上下文分析提供带置信度的严重性分级发现与合并风险评估，不包含风格检查或代码编辑。
收到PR或Diff审查请求
需要评估代码变更的合并风险
npx skills add codewhale-hq/Codewhale --skill review -g -y
针对代码变更、模块或接口进行安全审查，识别信任边界、认证授权、注入漏洞、密钥泄露及依赖风险。通过追踪数据流验证可攻击路径，提供具体文件行号、修复建议及审计清单，确保发现具备可验证性。
用户请求对具体代码进行安全审查
需要检查模块或接口的漏洞
npx skills add codewhale-hq/Codewhale --skill security-review -g -y
在理解代码行为后，通过小步验证保持功能不变的前提下降低复杂度，提升清晰度。严禁删除安全检查或混合行为变更重构，确保清理与正确性修复分离。
用户要求简化代码结构
代码已稳定但存在冗余复杂性
需要进行非破坏性的代码清理
npx skills add codewhale-hq/Codewhale --skill simplify -g -y
用于创建或优化 Codewhale 技能，指导用户定义技能边界、选择合适载体（如 MCP 或插件），并编写符合规范的 SKILL.md 文件及工作流。
用户需要创建新的 Codewhale 技能
用户希望更新现有技能结构
咨询技能与 MCP/插件的选型建议
npx skills add codewhale-hq/Codewhale --skill skill-creator -g -y
用于管理 Codewhale 技能的生命周期，包括查找、安装、更新、信任及移除技能。支持从 GitHub 或本地文件夹安装，并提供命令列表、激活和脚手架生成功能。
用户询问可用技能
用户请求安装社区技能
用户需要更新或移除已安装的技能
npx skills add codewhale-hq/Codewhale --skill skill-installer -g -y
用于检测项目测试栈、运行针对性测试、在授权下创建或改进测试，并诚实报告覆盖率与缺口。
用户要求运行现有测试
用户希望添加新测试
用户希望改进或补充测试用例
npx skills add codewhale-hq/Codewhale --skill test -g -y
针对 DeepSeek V4 思考模式的多步骤任务最佳实践，通过验证引用、启用验证子代理及规范路径输出，防止幻觉和编辑失败。
使用 deepseek-v4-pro 或 v4-flash 进行多步骤规划
执行涉及多个文件的复杂代码修改计划
npx skills add codewhale-hq/Codewhale --skill v4-best-practices -g -y
对真实应用、API或CLI进行端到端验证，通过执行并捕获输出、日志等证据来证明功能正常，而非仅依赖单元测试。
需要验证真实环境下的功能表现
要求提供可观测的端到端测试证据
npx skills add codewhale-hq/Codewhale --skill verify -g -y
用于在真实浏览器环境中验证 Web 应用流程。通过启动本地应用、等待就绪、检查 DOM/控制台/网络状态，并基于观察到的选择器驱动操作，最终记录通过或失败的证据以证明功能正常。
需要验证 Web 应用前端交互流程
需要在真实浏览器上下文中进行端到端测试
需要检查页面渲染状态和网络请求
npx skills add codewhale-hq/Codewhale --skill webapp-testing -g -y
用于创建、编辑、分析和验证电子表格工作簿，支持XLSX/CSV/TSX格式，处理表格数据、公式和图表。
需要处理Excel或CSV文件
进行表格数据分析或公式计算
npx skills add codewhale-hq/Codewhale --skill xlsx -g -y
用于在发布前执行自动化门控扫描和手动QA目标验证，确保代码质量与功能正常。
准备合并PR到发布分支前
验证候选版本完成度
npx skills add codewhale-hq/Codewhale --skill codew-release-qa-sweep -g -y
辅助新贡献者安全检查仓库状态，验证构建与CI门禁，生成更新摘要。全程只读，不自动修改工作区或执行网络操作，确保本地环境就绪。
新克隆仓库后的首次运行检查
确认本地分支与主分支同步状态
验证代码能否通过构建和测试门禁
npx skills add codewhale-hq/Codewhale --skill contributor-onboarding -g -y
用于在本地构建并安装已标记的二进制文件，通过原子替换和全新Shell验证确保用户可见功能在运行时正确，覆盖单元测试无法触及的UI、流式处理和审批流程等场景。
需要验证用户可见变更的实际运行效果
请求安装构建产物或进行本地试用
发布候选版本前的最终人工质量保证
npx skills add codewhale-hq/Codewhale --skill cw-dogfood -g -y
验证代码变更是否合规且可发布的检查流程，涵盖格式化、编译测试及CI预算规则，确保改动安全。
确认代码完成或准备合并前
执行dogfood构建前
需要证明变更安全性时
npx skills add codewhale-hq/Codewhale --skill cw-gates -g -y
用于生成Agent会话交接文档的Skill，指导如何编写包含当前状态、未完成工作及验证信息的提示词，确保后续Agent能准确继承上下文并继续工作。
需要为其他Agent或后续会话编写交接说明时
结束进行中工作的会话总结
npx skills add codewhale-hq/Codewhale --skill cw-handoff -g -y
用于将已验证的代码变更安全地合并到主分支。执行窄化提交、推送前漂移检查以维持构建绿色，并保留贡献者署名。适用于直接推送到main或合并PR的场景。
将已验证的变更提交并推送到 main 分支
合并贡献者的 PR 或解决因 main 移动导致的冲突
npx skills add codewhale-hq/Codewhale --skill cw-land -g -y
在 Codewhale 会话开始时建立仓库真实状态，验证工作树、分支及版本信息，防止因多工作树导致编辑错误。
开始新会话或恢复会话
接手他人工作或不确定当前检出状态
准备编辑文件前需确认归属
npx skills add codewhale-hq/Codewhale --skill cw-orient -g -y
在编写代码前查找并复用已有实现，避免重复造轮子。通过搜索现有模块、检查契约约束，将变更限制在可审查的范围内，确保编辑正确文件而非创建新层。
开发新功能前确认是否已存在类似实现
进行重构或升级时定位已有行为所有者
准备创建新模块、配置结构体或命令前
npx skills add codewhale-hq/Codewhale --skill cw-slice -g -y
用于批量将 GitHub Issue 分配至里程碑或指定负责人。通过 CLI 验证 Issue 状态与标题，执行重定向并核对计数，确保数据准确且无冗余评论。
需要将一组 Issue 批量归入特定版本里程碑
需要批量指派 Issue 给特定维护者
里程碑名称变更需重新关联 Issue
npx skills add codewhale-hq/Codewhale --skill gh-assign-issues -g -y
用于在GitHub上关闭已修复的Issue。需通过Git日志和代码验证修复是否真实落地，引用具体提交SHA或文件路径，并致谢报告者后关闭，严禁仅凭标题或PR猜测关闭。
确认Issue对应的修复Commit已合并至主分支或发布分支
批量清理里程碑中已解决的Issue
npx skills add codewhale-hq/Codewhale --skill gh-close-issues -g -y
将GitHub Issue分类为已解决、快速修复、需设计或延期，通过读取代码和引用证据生成覆盖率矩阵报告。
需要评估Issue覆盖情况
批量处理Milestone中的Issue
npx skills add codewhale-hq/Codewhale --skill gh-compile-issues -g -y
将单个社区PR安全合并至发布分支，保留作者署名与机器可读信用，验证通过并致谢。
收到批准需合并特定社区PR
PR尚未在着陆分支上
npx skills add codewhale-hq/Codewhale --skill gh-credit-harvest -g -y
用于在Codewhale项目中创建高质量、可执行的GitHub Issue。通过收集复现证据、检查重复项、规范标题与正文结构（含验收标准）及标签，将Bug或功能建议转化为维护者可直接处理的任务。
发现软件缺陷或回归问题需要跟踪
提出新功能或产品改进想法
社区报告或PR中提及需独立跟踪的缺口
npx skills add codewhale-hq/Codewhale --skill gh-file-issue -g -y
扫描开放PR队列，基于代码和测试而非标题评估合并可行性。识别真实发布分支，分析CI检查结果与差异，测试实际合并冲突，为每个PR提供直接合并、 Harvest、延期或关闭建议，辅助维护者决策。
维护者询问PR队列状态或可合并项
发布前梳理社区贡献
需要对PR进行合并性评估和处置建议
npx skills add codewhale-hq/Codewhale --skill gh-find-prs -g -y
