Agent Skills
› trycompai/comp
trycompai/comp
GitHub审计并修复前端代码中的设计系统合规性问题，将遗留的 @trycompai/ui 和 lucide-react 迁移至官方设计系统组件与图标。
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 迁移至官方设计系统组件与图标。
需要统一前端 UI 组件库
发现使用了废弃的 ui 包或 lucide 图标
执行设计系统合规性检查
npx skills add trycompai/comp --skill audit-design-system -g -y
审计并修复前端代码中的 Hook 和 API 使用违规，消除 Server Actions、原始 fetch 及过时模式，强制使用 SWR 和数据获取规范。
需要检查前端代码是否符合 Hook 和 API 使用规范
发现使用了被禁止的 fetch 或 useEffect 模式
npx skills add trycompai/comp --skill audit-hooks -g -y
审计并修复 API 和前端组件中的 RBAC 权限控制及审计日志合规性问题，自动补充缺失的权限守卫、装饰器及 UI 权限门控。
需要检查代码中的权限控制是否合规
发现接口或组件缺少 RBAC 逻辑
需要批量修复权限相关的代码缺陷
npx skills add trycompai/comp --skill audit-rbac -g -y
审计并修复权限控制组件的单元测试。检查是否存在对应测试，编写缺失的覆盖管理员和审核员角色的测试，并修复失败用例，确保数据渲染正确。
需要为包含usePermissions的组件补充或验证单元测试
运行测试时发现权限相关组件测试缺失或失败
npx skills add trycompai/comp --skill audit-tests -g -y
提供 Better Auth 的集成指南，涵盖安装、环境变量配置、数据库适配器设置、会话管理及插件使用。用于指导用户快速搭建基于 TypeScript 的身份认证系统。
配置 Better Auth 服务端和客户端
设置数据库适配器
管理会话策略
添加 OAuth 或邮箱密码插件
npx skills add trycompai/comp --skill better-auth-best-practices -g -y
用于管理 Comp AI 计费系统，包括 Stripe 产品/价格配置、订阅结账、组织支付方式、权限控制、使用量账本、发票及 Webhook 处理。
修改 Stripe 产品价格或 SKU
处理订阅结账流程
更新组织支付方式
配置权限或使用量限制
处理计费相关的 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 行为约束
优化 Cursor 对特定文件类型的处理逻辑
npx skills add trycompai/comp --skill cursor-usage -g -y
规范前端数据获取与状态管理，定义Server到Client的SWR模式、API客户端使用及组件职责划分，强调服务端渲染初始数据与客户端交互分离。
实现数据获取逻辑
创建或修改SWR Hook
区分服务器端和客户端组件
处理API调用
npx skills add trycompai/comp --skill data -g -y
用于诊断 SDK 生成失败的根本原因并制定修复策略。通过分析 OpenAPI 规范、错误日志，区分可覆盖修复、需修改规范或需用户决策的问题，提供具体解决步骤和故障排查指南。
SDK generation failed
speakeasy run failed
SDK build error
workflow 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
根据 OpenAPI 规范使用 Speakeasy 生成 MCP Server，使 API 可作为工具供 AI 助手调用。
generate MCP server
MCP server
Model Context Protocol
AI assistant tools
Claude tools
speakeasy MCP
mcp-typescript
npx skills add trycompai/comp --skill generate-mcp-server -g -y
指导使用 Bun 和 Turborepo 管理 Monorepo 项目的包依赖、构建、Lint 及跨包导入规范，涵盖包创建与常见 TS/ESLint 错误修复。
Monorepo 包管理
Bun 命令执行
构建配置调整
npx skills add trycompai/comp --skill infra -g -y
管理 OpenAPI Overlay 文件，用于在不修改源文件的情况下定制 SDK 生成配置。支持创建、应用、验证 Overlay，处理 JSONPath 定位、重试、分页及安全配置等。
创建 Overlay 文件
应用 Overlay 到规范
验证 Overlay 语法
比较规范生成 Overlay
修复 Lint 错误
npx skills add trycompai/comp --skill manage-openapi-overlays -g -y
自动化新特性开发环境初始化，通过 git worktree 创建分支并自动配置数据库、环境变量及依赖安装，解决基础设施重复配置问题。
开始新功能
启动工作树
处理 Linear 工单
新建分支
npx skills add trycompai/comp --skill new-feature-setup -g -y
执行生产就绪检查，并行运行RBAC、钩子、设计系统和测试审计，并验证Monorepo构建状态。最终输出包含修复摘要和构建状态的报告，确保代码符合发布标准。
需要全面评估代码库是否达到生产发布标准
在执行部署前进行自动化质量与合规性审计
npx skills add trycompai/comp --skill production-readiness -g -y
提供提示词工程最佳实践，涵盖核心原则与技巧，指导用户编写清晰指令、使用示例及思维链，以提升AI响应质量并对比微调优势。
需要优化或设计AI提示词时
询问提示词工程技巧或原则时
npx skills add trycompai/comp --skill prompt-engineering -g -y
规范 Speakeasy CLI 使用流程，要求任务前执行 agent context 获取能力，任务后提交反馈。适用于 SDK 生成、OpenAPI 处理等场景，确保操作准确性与体验优化。
Speakeasy SDK 开发
OpenAPI 文档处理
CLI 工具交互
npx skills add trycompai/comp --skill speakeasy-context -g -y
用于清理过期的 Git worktree 目录及其关联的孤儿 Postgres 数据库。通过盘点、分类和确认流程，安全移除已合并或废弃的工作区，避免资源浪费。
清理旧 worktree
删除过期 worktree
worktree 堆积
孤儿数据库
移除未使用的 worktree
npx skills add trycompai/comp --skill stale-worktree-cleanup -g -y
提供Trigger.dev高级任务编写规范，涵盖标签管理、并发队列控制及错误重试策略。旨在指导开发者构建高可用、可观测且高效的任务处理逻辑，适用于异步任务开发场景。
需要配置任务标签以便追踪和订阅
需设置任务并发限制或共享队列
需实现自定义错误处理与指数退避重试
npx skills add trycompai/comp --skill trigger-advanced-tasks -g -y
提供Trigger.dev v4 SDK编写异步任务的基础规范，涵盖基本任务、带验证的Schema任务、定时任务及触发方式，强调使用task和schemaTask API。
需要创建或配置Trigger.dev后台任务
实现异步数据处理逻辑
设置定时任务或Cron调度
npx skills add trycompai/comp --skill trigger-basic -g -y
提供Trigger.dev v4项目配置指南，涵盖trigger.config.ts基础设置、重试策略、构建扩展及全局生命周期钩子。
需要配置Trigger.dev项目时
查询Trigger.dev构建扩展用法时
npx skills add trycompai/comp --skill trigger-config -g -y
介绍 Trigger.dev v4 实时功能，涵盖后端任务订阅、流式数据处理及前端 React Hooks 集成，用于构建实时监控与更新 UI。
需要实时监听从属任务状态或进度
实现前端与后端的实时数据同步
处理长运行任务的流式输出展示
npx skills add trycompai/comp --skill trigger-realtime -g -y
规范前端UI组件开发，强制优先使用设计系统组件与图标，禁止硬编码样式和className，要求支持暗黑模式及语义化颜色，旨在提升界面一致性与可维护性。
构建或编辑前端UI组件
调整页面布局与样式
实现暗色模式适配
npx skills add trycompai/comp --skill ui -g -y
规范NestJS API端点开发，确保DTO、OpenAPI、MCP和运行时校验一致。
新增或修改API端点
创建新DTO
编辑控制器代码
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 调用模式，如替换 useAction、禁止客户端直连数据库、统一使用 SWR 进行数据获取与缓存管理。
检查或修复 React/Next.js 组件中的状态管理和 API 调用逻辑
发现使用了已废弃或禁用的数据请求模式（如 raw fetch、useEffect 拉取）
npx skills add trycompai/comp --skill audit-hooks -g -y
审计并修复NestJS API端点和前端组件中的RBAC及审计日志合规性问题。自动添加缺失的权限装饰器、守卫及UI权限控制，确保符合安全规范并立即修正违规代码。
需要检查API或前端的权限控制合规性
发现接口缺少@RequirePermission或前端按钮未做权限隔离
进行安全审计以修复RBAC漏洞
npx skills add trycompai/comp --skill audit-rbac -g -y
审计并修复权限控制组件的单元测试，确保覆盖管理员与审计员场景，生成缺失测试并解决失败用例。
需要为权限组件编写或检查单元测试
发现权限组件缺少测试用例
权限相关测试失败需修复
npx skills add trycompai/comp --skill audit-tests -g -y
提供统一只读服务以复用集成检查结果，避免直接查询数据库。支持按任务、连接或资源获取最新合规数据，用于展示2FA状态、AWS S3发现等场景，确保特征与数据源解耦。
需要复用集成检查结果
展示2FA状态或AWS S3发现
避免直接查询IntegrationCheckResult表
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代码规范
npx skills add trycompai/comp --skill cursor-usage -g -y
定义数据获取规范，涵盖服务端页面拉取、客户端组件接收初始数据及SWR Hook缓存管理。指导API客户端调用、服务与客户端组件职责分离及状态管理最佳实践。
实现数据获取逻辑
编写API调用代码
开发SWR Hooks
区分服务器端和客户端组件
npx skills add trycompai/comp --skill data -g -y
规定前端表单开发必须使用 React Hook Form 结合 Zod 进行类型安全与数据验证，涵盖基础模式、复杂组件控制及错误处理规范。
构建用户输入表单
实现表单数据校验
处理表单状态管理
npx skills add trycompai/comp --skill forms -g -y
指导 Monorepo 项目的基础设施配置，涵盖包管理、结构规范、命令执行及依赖添加。强制使用 Bun 和 Turborepo，明确跨包导入与代码检查流程，提升构建效率。
Monorepo 项目初始化或结构调整
处理包依赖安装与管理
执行构建、Lint 或类型检查
npx skills add trycompai/comp --skill infra -g -y
自动化新特性、Bug修复或Linear工单的初始化流程。通过git worktree创建分支，并自动配置隔离的PostgreSQL数据库、环境变量及依赖安装，实现开箱即用的开发环境。
start a new feature
spin up a worktree
begin ticket
new branch
npx skills add trycompai/comp --skill new-feature-setup -g -y
执行全面的上线前就绪检查，并行运行RBAC、钩子、设计系统、测试及安全审计，并验证构建状态，最终输出包含修复摘要和构建状态的报告。
需要验证代码是否具备生产环境部署条件
执行多模块并行审计与构建验证
npx skills add trycompai/comp --skill production-readiness -g -y
提供提示词工程最佳实践，涵盖明确指令、多示例及思维链等核心技巧，旨在优化AI交互效果并替代微调。
需要编写或优化提示词
咨询大模型使用策略
npx skills add trycompai/comp --skill prompt-engineering -g -y
用于在代码提交前审查高安全风险漏洞（如访问控制、注入、密钥泄露等），自动定位并修复确认的高危问题，补充CI安全扫描盲区。
编辑API控制器或认证代码后
修改Prisma查询逻辑时
处理文件上传或Webhook时
准备提交敏感安全相关变更时
npx skills add trycompai/comp --skill security-review -g -y
用于清理过期的Git工作树及关联的孤立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高级任务开发规范，涵盖标签组织、并发队列管理及错误重试策略。指导开发者编写高可靠性的异步任务代码。
编写Trigger.dev异步任务
配置任务并发与队列限制
实现任务错误处理与重试逻辑
npx skills add trycompai/comp --skill trigger-advanced-tasks -g -y
提供Trigger.dev v4 SDK编写基础任务的规范，涵盖基本任务、带Schema验证的任务、定时任务及触发机制的最佳实践与代码示例。
需要定义异步后台任务
配置定时调度任务
实现任务间触发与等待逻辑
npx skills add trycompai/comp --skill trigger-basic -g -y
提供 Trigger.dev v4 项目的 trigger.config.ts 配置指南，涵盖基础设置、重试策略及 Prisma、Python、Playwright 等构建扩展的使用方法。
需要配置 Trigger.dev 项目时
询问 Trigger.dev 构建扩展用法时
npx skills add trycompai/comp --skill trigger-config -g -y
介绍 Trigger.dev v4 实时功能，涵盖运行状态订阅、流式数据传输及前端集成。提供认证令牌创建、后端任务触发与监听、以及 React 钩子使用示例，用于构建实时监控仪表板。
需要监控异步任务进度
实现前端实时数据更新
处理后台任务流式输出
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 的迁移流程与 ID 生成策略。要求 Schema 修改在 packages/db 进行，执行迁移后需在各应用重新生成类型。强制使用带前缀的 CUID 作为主键，禁止 UUID 或自增 ID。
修改 Prisma 数据库模型结构
创建数据库迁移文件
定义实体 ID 字段类型
配置 Prisma Client 生成
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
定义前端开发核心规范，涵盖包管理、组件使用、类型安全及数据获取等关键规则。
需要遵循项目基础编码规范
初始化或维护前端代码库
npx skills add trycompai/comp --skill essentials -g -y
