Agent Skills
› withcoral/coral
withcoral/coral
GitHub根据用户指定的上游服务名称，研究其 API 文档、认证方式及输入参数，编写符合 Reef 规范的 Provider Recipe YAML 文件，以支持自动填充 Provider 设置。
Install All Skills
npx skills add withcoral/coral --all -g -y
Skills in Collection (32)
根据用户指定的上游服务名称，研究其 API 文档、认证方式及输入参数，编写符合 Reef 规范的 Provider Recipe YAML 文件，以支持自动填充 Provider 设置。
用户要求为特定服务创建或更新 Provider Recipe
需要研究上游服务的 API 来源和认证机制
npx skills add withcoral/coral --skill add-recipe -g -y
智能路由助手，根据需求推荐仓库中的技能或流程。涵盖从创意到交付的主流程，支持原型验证、多会话构建及TDD开发，通过协调不同技能路径优化工作流。
不确定使用哪个技能
需要规划开发流程
查询技能适用场景
npx skills add withcoral/coral --skill ask-matt -g -y
用于代码审查的Skill，从标准和规范两个维度并行审查自固定点以来的变更。支持指定提交、分支或标签，自动识别相关规范和编码标准，评估代码质量与需求匹配度。
用户要求审查特定分支或PR
用户请求审查自某次提交以来的变更
npx skills add withcoral/coral --skill code-review -g -y
提供深模块设计的共享词汇与原则，用于指导接口设计、代码重构及提升可测试性。通过定义模块、接口、实现等术语，帮助开发者识别深化机会，优化代码结构，增强调用杠杆与维护本地性。
设计或改进模块接口
寻找代码深化机会
决定代码接缝位置
使代码更具可测试性或AI可导航性
npx skills add withcoral/coral --skill codebase-design -g -y
用于诊断复杂 Bug 和性能回归的系统化技能。核心在于构建快速、确定性的反馈循环，通过测试、脚本或回放等手段隔离问题，从而高效定位根本原因。
用户请求诊断或调试
报告系统出错、崩溃、失败或变慢
npx skills add withcoral/coral --skill diagnosing-bugs -g -y
构建和精炼项目领域模型，通过挑战术语、澄清模糊语言、讨论具体场景及交叉引用代码来确保一致性，并同步更新 GLOSSARY.md 和 ADR。
讨论代码库术语时
编写或编辑 GLOSSARY.md 时
记录或编辑 ADR 时
npx skills add withcoral/coral --skill domain-modeling -g -y
通过持续追问和构建决策树，对用户计划或想法进行压力测试。按轮次提问并推荐答案，自动查找事实，直至达成共同理解。
用户希望压力测试其思考
使用 'grill' 相关触发词
npx skills add withcoral/coral --skill grilling -g -y
将当前对话压缩为交接文档，保存至系统临时目录。供新代理继续工作，包含建议技能列表、引用路径及敏感信息脱敏。
需要暂停当前任务并移交上下文
生成会话摘要以供后续代理使用
npx skills add withcoral/coral --skill handoff -g -y
根据规格说明和工单图，协调多个子代理在集成分支上并行实现功能。通过探索、编码、合并及代码审查流程，最终完成所有任务并生成PR或关闭工单。
用户要求根据规格说明实现功能
存在关联的工单列表需要编码实现
npx skills add withcoral/coral --skill implement-spec -g -y
根据需求规范或工单实施功能开发，支持自动获取工单、TDD测试、类型检查及最终代码审查，确保代码质量并执行提交。
需要根据规格说明实现新功能
需要基于工单进行编码开发
npx skills add withcoral/coral --skill implement -g -y
扫描代码库以识别架构优化机会，通过可视化HTML报告展示重构建议，旨在提升模块测试性和AI导航能力。
用户希望改善代码库架构
需要生成代码架构审查报告
npx skills add withcoral/coral --skill improve-codebase-architecture -g -y
用于构建一次性原型以验证设计假设。根据问题类型分为逻辑（状态机）和UI分支，快速生成可运行代码或HTML文件，无需持久化与测试，旨在低成本探索方案并记录决策。
验证状态模型或逻辑是否合理
探索UI界面设计方案
npx skills add withcoral/coral --skill prototype -g -y
启动后台代理，针对官方文档、源码等一手权威来源进行深度调研，并将结论与引用整理为 Markdown 文件存入仓库。适用于需要收集 API 事实或委托背景研究任务的场景。
用户希望深入研究某个技术主题
需要收集官方文档或 API 事实
委托后台代理进行资料搜集
npx skills add withcoral/coral --skill research -g -y
通过伪代码、调用树、组件树、Mermaid图及HTML文件，以可视化方式辅助用户理解技术逻辑、架构或变更。
需要可视化解释算法或逻辑
展示UI结构或组件关系
演示系统交互流程
对比代码或文件变更差异
npx skills add withcoral/coral --skill show-me -g -y
提供测试驱动开发（TDD）规范，指导红绿重构循环。定义优质测试标准、接缝选择及反模式，强调通过公共接口验证行为，确保测试具备可维护性并符合项目领域语言。
用户希望以测试优先方式构建功能或修复bug
提及red-green-refactor流程
需要编写集成测试
npx skills add withcoral/coral --skill tdd -g -y
提供多会话状态化教学服务，通过管理课程、资源和学习记录，帮助用户系统性地掌握新技能或概念。
用户请求学习新技能
用户希望系统性掌握某个概念
npx skills add withcoral/coral --skill teach -g -y
根据Issue创建基准测试技能，通过对比主分支与指定分支的编码Agent表现，评估问题行为是否改善。
需要为特定Issue创建自动化基准测试
需要评估代码变更对Agent行为的影响
npx skills add withcoral/coral --skill to-benchmark -g -y
将用户无法独立决策的场景转化为结构化问卷，通过访谈确定接收者背景及所需信息，生成Markdown文档以高效收集关键知识。
需要向他人收集特定信息或决策依据
用户面临无法独自解决的决策难题
npx skills add withcoral/coral --skill to-questionnaire -g -y
将对话上下文和代码库理解综合为规范文档，并自动发布至项目问题追踪器。该技能无需额外访谈，直接基于已有信息生成包含问题陈述、用户故事及测试策略的完整规范。
需要基于当前讨论生成功能规范
需要将设计决策整理并发布到Issue追踪系统
npx skills add withcoral/coral --skill to-spec -g -y
将计划、规范或对话拆解为可追踪的垂直切片工单，定义阻塞依赖并支持发布到跟踪器。
用户要求将需求拆分为任务
根据规范生成工单列表
npx skills add withcoral/coral --skill to-tickets -g -y
用于项目问题追踪的状态机管理，自动分类、验证并撰写Agent就绪简报。通过状态流转处理Issue和PR，支持查询待办事项及角色映射，提升工单处理效率。
需要整理或分类Issue/PR
查询待处理或未标记的问题
将Issue/PR移动到特定状态
生成Agent可用的任务简报
npx skills add withcoral/coral --skill triage -g -y
该技能用于在沟通出现误解或上下文缺失时，要求对方使用简化技术英语（ASD-STE100）和领域通用语言重新阐述观点，以确保理解一致。
对话中出现理解偏差
需要澄清上下文
npx skills add withcoral/coral --skill wait-what -g -y
用于规划超出单次会话的大规模任务，通过创建共享地图和决策票来逐步明确路径，产出决策而非执行交付物。
需要规划大规模复杂任务
工作流模糊需逐步澄清
npx skills add withcoral/coral --skill wayfinder -g -y
生成交互式Bash向导脚本，引导人类完成基础设施配置、凭证设置或一次性迁移等需人工介入的步骤。通过模板化流程实现分步指引、值捕获与环境变量写入，适用于AI无法自动执行的手动操作场景。
需要人工介入配置第三方服务或Dashboard
设置CI/CD密钥或敏感凭证
执行一次性数据迁移或服务割接
npx skills add withcoral/coral --skill wizard -g -y
提供面向 Agent 的文档写作规范，涵盖 SKILL、AGENTS.md 等文件的结构、上下文指针优化及信息层级管理，旨在提升 Agent 对指令的理解与执行效率。
编写或修改 Agent 技能文件
编辑 AGENTS.md 或 CLAUDE.md
优化 Agent 上下文指针
npx skills add withcoral/coral --skill writing-for-agents -g -y
用于创建或更新Coral数据源的YAML规范文件，支持自定义HTTP API和本地数据集。涵盖从编写、Lint检查到添加和测试的完整工作流，确保源可查询且结构正确。
需要为自定义API或本地数据集创建Coral源规范
修复或验证现有的Coral源YAML配置
npx skills add withcoral/coral --skill coral-create-source-spec -g -y
用于审查 Coral 源配置、PR 及文档，确保内容、风格、产品适配性及安全性符合规范。
审查 sources/core 或 sources/community 下的新源或更新源目录
审查涉及源变更的 GitHub PR
审查 manifest.yaml 文件
npx skills add withcoral/coral --skill coral-review-source-spec -g -y
通过Coral MCP查询GitHub、Jira等外部系统实时数据，提供元数据发现与SQL查询能力，为代码修改或决策提供事实依据。
需要查询GitHub、Jira、Slack等外部系统状态
获取Datadog、Sentry等监控数据的实时上下文
npx skills add withcoral/coral --skill coral -g -y
提供撰写 PR（Pull Request）正文的标准化模板，涵盖摘要、证据、合并风险及多种可视化展示方式，用于规范代码提交说明。
需要编写PR描述时
准备代码合入请求时
npx skills add withcoral/coral --skill pr -g -y
对编码会话进行回顾，分析导航、自动化检查、编码标准等维度的改进点，优化 Agent 环境以提升未来运行效率。
用户要求对编码会话进行回顾
分析 Agent 表现以提出改进建议
npx skills add withcoral/coral --skill retro -g -y
通过高强度提问和质疑，对计划或设计方案进行深度审查与打磨，帮助发现潜在漏洞并优化设计。
需要批判性审视现有方案
计划或设计完成后寻求压力测试
npx skills add withcoral/coral --skill grill-me -g -y
通过模拟面试和领域建模，对计划或设计进行深度审查与完善，同时自动生成架构决策记录（ADR）和术语表等文档。
需要审查系统设计或开发计划
需要生成架构决策记录或项目术语表
npx skills add withcoral/coral --skill grill-with-docs -g -y
