工作流程

1. 语法问题

User Question -> Identify Question Type -> Consult Documentation -> Provide Code Example

常见语法问题：

• 变量声明 -> 使用带有显式类型或类型推断的 let/const
• 函数定义 -> 支持可选参数、默认值、剩余参数、箭头函数
• 类和接口 -> 必须初始化字段，支持继承和实现
• 泛型 -> 支持约束和默认值
• 空安全 -> 可空类型 ((T | null))、非空断言 ((!))、可选链 ((?.))

2. TypeScript 迁移

Identify TS Code -> Check Incompatible Features -> Consult Migration Rules -> Provide ArkTS Alternative

关键迁移规则速查：

3. 性能优化

Analyze Code -> Identify Performance Issues -> Consult Optimization Guide -> Provide Solutions

高性能编程要点：

• 声明：对常量使用 const；避免混合整数和浮点数
• 循环：提取循环不变量；避免数值溢出
• 函数：优先使用参数传递而非闭包；避免可选参数
• 数组：对数值使用 TypedArray；避免稀疏数组和联合类型数组
• 异常：避免在循环中抛出异常；使用返回值替代

4. 编译错误解决

Get Error Message -> Search Migration Rules -> Find Related Case -> Provide Fix

常见问题

Q: 如何处理 JSON.parse 的返回值？

// 错误
let data = JSON.parse(str);

// 正确
let data: Record<string, Object> = JSON.parse(str);

Q: 如何定义对象类型？

// TypeScript 语法 (ArkTS 不支持)
type Person = { name: string, age: number }

// ArkTS 语法
interface Person {
  name: string;
  age: number;
}

// 使用对象字面量
let p: Person = { name: 'John', age: 25 };

Q: 如何替换 globalThis？

// 错误
globalThis.value = 'xxx';

// 使用单例模式
export class GlobalContext {
  private constructor() {}
  private static instance: GlobalContext;
  private _objects = new Map<string, Object>();

  public static getContext(): GlobalContext {
    if (!GlobalContext.instance) {
      GlobalContext.instance = new GlobalContext();
    }
    return GlobalContext.instance;
  }

  getObject(key: string): Object | undefined {
    return this._objects.get(key);
  }

  setObject(key: string, value: Object): void {
    this._objects.set(key, value);
  }
}

Q: 如何处理 catch 中的错误类型？

// 错误
try {} catch (e: BusinessError) {}

// 正确
try {} catch (error) {
  let e: BusinessError = error as BusinessError;
}

Q: 如何使用 Record 类型？

// TypeScript 索引签名
function foo(data: { [key: string]: string }) {}

// ArkTS Record
function foo(data: Record<string, string>) {}

// 使用示例
let map: Record<string, number> = {
  'John': 25,
  'Mary': 21,
};

Q: 如何用工厂函数替换构造函数签名？

// TypeScript 构造函数签名
type ControllerCtor = {
  new (value: string): Controller;
}

// ArkTS 工厂函数
type ControllerFactory = () => Controller;

class Menu {
  createController: ControllerFactory = () => {
    return new Controller('default');
  }
}

禁止使用的标准库 API

以下 API 在 ArkTS 中被禁止使用：

• Global：eval
• Object：__proto__、defineProperty、freeze、getPrototypeOf 等
• Reflect：apply、construct、defineProperty 等
• Proxy：所有处理器方法

构建脚本

scripts 目录提供了 ArkTS 项目的快速编译脚本（包括依赖安装）：

使用方法：

# macOS/Linux
bash scripts/run.sh

# Windows PowerShell
.\scripts\run.ps1

脚本执行步骤：

1. 安装依赖 (ohpm install --all)
2. 构建项目 (hvigorw assembleApp)

强制性要求

重要：当此技能生成 ArkTS 代码时，必须遵循以下工作流程：

1. 编译验证：生成代码后，必须使用构建脚本编译项目：

   • macOS/Linux：bash scripts/run.sh
   • Windows：.\scripts\run.ps1

2. 重试策略：如果编译失败：

   • 分析错误输出
   • 修复问题并重试编译
   • 最多进行 3 次编译尝试

3. 用户干预：在 3 次编译尝试失败后，使用 AskUserQuestion：

   Question: Compilation failed after 3 attempts. How would you like to proceed?
   Options:
   - Continue retrying (attempt another fix)
   - Manual intervention (I'll wait for your guidance)
   - Skip compilation (proceed without verification)
   

4. 错误报告：当发生失败时，始终显示完整的编译错误输出。

回答指南

1. 优先提供代码示例：展示正确与错误语法的对比
2. 参考官方文档：对于详细解释，引导用户查阅 references/ 中的相应文档
3. 解释原因：解释 ArkTS 为何有此限制（性能、稳定性）
4. 提供替代方案：对于不支持的功能，提供可行的替代方案

许可证

MIT 许可证 - 参见 LICENSE.txt

每周安装量

182

代码仓库

summerkaze/skil…ssistant

GitHub Stars

35

首次出现

Jan 29, 2026

安全审计

Gen Agent Trust HubFailSocketPassSnykPass

安装于

opencode168

codex161

gemini-cli157

github-copilot150

kimi-cli148

amp148