typescript
TypeScript 性能与最佳实践指南技能,包含 45 条按影响优先级排列的规则,覆盖类型系统性能、编译器配置、异步模式、模块组织、类型安全、内存管理等 8 类主题,用于指导 tsconfig.json 配置、类型定义编写与代码重构。
找到适合任务的 Agent Skill,阅读介绍并复制安装命令。
更新于 11-16 00:04
41,242 个结果
TypeScript 性能与最佳实践指南技能,包含 45 条按影响优先级排列的规则,覆盖类型系统性能、编译器配置、异步模式、模块组织、类型安全、内存管理等 8 类主题,用于指导 tsconfig.json 配置、类型定义编写与代码重构。
该技能用于按最佳实践生成 React 组件,采用 TypeScript、Tailwind CSS 与 Zustand 状态管理,内置基础、表单、列表、卡片、按钮、模态框等模板,适用于创建或脚手架常见 UI 组件。
本技能介绍如何修改 stellar-core 的构建配置,包括启用或禁用构建变体、切换编译器或编译标志,以及为构建做其他准备。内容涵盖构建流程(autogen.sh、configure、Makefile 生成)、配置变量(CC、CXX、CXXFLAGS、标准库选择)和常用配置标志(--disable-tests、--disable-postgres、--enable-asan、--enable-threadsanitizer、--enable-memcheck、--enable-undefinedcheck、--enable-extrachecks、--enable-fuzz 等),并强调始终从顶层运行、使用 --enable-ccache 和 --enable-sdfprefs、不直接编辑 configure 或 Makefile 等规则。
该技能介绍如何正确运行 make 构建 stellar-core,并理解其递归 make 构建系统。核心要点包括:始终在顶层目录运行 make -j $(nproc) 以获得完整并行构建,使用 2>&1 | tail -N 限制输出,添加文件后运行 git add 与 ./make-mks 确保纳入构建;禁止在子目录运行、禁止使用 make -C、禁止手动运行 cargo、禁止编辑 Makefile 或 Makefile.in,只能编辑 Makefile.am。主要目标有 all、check、clean、format。构建系统由递归 make 结构组成,lib 下多个 vendored 项目使用各自 Makefile,src/Makefile.am 定义大部分构建,并委托 cargo 构建 Rust 组件。生成文件包括 XDR 协议文件、xdrquery 的 flex/bison 部分、版本信息文件以及 RustBridge。
stellar-core 中用于异步管理外部子进程的进程子系统技术总结,涵盖 ProcessManager 接口、posix_spawnp/CreateProcess 跨平台启动、并发上限、输出文件捕获与优雅关闭,不含子进程 I/O 读写能力。
Stripe Apps 的智能体技能说明,用于在构建、修改或审查 Stripe App 时提供指导。它要求先加载发现流程、按顺序提问、用 CLI 脚手架生成项目,并依据官方文档写入可运行文件。
ASP.NET Core 技能包,面向 VanDaemon 后端,提供构建 REST API、SignalR 实时通信中心与 Web API 应用的模式与规范。项目基于 .NET 10,采用瘦控制器(thin controllers)架构:控制器只负责把请求委托给应用服务,业务逻辑不写在控制器中;服务以单例(singleton)方式注册;使用 SignalR 实现实时更新;通过 JSON 文件进行持久化。技能内容涵盖最小控制器示例、服务注册(依赖注入与 SignalR 映射)、关键概念(如 CancellationToken、ActionResult、后台服务、健康检查)、常见模式(带作用域的后台服务、/health 健康端点),并指出常见反模式(控制器内写业务逻辑、缺少 CancellationToken、异步上下文中的阻塞调用、服务生命周期使用错误)。还包含 patterns、workflows 等参考条目,以及与 csharp、signalr、serilog、docker、xunit 等相关技能的关联。
用于按 VanDaemon 约定和整洁架构模式生成 C# 代码的技能,适用于在 VanDaemon 中创建服务、实体、控制器或插件。
pipes-abi 是 Subsquid Labs 提供的区块链索引技能,专门用于获取、分析和管理智能合约 ABI。它能从 Etherscan、Basescan、本地文件或包中读取 ABI,解析事件结构并识别参数类型,借助 @subsquid/evm-typegen 生成 TypeScript 类型,检测 ERC20、ERC721、Uniswap 等标准接口,并把事件结构(含 BigInt、indexed 标记)传给 schema-designer 以设计数据库模式。该技能还能识别代理合约,并在标准事件场景中推荐 commonAbis 或内联事件定义方案。
用于设计与规划 REST 或 GraphQL API 的技能,可生成 OpenAPI 3.1 规范、进行资源建模、版本策略规划、分页与错误响应设计,并梳理认证授权流程,适用于新建 API、编写接口契约和规划 API 演进。
error-handler-gen 是一个通过 npx 运行的命令行工具,可为 Express、Fastify、Next.js、Koa 等框架生成错误处理中间件,包含自定义错误类、异步包装器和 HTTP 状态码设置,需配置 OPENAI_API_KEY。
基于 Node 的通用 Notion API 命令行工具,支持搜索、查询数据源(数据库)和创建页面。通过 NOTION_KEY 环境变量或 ~/.config/notion/api_key 配置令牌,不硬编码数据库 ID 与密钥。
通过 OpenAI 音频转写 API(Whisper)将音频文件转写为文本的技能,提供 curl 脚本调用 /v1/audio/transcriptions 端点,默认使用 whisper-1 模型并输出同名 .txt 文件。
这是一个用于编写接口注释的编程实践技能:提倡在实现代码之前先写接口注释,并把注释当作设计探针。该技能包含两种模式。模式 A 针对新代码,先为类或模块写接口注释,说明其提供的抽象、单个实例代表什么以及边界;再为主要公共方法写签名和接口注释,函数体留空;反复迭代注释直到既简短又完整,若无法兼得则说明设计有问题,应改设计而非改文字;然后注释关键字段,最后再写函数体,每个新方法都先写注释。模式 B 用于审计已有代码,按顺序检查接口注释是否给出调用方可见行为、每个参数与返回值的精确含义、副作用、错误和前置条件;接口注释中不应包含实现细节;注释不得重复代码;字段与参数需说明单位、边界是否包含、null 含义、由谁释放或关闭以及不变量;实现注释解释代码块做什么和为什么,而非怎么做。还涉及命名:名称应让人单独看到就能猜出含义,长度 1 至 3 词,精确优于笼统,布尔值用谓词形式,一个概念一个名称,名称长度随声明与使用之间距离增长。输出方面,模式 A 输出注释与签名组成的骨架,模式 B 输出路径、行号、问题及改写后的注释或名称,并列出注释暴露出的设计异味。
define-errors-out 是一项软件设计技能,主题是“把错误定义得不复存在”。它针对异常处理复杂、错误处理代码分散且难以维护的问题,提出减少必须处理错误之处的方法。该技能源自《A Philosophy of Software Design》相关技能集合,核心思路是:抛出异常容易,处理异常困难,每个异常都是接口的一部分并会传播给所有调用者,因此目标是让需要处理错误的地方尽量少。对每个错误点,按顺序尝试四种技术:一是重新定义语义,让正常行为覆盖该情况,例如 unset(x) 表示“确保 x 不存在”,缺失即无操作;substring 返回区间与字符串的交集,越界只得到空或截断结果;Unix 删除已打开文件只做删除标记;幂等的创建或删除;用空集合替代 null。二是在低层屏蔽,模块内部处理,让调用者看不到,如 TCP 式重试、回退、重算。三是高层聚合,让错误传播到单一处理器(如请求分发器),把面向用户的消息放在抛出点。四是直接崩溃,对罕见且无合理恢复方式的错误,用统一助手如 must()、ckalloc 中止并给出清晰信息。该技能也提醒不要过度隐藏调用者必须采取行动的错误,并产出错误点表格与语义修改建议。
Design It Twice 是一个面向软件开发的设计方法技能,核心主张是在实现新模块、包、类、API 或 CLI 之前,先草拟两到三个截然不同的接口设计,进行比较后择优或综合。它强调先确定接口再写实现,通过列出常见场景的调用点、对比易用性、接口简洁度、隐藏深度、通用性和实现效率等标准,帮助开发者避免第一直觉带来的设计缺陷。该技能还提供输出模板,包含备选方案、决策理由和最终接口签名,并建议在实现非平凡时重复该流程。
Jupytext Skill 是一个用于在 Jupyter Notebook(.ipynb)与 Markdown 文本笔记本之间进行双向转换与配对的技能工具。它支持将 .ipynb 导出为 md 或 md:myst,也能将 Markdown 还原为 notebook;可通过配对和同步机制让两种格式保持内容一致,便于在 Git 中审阅。该工具提供配套脚本 jupytext_roundtrip.py 以及项目级配置方案,适用于需要文本化审查、MyST/Jupyter Book 工作流或脚本式笔记本的场景。
Swift DocC 是 Swift 生态的文档编写与组织工具,用于把源码中的 /// 注释和 .docc 目录文件编译成可导航的文档层级:落地页 → 文章 → 符号页。本技能指导如何为 Swift 类型、方法或属性添加三斜线注释,创建 .docc 目录,编写文章或扩展文件,并通过 ## Topics 分组把符号纳入导航树。内容涵盖符号文档写法(摘要、参数、返回值、抛出错误)、Topics 层级构建、文档目录与落地页创建,以及使用脚本或 swift package generate-documentation 验证文档构建。
add-oauth-provider 是 treg 项目中的一个 OAuth 提供方注册技能,用于向 treg 自有的 OAuth 注册表(即 treg 持有自己已获批应用凭据的提供方)添加新的 OAuth 提供方。它适用于需要接入 YouTube、Notion、Meta 等平台、让用户无需自行提供 client_id 即可连接账号的场景。该技能与 BYO 模式区分:BYO 模式下调用方自行提供 client_id/secret,可支持任意 OAuth2 提供方且无需改代码;而该注册表路径由 treg 自己持有所注册的应用。技能详细列出了需要按顺序完成的代码改动,包括在配置中新增凭据、在 oauth_providers.py 中定义并注册 OAuthProvider、配置能力范围(scopes,能力之间为累加超集关系而非替换)、发现账号信息的发现路径、用于健康检查与 Tools 预填的 probe_path,以及仪表盘与测试的相应改动,并附带运行测试与本地验证的完整步骤。
dev-local 是一键启动 tools-registry(treg)本地开发栈的脚本,在 tmux 中运行 FastAPI 服务器与 Vite 仪表盘,并提供沙箱化 CLI,避免覆盖真实的 ~/.treg/config.json。
Swift Deep Insight 是一款用于检测 Swift 项目中未使用(死)代码的工具,基于 Swift 编译器的索引存储(index store)进行分析。它可以识别未使用的类、结构体、函数、属性、协议等声明。使用前需要先构建项目以生成索引存储:Xcode 项目在 Xcode 中构建后索引存储会自动生成于 ~/Library/Developer/Xcode/DerivedData/<Project>/Index/DataStore;SPM 项目可用 xcodebuild -scheme <scheme> build 或 swift build 构建。工具通过 swift run swift-deep-insight 命令运行,支持 --project-path、--verbose、--xcode-format、--include-public、--exclude-tests、--build 等选项。
Brainstorming 是一个用于创意工作前置阶段的技能,要求在创建功能、构建组件、添加功能或修改行为之前使用。它通过自然的协作式对话,把想法逐步转化为完整的设计与规格说明。流程从了解当前项目上下文开始,然后一次只问一个问题来细化想法;理解目标后,提出 2-3 种方案并给出权衡与推荐,再分段呈现设计并逐段获得用户确认。设计通过后,写入 docs/plans/YYYY-MM-DD-<topic>-design.md 并提交到 git,最后调用 writing-plans 技能生成实施计划。该技能强调任何项目都应经过此流程,即使看似简单的任务也不例外,因为未审视的假设最容易造成返工。
AD3C Cycle 是一个按任务执行的实现微循环技能,把每个实现任务拆成 Analyze(分析)→ Develop(开发)→ Certify(认证)→ Correct(修正)→ Close(关闭)五步,适用于冲刺或功能开发中的单个任务。
这是一个 .NET MAUI 迁移技能,用于将 Xamarin.Forms 的自定义渲染器(Renderer)与效果(Effect)迁移到 MAUI 的处理器(Handler)架构,并附带风险跟踪与验证。