technical-spec
该技能定义环境变量、架构设计与构建/测试命令，适用于配置环境或设计架构时使用。基于 TypeScript，强调类型安全、职责分离与统一数据流，并规定质量检查流程与 70% 以上单元测试覆盖率要求。
Skill 广场
找到适合任务的 Agent Skill，阅读介绍并复制安装命令。
更新于 11-14 00:15
编程与开发
41,029 个结果
typescript-rules
TypeScript 开发规则，用于在编写或审查 TypeScript 代码时强制类型安全与错误处理规范。该技能通过「unknown 输入 → 类型守卫 → 业务层类型保证 → 输出序列化」的数据流模式，要求所有外部输入以 unknown 接收并经过类型守卫校验，禁止使用 any。它规定统一的错误处理方式：禁止吞掉错误，所有错误必须记录日志并做适当处理，遵循快速失败原则，并可用 Result<T, E> 类型显式表达错误可能性。同时给出编码约定：优先使用函数与接口而非类，类仅用于框架要求、自定义错误类或状态与业务逻辑紧密耦合的场景；函数参数最多 2 个，更多参数使用对象；依赖以参数注入；异步统一使用 async/await 与 try-catch，并显式声明返回类型。还包括命名与导入规范、清理未使用代码、分层错误处理（API 层转 HTTP 响应、Service 层传播 AppError、Repository 层转换技术错误）、结构化日志与敏感信息保护、全局异步错误处理以及流式处理等性能优化建议。
typescript-testing
面向 TypeScript 项目的 Vitest 测试规范技能，规定单元测试覆盖率不低于 70%、测试独立可复现、使用字面量断言与最小化 mock，并给出目录命名、集成测试与数据层测试的实践指引。
check
check 是一个用于代码审查的命令行技能入口，通过参数首词分发到不同的审查动作。默认动作 code 会审查 PR 或 diff 的正确性、安全性和规格一致性；grok 动作通过 Grok CLI 获取独立第二意见，并在报告前逐条对照代码验证；week 动作对看板准确性、近期变更、运行健康状况和限定范围内的清理进行每周工程审查，默认只报告，除非使用 --fix。所有动作默认不修改代码，仅在对应 playbook 明确要求修复标志或确认时才可能改动。
lemmaly
lemmaly 是一个“算法优先”纪律技能，要求在编写循环、查询或递归前先声明时间复杂度、数据结构与算法族，用于预防 O(n²)、N+1 和暴力解法，并附带可选的 CLI 扫描器。
unslop-commit
unslop-commit 是一个用于生成或改写 Git 提交信息的技能，目标是让提交信息读起来像一位严谨的人类工程师所写。它会去除 AI 与营销腔调（如"comprehensive solution""robust implementation""leverage""enhance""seamlessly"以及"This commit..."式开头），并保持 Conventional Commits 格式。
sniffable-python
sniffable-python 是一个 Python 代码结构约定，目标是在约 50 行内让大语言模型读懂一个脚本。它不发明新语法，而是把既有 Python 语法按固定顺序组织：模块 docstring 说明用途与用法、导入分组、常量集中、CLI 结构前置、实现代码后置。这样模型无需阅读全部实现即可掌握脚本的接口与命令树，既可作为 --help 的来源，也便于人类与 LLM 共用同一份源码。方案推荐使用 argparse 代替 Click/Typer，因为 argparse 能把 CLI 定义集中在 main() 中，与实现分离；同时强调注释要承载信息（如说明常量取值原因、TODO、NOTE），而非装饰性分隔符。它还要求脚本基于 __file__ 而非 os.getcwd() 定位自身上下文，从而支持从任意目录调用。
readable-code
readable-code 是一个面向代码编写的技能，用于帮助提升源码的人类可读性与可维护性，并鼓励采用更简单的解决方案。它提出一套“阶梯”式决策顺序：先判断需求是否真的存在（YAGNI），再看代码库中是否已有可复用的辅助函数、工具、类型或模式，然后看标准库是否已实现，最后看已安装依赖能否解决；不轻易引入新依赖。该技能强调减少概念与活动部件而非减少行数，偏好可读、符合语言习惯、命名清晰、步骤明确的代码，仅当一行写法比展开写法更易理解时才使用一行写法。修复缺陷时应定位根因而非症状，编辑前先检索目标函数的所有调用方，在共享位置一次修复。它还规定不添加未经请求的抽象、不写样板代码和“以后可能用到”的脚手架，倾向于删除而非添加、平淡而非取巧。输出方面，除非是超过约 100 行的大型功能（此时最多给出 3 条简短要点），否则不过度总结实现内容。同时明确不能为偷懒而省略的部分：信任边界的输入校验、防止数据丢失的错误处理、安全措施、无障碍基础以及任何明确要求的内容；对问题的理解也不能偷懒，必须先完整追踪改动涉及的每个文件与真实流程。测试方面建议关注覆盖多个功能的高层测试，而非大量依赖模拟、脆弱的低层单元测试。
api-integration-specialist
API Integration Specialist 是一个面向第三方 API 集成场景的专家助手技能，旨在帮助开发者设计、集成和维护可靠、安全且高效的 API 对接。它覆盖从前期调研规划、认证方式选择（OAuth 2.0、API Key、Bearer Token）、请求构造、响应处理，到错误处理、限流节流、安全实践、数据转换、分页、Webhook 集成、测试策略、监控日志以及常见集成模式（幂等、批量、缓存）等完整工作流。该技能以最佳实践和代码示例形式提供指导，适合需要对接外部服务的开发与集成工作。
command-development
Command Development 是面向 Claude Code 的技能，用于创建和管理斜杠命令（slash command）。斜杠命令是以 Markdown 文件定义的常用提示词，在交互会话中由 Claude 执行。该技能涵盖命令结构、YAML frontmatter 配置项、动态参数、文件引用、Bash 预执行、命令组织与命名空间，以及插件命令相关特性，帮助把常见工作流固化为可复用、可共享、可标准化的命令。
python-executor
python-executor 是一个通过 inference.sh 在安全沙箱环境中执行 Python 代码的技能。它预装了 100 多个常用库，涵盖网络请求与爬虫、数据处理与可视化、图像处理、音视频处理、3D 模型处理以及文档与图形生成等方向。用户通过 belt CLI 登录后，以命令行方式提交代码并获取运行结果，保存到 outputs/ 目录的文件会被自动返回。该环境为 Python 3.10、仅 CPU，默认 8GB 内存（可选 16GB 高内存），超时时间 1 至 300 秒（默认 30 秒），代码在隔离子进程中运行，适合网页抓取、数据分析、图像与视频生成、3D 处理、API 调用、PDF 生成和各类自动化脚本等场景。
gepetto
Gepetto 是一个 AI 辅助的实现规划技能，通过「研究 → 访谈 → 规格综合 → 计划 → 外部评审 → 分节」的多步骤流程，生成详细且分节的实现计划。它要求用户提供一个以 .md 结尾的规格文件作为输入，规划目录由该规格文件的父目录推断。Gepetto 会在规划目录中写入多个 .md 文件，包括研究结果、访谈记录、综合规格、实现计划、外部反馈整合说明、外部 LLM 评审、分节实现单元，以及用于自主执行的 ralph-loop 提示文件和 Ralphy PRD 文件。它支持从已有文件断点续跑，并可通过并行子代理执行研究与分节编写，通过 Gemini 和 Codex 进行外部评审。
configure-sdk-options
该技能用于配置已有的 Speakeasy SDK，而非初次生成。它围绕 gen.yaml 文件，为 TypeScript、Python、Go、Java、C#、PHP、Ruby 七种语言提供配置选项，涵盖方法签名、错误处理、异步模式、包管理与发布、SDK 钩子、运行时覆盖（服务器选择、重试、超时）、分页等。使用前提是已存在带 .speakeasy/workflow.yaml 的 SDK。修改 gen.yaml 后需运行 speakeasy run 重新生成才会生效。
bloc-pattern
BLoC Pattern 是一份面向 Flutter 的 BLoC（Business Logic Component）模式实践指南，基于 flutter_bloc 库，讲解如何构建可扩展、可测试、易维护的应用。内容涵盖 BLoC 的核心概念（事件、状态、状态转换、BLoC 组件）、基础计数器示例、结合 API 与仓库（Repository）的异步数据加载示例，以及使用 bloc_test 进行单元测试的写法。同时给出最佳实践，如使用 Dart 3 密封类定义状态与事件、实现 Equatable、保持 BLoC 纯净、优雅处理错误、正确释放 BLoC、使用 MultiBlocProvider 等。适合需要将业务逻辑与 UI 分离、管理复杂状态或处理异步操作的 Flutter 开发者参考。
solution-architect
解决方案架构师助手，用于设计新系统架构、评审现有架构、技术选型、诊断性能与可扩展性问题、规划架构演进或重构。覆盖微服务、事件驱动、云原生等模式，趋势类问题通过实时搜索获取。不用于功能代码实现、安全漏洞审计和产品需求分析。
handle-pr-comments
Handle PR Comments 是一个用于交互式处理 GitHub PR 评审评论的技能。它从当前分支或指定的 PR 编号/URL 定位拉取请求，通过 GraphQL 的 reviewThreads 字段获取所有未解决的评审线程，然后逐条处理：总结反馈内容与所在文件/行号、阅读周边代码、给出具体修复建议，并通过 AskQuestion 让用户选择应用建议修复、应用其他修复、仅回复或跳过。用户做出选择后，技能会应用改动、按需提交，并通过 resolveReviewThread 变更将线程标记为已解决。最后输出变更、提交、回复、跳过和已解决情况的概览及链接。该技能适合在代码评审阶段集中清理 PR 评论，尤其适用于需要人工确认每一步处理方式的场景。
open-pr
open-pr 是 Storybook 仓库中的一个技能，用于从当前分支按照 Storybook 约定创建草稿拉取请求（PR）。当用户要求打开 PR、创建拉取请求或调用 /open-pr 时使用。它会自动收集 git 上下文、检测基础分支、询问 CI/QA/类型标签，读取并填充 PR 模板，最后通过 gh 命令创建草稿 PR 并指派给自己，随后可选择是否创建 canary 发布。
clean-code
Clean Code 是一套面向 AI 编程助手的务实编码规范技能，强调简洁、直接、以解决问题为导向，反对过度工程和不必要的注释。它规定了核心设计原则（单一职责、DRY、KISS、YAGNI、童子军规则）、命名约定（变量揭示意图、函数用动词加名词、布尔值用疑问形式、常量用全大写下划线）、函数规则（不超过 20 行、只做一件事、参数不超过 3 个、无意外副作用）以及代码结构建议（卫语句提前返回、避免深层嵌套、组合小函数、相关代码就近放置）。该技能还给出 AI 编码风格指引：用户要功能就直接写、报 bug 就直接修、需求不清就先问。同时列出常见反模式及修正方式，并要求在编辑文件前先思考依赖关系，编辑文件时同步更新所有依赖文件，完成任务前进行自检，并按代理与脚本映射运行对应的验证脚本，脚本输出需先读取、总结、询问用户后再修复。
read-github
read-github 是一个通过 gitmcp.io MCP 服务读取 GitHub 仓库文档与代码的技能。它主张用 gitmcp.io 替代直接抓取网页，优势在于可对文档做语义搜索而非仅关键词匹配。使用时将 github.com/owner/repo 转换为 gitmcp.io/owner/repo，并通过 scripts/gitmcp.py 命令行脚本调用：列出可用工具、获取完整文档、在文档中语义搜索、用 GitHub Search API 精确搜索代码、抓取文档中引用的外部 URL，以及直接调用任意 MCP 工具。工具名会按仓库名动态加前缀，例如 karpathy/llm-council 对应 fetch_llm_council_documentation。适合需要理解仓库、查找用法或定位实现时使用。
api-design
API Design 是 sunnypatneedi/claude-starter-kit 中的一个技能，用于辅助设计 RESTful API 端点。它通过引导式提问和结构化流程，帮助梳理资源、操作、关系与调用方，进而定义 URL 结构、HTTP 方法、请求与响应格式、状态码，并生成 OpenAPI/Swagger 文档，最后对照 RESTful 规范、命名一致性、状态码与安全注意事项进行最佳实践检查。
code-review
这是一个用于执行全面代码审查的 AI 技能，属于 sunnypatneedi/claude-starter-kit 技能集。它要求对提供的代码从正确性、安全性、性能、可维护性和测试五个方面进行系统检查，并按“关键问题（必须修复）”“建议（应考虑）”“细节（可选/次要）”“值得肯定之处”四类格式输出反馈，同时要求每条建议说明理由、保持建设性。该技能本身不包含自动执行代码或集成工具，具体审查效果取决于所审查的代码和模型能力。
debug-help
Debug Helper 是一个用于系统化排查问题的调试辅助技能，来源于 sunnypatneedi/claude-starter-kit。它通过分步骤引导的方式，帮助用户从问题描述、信息收集、假设提出、调查计划、系统化调试到最终解决，逐步定位并修复缺陷。该技能强调先明确症状与预期行为、复现步骤，再收集错误信息、日志、堆栈跟踪和环境细节，随后基于症状提出可能原因并设计验证方法，最后确认根因、实施修复、补充回归测试并记录文档。适合开发者在遇到难以定位的 bug 时，借助结构化流程避免盲目尝试。
pr-checklist
PR Checklist Generator 是一个根据代码变更自动生成 PR 检查清单的技能。它会先分析改动了哪些文件、变更类型（功能、修复、重构）以及受影响的系统，然后输出一份完整的检查清单。清单涵盖代码质量、测试、安全、性能、文档等通用项，并会根据具体变更追加针对性条目，例如涉及数据库时检查迁移与回滚、涉及 API 时检查文档与兼容性、涉及 UI 时检查响应式与无障碍。
systems-review
Systems Review 是一个用于在实现完成后审查“二阶效应”的技能。它围绕实现摘要、性能、安全、下游影响、测试覆盖和修复建议等维度，引导开发者系统性地检查代码改动可能带来的连锁影响，并给出分级建议与签核清单。