Agent Skills
› trycompai/comp
trycompai/comp
GitHub审计并修复代码中设计系统的使用规范，将旧版 @trycompai/ui 和 lucide-react 迁移至统一的 @trycompai/design-system，确保组件与图标合规。
Install All Skills
npx skills add trycompai/comp --all -g -y
Skills in Collection (52)
Showing top 50 of 52 by quality score. Use the install list command or open individual skills for the rest.
审计并修复代码中设计系统的使用规范，将旧版 @trycompai/ui 和 lucide-react 迁移至统一的 @trycompai/design-system，确保组件与图标合规。
需要将旧UI库迁移到新的设计系统
检查代码是否符合设计系统规范
npx skills add trycompai/comp --skill audit-design-system -g -y
审计并修复前端代码中的 Hook 和 API 使用违规，将 server actions、raw fetch 等旧模式替换为 SWR 和 apiClient，确保数据获取与缓存失效合规。
代码审查发现 hook 或 API 使用不规范
需要重构客户端数据获取和突变逻辑
npx skills add trycompai/comp --skill audit-hooks -g -y
审计并修复API端点和前端组件中的RBAC及审计日志合规性问题，自动添加权限控制、守卫及路由保护，确保符合安全规范。
检查代码中的RBAC合规性
修复缺失的权限验证逻辑
npx skills add trycompai/comp --skill audit-rbac -g -y
审计并修复权限控制组件的单元测试，确保覆盖管理员和审核员场景，补全缺失测试并解决失败用例。
需要检查或补充权限组件的单元测试
发现权限相关组件缺少测试用例
运行权限组件测试出现失败
npx skills add trycompai/comp --skill audit-tests -g -y
提供 Better Auth 的集成指南，涵盖服务器与客户端配置、数据库适配器设置、会话管理及插件处理。适用于需要搭建 TypeScript 身份验证（含邮箱/密码或 OAuth）及环境变量管理的场景。
用户提及 Better Auth 或 betterauth
需要设置 TypeScript 身份验证
配置 email/password 或 OAuth
管理会话和数据库适配器
npx skills add trycompai/comp --skill better-auth-best-practices -g -y
用于管理Comp AI计费系统，包括Stripe产品、订阅、支付及权限控制。涉及SKU定义、账单处理、Webhook事件响应及审计日志，确保数据一致性与幂等性。
修改Stripe产品价格或产品配置
处理订阅结账与支付方法变更
更新组织权限或使用量账本
配置或调试计费相关的Webhook
npx skills add trycompai/comp --skill billing -g -y
提供 TypeScript 和 React 编码规范，涵盖类型安全、组件模式、文件组织及代码质量最佳实践，指导开发者编写高质量前端代码。
编写 TypeScript 或 React 代码
遵循前端代码风格指南
重构现有前端组件
npx skills add trycompai/comp --skill code -g -y
指导如何编写和管理 Cursor AI 规则文件，包括结构定义、自动应用与手动调用机制，以及保持代码一致性的最佳实践。
用户询问如何配置或创建 Cursor 规则
需要统一项目 AI 行为以维持代码规范
npx skills add trycompai/comp --skill cursor-usage -g -y
规范 Next.js 数据获取模式，定义服务端页面预取、客户端组件接收初始数据及 SWR Hook 缓存更新的核心流程。提供 API 客户端使用指南，明确服务器与客户端组件的职责划分，并规定状态管理需遵循 React 标准而非 nuqs。
实现数据获取逻辑
调用 API 接口
开发服务端或客户端组件
编写 SWR 数据钩子
npx skills add trycompai/comp --skill data -g -y
用于诊断 SDK 生成失败的根本原因，分析错误输出并制定修复策略。通过分类问题类型（如覆盖层修复、规范修正或用户决策），提供具体的解决步骤和工具使用建议，帮助用户恢复 SDK 构建。
SDK generation failed
speakeasy run failed
SDK build error
workflow failed
Step Failed
why did generation fail
npx skills add trycompai/comp --skill diagnose-generation-failure -g -y
规定前端表单开发必须使用 React Hook Form 结合 Zod 进行类型推断与数据校验，涵盖基础模式、复杂组件控制及状态管理。
构建或修改前端表单
需要实现输入验证逻辑
npx skills add trycompai/comp --skill forms -g -y
基于 Speakeasy CLI，将 OpenAPI 规范自动生成 Model Context Protocol (MCP) TypeScript 服务器。支持为 AI 助手（如 Claude）提供 API 工具调用、身份验证及作用域控制，实现从 API 到 AI 工具的自动化转换。
generate MCP server
create MCP server
speakeasy MCP
How do I make my API available to Claude?
mcp-typescript
AI assistant tools
Claude tools
npx skills add trycompai/comp --skill generate-mcp-server -g -y
管理 Monorepo 基础设施，规范使用 Bun 进行包管理与依赖安装，定义项目结构与跨包导入规则，提供构建、检查及新包创建指南。
Monorepo 结构配置
Bun 包管理操作
多包依赖安装
跨包导入规范
npx skills add trycompai/comp --skill infra -g -y
用于创建、应用和验证 OpenAPI Overlay 文件，以定制 SDK 生成配置。涵盖 JSONPath 定位、x-speakeasy 扩展、重试与分页配置及语法校验，适用于手动修改 API 规范而不改动源文件。
创建 overlay 文件
应用 overlay 到 spec
验证 overlay 语法
配置重试或分页
添加 x-speakeasy 扩展
npx skills add trycompai/comp --skill manage-openapi-overlays -g -y
用于在 monorepo 中初始化新功能分支，自动创建 git worktree、隔离数据库、配置环境变量并安装依赖，快速搭建可编码的开发环境。
start a new feature
spin up a worktree
begin ticket
new branch
npx skills add trycompai/comp --skill new-feature-setup -g -y
并行执行RBAC、Hooks、设计系统及测试审计，并运行全量类型检查与单元测试，最终输出包含修复状态和构建结果的发布就绪报告。
发布前全面质量检查
验证代码库是否符合生产环境标准
npx skills add trycompai/comp --skill production-readiness -g -y
提供提示词工程最佳实践，涵盖核心原则与六大技巧，指导用户通过清晰指令、示例及思维链提升大模型交互效果。
询问如何优化提示词
需要生成高质量Prompt模板
探讨提示词设计策略
npx skills add trycompai/comp --skill prompt-engineering -g -y
规范 Speakeasy SDK 工作流，强制先执行 agent context 获取 CLI 能力，再执行任务，最后提交反馈。适用于 SDK 开发、OpenAPI 处理及 Speakeasy 工具链使用场景。
Speakeasy SDK 相关任务
OpenAPI 处理
Speakeasy 工具链使用
npx skills add trycompai/comp --skill speakeasy-context -g -y
安全清理废弃的 Git worktree 及其关联的 Postgres 数据库。通过盘点、分类（合并/未推送/活跃）并征求确认后，批量删除不再使用的开发环境资源。
clean up worktrees
delete stale worktrees
worktrees piling up
orphaned databases
remove unused worktree
npx skills add trycompai/comp --skill stale-worktree-cleanup -g -y
提供 Trigger.dev v4 高级任务编写规范，涵盖标签组织、并发队列管理及错误重试策略。用于指导开发者构建高可用、可观测的异步后台任务，优化任务执行流程与资源控制。
编写或重构 Trigger.dev 异步任务代码
配置任务并发限制与共享队列
实现任务自定义错误处理与指数退避重试逻辑
npx skills add trycompai/comp --skill trigger-advanced-tasks -g -y
定义 Trigger.dev v4 SDK 编写异步任务、定时任务及触发调用的核心规范，涵盖基础任务、带验证的 Schema 任务及批量触发逻辑。
使用 Trigger.dev SDK 开发后端异步处理逻辑
配置定时执行或事件触发的后台任务
npx skills add trycompai/comp --skill trigger-basic -g -y
配置 Trigger.dev v4 项目，通过 trigger.config.ts 设置项目引用、任务目录、运行时环境、重试策略及构建扩展（如 Prisma、Python、Playwright 等），用于自动化任务调度与执行环境的初始化。
用户需要初始化或修改 Trigger.dev 项目配置
用户询问如何添加数据库 ORM 或浏览器自动化扩展
npx skills add trycompai/comp --skill trigger-config -g -y
说明如何在 Trigger.dev 中使用实时功能，包括订阅运行状态、流式数据处理及前端集成。
需要实时监控任务执行状态
构建实时仪表盘或 UI 更新
实现前后端流式数据传输
npx skills add trycompai/comp --skill trigger-realtime -g -y
指导前端UI组件开发，强制使用指定设计系统，规范样式、布局及图标使用，强调语义化颜色和暗色模式支持。
构建或编辑前端UI组件
调整布局和样式
使用设计系统组件
npx skills add trycompai/comp --skill ui -g -y
定义 NestJS API 端点规范，确保 DTO、OpenAPI 文档与 MCP 服务器数据一致。通过强制使用类而非接口、组合 Swagger 与验证装饰器及显式声明请求体，保障运行时校验与 Agent 兼容性。
新增 API 端点
修改控制器代码
创建或编辑 DTO
涉及 @Body 参数处理
配置 MCP 工具
npx skills add trycompai/comp --skill api-endpoint-contract -g -y
审计并修复代码中的设计系统合规性问题，将遗留的 @trycompai/ui 和 lucide-react 迁移至统一的设计系统组件与图标库。
需要将旧 UI 库迁移到新的设计系统
发现代码中使用了非标准的组件或图标
npx skills add trycompai/comp --skill audit-design-system -g -y
审计并修复前端代码中的 Hook 和 API 使用模式，消除过时的服务器操作、原生 fetch 及数据获取方式，强制使用 SWR 和 apiClient。
检查文件是否符合 Hook 和 API 使用规范
修复禁止的代码模式
npx skills add trycompai/comp --skill audit-hooks -g -y
审计并修复 API 端点和前端组件中的 RBAC 及审计日志合规性问题，自动添加权限装饰器、守卫及 UI 控制逻辑。
需要检查代码权限控制合规性
发现缺少 RBAC 或审计日志实现
重构权限相关代码
npx skills add trycompai/comp --skill audit-rbac -g -y
审计并修复权限控制组件的单元测试，确保覆盖管理员只读用户场景，补全缺失测试并修复失败用例。
需要检查或编写权限相关组件的单元测试
发现权限组件缺少测试用例
单元测试因权限逻辑报错
npx skills add trycompai/comp --skill audit-tests -g -y
提供统一只读服务以复用集成检查的结果数据，避免直接查询数据库。适用于需获取2FA状态、云资源发现等集成产出的功能开发场景。
需要读取集成检查结果
展示用户合规状态
复用现有检查数据
npx skills add trycompai/comp --skill check-results-service -g -y
强制在代码修改后执行的清理技能，审查变更文件以消除冗余检查、不一致性、死代码和可读性问题，确保代码整洁并符合规范。
完成实现工作后
修复Bug后
重构代码后
提交代码前
npx skills add trycompai/comp --skill cleanup -g -y
提供 TypeScript 和 React 的开发规范，涵盖类型安全、组件模式、文件组织及代码质量要求，指导编写高质量前端代码。
编写 TypeScript/React 代码
重构前端组件结构
检查代码规范性
npx skills add trycompai/comp --skill code -g -y
指导如何编写和管理 Cursor AI 规则文件，包括文件结构、元数据配置、自动/手动触发机制及最佳实践，用于规范代码生成与一致性。
询问如何创建或修改 Cursor 规则
需要统一项目代码风格或 AI 行为指令
优化 .mdc 规则文件的结构与内容
npx skills add trycompai/comp --skill cursor-usage -g -y
规范前端数据获取与渲染流程，定义服务端页面预取、客户端组件接收初始数据及 SWR 缓存更新的架构模式。
实现 API 调用或数据拉取逻辑
开发 Next.js 服务端或客户端组件
构建基于 SWR 的数据状态管理 Hook
npx skills add trycompai/comp --skill data -g -y
规定前端表单开发规范，强制使用 React Hook Form 结合 Zod 进行类型推断与数据校验。涵盖基础模式、复杂组件控制、状态管理及错误处理，确保表单构建的一致性与健壮性。
构建表单界面
实现表单数据验证
处理表单提交逻辑
npx skills add trycompai/comp --skill forms -g -y
指导基于Bun和Turbo的Monorepo基础设施管理，涵盖包管理、结构规范、命令执行及依赖维护。
配置Monorepo结构
管理项目依赖
执行构建或类型检查
npx skills add trycompai/comp --skill infra -g -y
用于在仓库中启动新功能、Linear工单或Bug修复时，自动建立分支、工作树、环境变量、数据库及开发服务器环境，实现开箱即用的开发准备。
start a new feature
spin up a worktree
begin ticket
new branch
npx skills add trycompai/comp --skill new-feature-setup -g -y
执行全面的生产就绪检查，并行运行RBAC、Hooks、设计系统、测试和安全审计，并验证构建状态，最终输出包含修复摘要和构建状态的报告。
发布前生产环境就绪检查
代码合并前的自动化质量与安全审计
npx skills add trycompai/comp --skill production-readiness -g -y
提供提示词工程最佳实践，涵盖核心原则与六大技术（清晰指令、示例、思维链等），旨在提升大模型交互效果与输出质量。
需要优化或编写AI提示词
学习提示词设计技巧
对比提示词工程与微调策略
npx skills add trycompai/comp --skill prompt-engineering -g -y
审查代码中的高危安全漏洞（如访问控制、注入、密钥泄露等），并立即修复确认的问题。适用于API控制器、认证代码、Prisma查询及文件上传等涉及信任边界或资源变更的场景，作为CI安全检查的补充。
编辑API控制器、守卫或认证代码
修改Prisma模式或查询
处理文件上传或Webhook逻辑
提交或推送安全敏感更改前
npx skills add trycompai/comp --skill security-review -g -y
用于清理过期的 git worktree 及其关联的孤立 Postgres 数据库。通过盘点、分类和确认流程，安全删除已合并或废弃的工作树及 dangling 数据库，避免误删活跃工作。
clean up worktrees
delete stale worktrees
worktrees piling up
orphaned databases
remove unused worktree
npx skills add trycompai/comp --skill stale-worktree-cleanup -g -y
提供 Trigger.dev v4 高级任务编写规范，涵盖标签管理、并发队列控制及错误重试机制。旨在指导开发者构建高可靠、可观测的异步任务处理逻辑，优化任务执行流程与资源调度。
需要实现异步任务时
配置任务并发限制或队列策略时
设计任务重试与错误恢复机制时
npx skills add trycompai/comp --skill trigger-advanced-tasks -g -y
提供Trigger.dev SDK v4编写异步任务的最佳实践，涵盖基础任务、带验证的Schema任务、定时任务及触发调用模式。
用户询问如何使用Trigger.dev创建异步任务
需要配置任务重试策略或Cron调度
实现任务间的触发与等待逻辑
npx skills add trycompai/comp --skill trigger-basic -g -y
提供 Trigger.dev v4 项目配置指南，涵盖基础设置、重试策略及构建扩展（如 Prisma、Python、Playwright），用于初始化和管理自动化任务运行环境。
需要配置 Trigger.dev 项目时
添加构建扩展或调整运行时设置时
npx skills add trycompai/comp --skill trigger-config -g -y
介绍如何在 Trigger.dev 中使用实时功能，包括订阅运行状态、元数据更新及流式传输，支持前后端集成与认证。
需要实时监控任务执行进度或状态变更
构建前端实时仪表盘以展示后端任务结果
实现基于流的实时数据推送功能
npx skills add trycompai/comp --skill trigger-realtime -g -y
用于构建或编辑前端UI组件、布局、样式及设计系统规范。强制使用特定设计系统，遵循语义化颜色、暗色模式支持及图标规范，禁止内联样式和硬编码颜色，确保前端界面一致性与可维护性。
构建或修改前端UI组件
调整页面布局和样式
集成设计系统组件
实现暗色模式适配
npx skills add trycompai/comp --skill ui -g -y
定义前端开发核心规范，涵盖包管理、组件库使用、类型安全、数据获取及状态管理等最佳实践。
需要遵循项目编码规范时
进行前端代码编写或审查时
npx skills add trycompai/comp --skill essentials -g -y
规范 Prisma 数据库 schema 变更与迁移流程，强制使用带前缀的 CUID 作为主键 ID，确保类型生成同步。
修改 Prisma Schema
创建数据库迁移
生成 Prisma Client 类型
定义数据模型 ID
npx skills add trycompai/comp --skill prisma -g -y
指导如何在 Trigger.dev 中编写和配置定时任务（Cron），包括声明式和命令式定义、动态多租户示例及 SDK 管理操作。
需要实现周期性后台任务
配置 Cron 表达式触发逻辑
npx skills add trycompai/comp --skill trigger-scheduled-tasks -g -y
定义前端开发核心规范，强制使用 bun、特定设计系统组件及 TypeScript 类型安全规则。规定数据获取与状态管理最佳实践，并集成代码检查流程以确保提交质量。
需要遵循项目基础编码规范时
初始化或配置前端开发环境时
npx skills add trycompai/comp --skill essentials -g -y
