typescript
来自 forcedotcom/apex-language-support 的 TypeScript 编码规范与约定,涵盖文件命名、类型使用、导出方式、错误处理与重构要求等规则。
找到适合任务的 Agent Skill,阅读介绍并复制安装命令。
更新于 11-18 00:15
41,685 个结果
来自 forcedotcom/apex-language-support 的 TypeScript 编码规范与约定,涵盖文件命名、类型使用、导出方式、错误处理与重构要求等规则。
salesforcedx-vscode-core 扩展激活时通过 activate() 导出的公共 API(SalesforceVSCodeCoreApi),供其他扩展消费 SfCommandletExecutor、WorkspaceContext、通道与遥测服务等能力,并说明了哪些改动属于破坏性变更。
Salesforce DX VS Code 扩展单体仓库的外部 API 消费者清单,用于在修改公开 API(activate 返回类型、导出类型、服务等)时排查哪些外部仓库会受影响。
针对 LSP 自定义请求中 URI 序列化问题的技能说明:讲解为何 URI 经 JSON 传输后会退化为普通对象,并给出用 UriComponents 类型与 URI.revive 正确收发 URI 参数的做法。
paths 是 forcedotcom/salesforcedx-vscode 项目中的一条编码规范技能,用于指导在 /src 目录下的 .ts 文件中优先使用 vscode-uri 的 URI 而非 node:path 的路径操作。该技能建议用 vscode-uri 提供的工具函数替代 node:path 的常见方法,例如用 Utils.joinPath 替代 path.join、用 Utils.basename/dirname/extname 替代对应的 path 方法、用 Utils.resolvePath 替代 path.resolve。同时说明可通过 FsService 在 URI 与路径之间转换(toUri/uriToPath),并支持 file、memfs 等场景,具备跨平台特性,因为 FsService 与 workspace.fs 都接受 URI。技能还给出了例外情况(exit hatch):构建脚本、esbuild 配置、测试、仅桌面端扩展以及仅使用宿主文件系统的工具仍可使用 node:path。
这是一份面向 Salesforce VS Code 扩展开发者的技能文档,主题是「如何消费 salesforcedx-vscode-services 扩展 API」。文档围绕依赖该 services 扩展的其它扩展(如 salesforcedx-vscode-metadata、salesforcedx-vscode-org-browser)展开,说明如何通过 @salesforce/effect-ext-utils 中的 ExtensionProviderService 获取 API,如何区分「预构建服务」与「每扩展独立服务」,如何搭建 ExtensionContext 与运行时,如何注册命令、处理命令成功与错误、观察文件/配置/目标组织变化,以及如何编写测试。文档以 Effect 框架(Effect.gen、Layer、ManagedRuntime)为核心代码范式,配有大量 TypeScript 代码示例,并给出常见模式与反面示例(如重复构建已在 prebuiltServicesDependencies 中的服务会导致缓存与状态重复)。
Thermo-Nuclear Code Quality Review 是一个用于代码质量审查的技能,对当前分支的改动执行极为严格的实现质量与可维护性审计。它关注的不是局部命名或格式化细节,而是抽象质量、模块化、文件体积和条件分支蔓延等结构性问题,并主动寻找“代码柔道”式重构,即在不改变行为的前提下大幅简化实现。审查重点包括:文件是否因本次改动越过 1000 行阈值、是否在无关流程中新增临时条件分支、是否存在特性逻辑泄漏到共享路径、是否有薄弱抽象或恒等包装器、类型边界是否混乱(不必要的 cast、optional、any),以及是否存在重复逻辑、错误的层级归属、串行编排或非原子更新等设计异味。该技能给出来源中明确的结构性否决门槛,并强调直接、严格但不对人无礼的评审语气。它适用于分支级或 PR 级代码审查,尤其是希望推动架构级简化而非接受“能跑就行”的场景。资料暂未提供具体收费方式、安装命令、支持平台与运行方式等信息。
针对 TypeScript 报错 TS1261(文件名大小写不一致)的排查与修复技能,适用于导入路径与 include/git 索引中同一文件大小写拼写不同的情况。
修复导出基于 Effect 的函数时出现的 TS4023 错误。当 TypeScript 报出“has or is using name 'X' from external module but cannot be named”时使用,需导出 Effect 错误通道中出现的所有错误类型。
TypeScript 编码规范技能,适用于编写、审查或重构 .ts/.tsx 文件,以及命名或重命名 .ts 文件(文件名使用 camelCase)。该技能来自 forcedotcom/salesforcedx-vscode 仓库,列出了一系列团队约定的编码规则,包括禁止 barrel 文件、禁止 export *、优先使用 undefined 而非 null 或空字符串、优先使用 map/filter 而非循环与条件判断、避免可变操作、避免 any、从真实来源派生类型、禁止 enum 与 namespace、避免因开发者失误导致的运行时错误、.ts 文件名使用 camelCase、重构时保留注释、导出函数使用单行 JSDoc、优先使用 (Object|Map).groupBy、去除冗余的空集合守卫以及不必要的 const 声明等。
vscode-window-messages 是一份针对 VS Code 扩展开发中消息弹窗 API 的使用规范,来源于 forcedotcom/salesforcedx-vscode 项目。它指导开发者如何正确调用 vscode.window.showInformationMessage、showWarningMessage 和 showErrorMessage 等方法,涵盖直接使用 VS Code 原生 API 而非旧版 NotificationService、使用 nls.localize 进行国际化、正确处理返回值与按钮点击、模态对话框选项、以及与 Effect 库配合时的同步与异步用法等要点。
该技能用于将现有 Android 应用从 Salesforce Mobile SDK 12.x 升级到 13.2.1,面向自主编码智能体使用。它提供自包含的参考文件,包含精确的源码、文件路径与 CLI 命令,涵盖升级场景、API 变更与故障排查。执行前会检测项目中是否集成 SDK 12.x 且未出现 13.x。升级要求将 minSdk 提升至 28、compileSdk 与 targetSdk 提升至 36、Gradle wrapper 更新至 8.14.3、AGP 更新至 8.12.0,并规定不得重建项目、不得重命名或移动源码文件、不得更改 applicationId 与签名配置等约束。
该技能用于将已有的 Android Kotlin 应用从 Salesforce Mobile SDK 13.x 升级到 14.0,主要面向自主编码智能体使用。每个参考文件都是自包含的,包含精确的源真代码、文件路径和 CLI 命令。适用场景:当用户要求升级 Mobile SDK 版本,或检测到项目中仍在使用 13.x 版本时启用。触发检测规则为:检查 app/build.gradle.kts 中 com.salesforce.mobilesdk: 的版本字符串是否包含 13.,检查 libs.versions.toml 中 salesforceSDK 是否为 "13. 版本字符串;若检测到 SDK 13 且同一文件中未出现 14.,则该技能适用。升级过程附带升级指南、破坏性变更说明和故障排查三类参考文档。升级要求 minSdk 提升到 31,compileSdk 与 targetSdk 至少为 36,Gradle wrapper 须更新到 9.4.1,AGP 须更新到 9.1.1,并需处理 Kotlin 插件与 android.builtInKotlin 标志的兼容配置。
该技能用于将现有 iOS 应用从 Salesforce Mobile SDK 12.x 升级到 13.2.1,主要面向自主编码智能体使用。所有参考文件均为自包含内容,包含确切的源码、文件路径和 CLI 命令。使用前会先检测工作目录:检查 Podfile 中是否包含 pod 'SalesforceSDKCore', '12. 版本字符串、Package.resolved 中是否有版本以 12. 开头的 SalesforceSDKCore、以及 Package.swift 依赖中 SalesforceMobileSDK-iOS-SPM 是否锁定在 12.x 版本。若检测到 SDK 12 且未出现 13 版本(CocoaPods 或 SPM 等价形式),则该技能适用。技能包含主升级流程参考文件 upgrade-12-to-13.md,以及跨领域参考:api-changes.md(记录移除的 API、协议变更、废弃成员和新 API)和 troubleshooting.md(构建、运行时及行为类错误症状)。技能还定义了多项不变量,涉及项目结构、源文件命名、构建设置、部署目标同步、Pods 目录处理以及代码签名参数等,以确保升级过程不破坏既有工程配置。
该技能用于将现有 iOS 应用从 Salesforce Mobile SDK 13.x 升级到 14.0 版本。它面向自主编码代理使用,每个参考文件均自包含,包含可直接使用的权威代码、文件路径与 CLI 命令。技能覆盖升级场景、破坏性变更与故障排查等横向参考,并定义了升级前的检测规则:检查 Podfile 中的 platform :ios 或固定为 13.x 的 pod、检查 project.pbxproj 中 SalesforceMobileSDK-iOS-SPM 的 XCRemoteSwiftPackageReference 版本号,以及检查 project.yml 中的对应版本条目。当检测到 SDK 13 存在且 SDK 14 尚未出现时适用。技能同时规定多项不变量:不得从零重建 Xcode 工程,不得重命名或移动应用源文件,不得修改非 SDK 构建设置,部署目标必须同时在两处同步提升,pod install 后只暂存 .xcworkspace 与 Podfile.lock 而不提交整个 Pods 目录,并禁止向 xcodebuild 传递 CODE_SIGNING_ALLOWED=NO。当技能中的 SDK API 与实际不符时,以上游发布说明与 Objective-C 头文件为准。
用于在生成任何 Salesforce GraphQL 查询前,通过仅 grep 的方式探索 Salesforce GraphQL schema 的技能。schema 文件约 26.5 万行以上,禁止打开、读取、流式或解析,只能用 grep 定位字段、过滤、排序与变更操作。
通过 Data SDK 的 fetch 方法调用 Salesforce REST API 的技能,适用于 GraphQL 无法覆盖的场景,如 Chatter、Connect REST、Apex REST、UI API REST 和 Einstein LLM 调用。SDK 自动处理认证、CSRF 和基础 URL 解析。
用于生成和校验 Salesforce 自定义字段(CustomField)元数据 XML 的技能,重点规避部署报错,尤其针对汇总摘要(Roll-up Summary)与主从关系(Master-Detail)等高频失败字段类型。
用于在 React Web 应用中通过 createRecord API 创建 Salesforce 记录的技能,涵盖自定义对象与标准对象的创建、记录 ID 提取、字段部署与常见错误排查。
用于审查或重构 tRPC 路由代码的技能,重点确保路由结构、类型定义、输入验证与错误处理符合项目最佳实践。适用于代码审查和路由重构阶段,禁止组件层直接使用 tRPC,要求组件通过 Refine hooks 访问数据。
用于扫描或检查项目中 SVG 图标使用情况的技能,可发现并报告不符合规范的写法,覆盖命名、路径与组件化问题,适合代码审查阶段使用。
用于检查项目中是否存在违规的 types.ts/type.ts 文件或手写类型与 Zod schema 重复定义的技能,确保所有类型从 Zod schema 派生。触发词包括检查类型文件、检查types目录、zod类型检查、type.ts检查。
用于清理代码库垃圾代码的技能,可处理未使用导入、注释代码段、console.log、死代码、空函数和重复代码等。触发词包括清理代码、clean code、删除dead code、清除垃圾。
用于创建或重构 DAO 文件时遵循 Drizzle ORM 最佳实践的技能,覆盖文件结构、方法命名、类型安全与性能优化,并在 DAO 写方法完成后强制评估是否需要 Repository。