base-skill

Étoiles2

Forks0

Mis à jour10 mars 2026 à 07:21

在进行仓颉工程或鸿蒙应用开发时的第一步，应该优先读取该SKILL，用来确定后续的开发步骤。

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Exécuter dans Manus

Source

zhenzhizhi12

zhenzhizhi12/NexusAgent

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Exécuter dans Manus

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·SOC 15-1252

SKILL.md

readonly

name	base-skill
description	在进行仓颉工程或鸿蒙应用开发时的第一步，应该优先读取该SKILL，用来确定后续的开发步骤。

公共原则
- 一律使用仓颉编程语言实现功能。
- 严禁「猜语法」，遇到不确定的 API / 语法，必须通过 Skills 或官方文档确认后再写代码。
普通仓颉工程（非鸿蒙应用）
- 当 task.md 中不涉及鸿蒙 UI、ArkUI、HAP 构建等内容，仅是构建纯仓颉项目或命令行程序，遇到查询仓颉知识点的要求时，严格按以下流程工作，每一步都要显式调用对应 Skill，并先阅读该 Skill 的 SKILL.md 说明再执行操作：
  1. 前置学习：在开始写代码前，先读取 .opencode/skills/cangjie-evolution/Evolution.md 了解之前踩过的坑，避免重复犯错。
  2. common-skill-l1：直接优先使用目录.opencode/common-skill-l1 下的基础技能（如 basic_programming_concepts、array、string、std、stdx 等）学习和查询。
  3. 触发条件：当基础 common-skill-l1 无法找到对应知识点、或查到的内容明显过时/不适用于当前场景时，进入下一步。
  4. common-skill-l2：调用 common-skill-l2 Skill，先阅读其 SKILL.md 说明，通过执行 python .opencode/skills/cangjie-dev-harmonyos/scripts/ask_cangjie.py "<核心关键词>" 进行 L1 向量检索。当 L1 检索无结果或结果不相关时，使用 common-skill-l2 Skill 中的 L3 检索逻辑，基于 .opencode/skills/cangjie-dev-harmonyos/scripts/hm-docs/ 目录下的本地官方文档进行全量搜索。
  5. 经验记录：将构建过程中踩到的坑记录到 .opencode/skills/cangjie-evolution/Evolution.md 中（注意：此文件与鸿蒙的 Evolution.md 独立）。
  6. 修复报错：每次修复报错前，先读取 .opencode/skills/cangjie-evolution/Evolution.md 了解之前踩过的坑，避免重复犯错。
  7. 配置文件: 如果你的项目依赖了特定版本或外部模块，请使用工具修改自动生成的 cjpm.toml。如果你的代码中使用了 stdx，你必须强制执行以下步骤，否则编译一定会失败：
    1. 使用文件编辑工具，在当前生成项目的 cjpm.toml 末尾必须完整追加以下依赖声明。
    2. 关键绝对路径拼接：注意你当前所在的工作目录可能是 outputs/<项目名>。你必须基于最外层的工作区根目录（如 D:/Projects/OpenCode/Common-zhichao）来拼接路径，使其绝对指向外层的 stdx/dynamic/stdx。
```
# 示例配置如下：
[target.x86_64-w64-mingw32]
   [target.x86_64-w64-mingw32.bin-dependencies]
      path-option = ["C:/Users/zqw/Desktop/common-cangjie/stdx-for-windows/stdx/dynamic/stdx"]
```
      注意：Windows 系统路径必须使用正斜杠 /。严禁去修改 stdx 文件夹内的任何文件！
    3. 注意：stdx 本地库已预编译完成，无需额外修复版本字段。如果编译时报 stdx 相关错误，请检查路径配置是否正确。
鸿蒙应用开发任务（HarmonyOS + 仓颉）
- 当 task.md 中要求开发鸿蒙应用（如 ArkUI、HAP 构建、module.json5、鸿蒙页面/组件等）时，严格按以下流程工作，每一步都要显式调用对应 Skill，并先阅读该 Skill 的 SKILL.md 说明再执行操作：
  1. 需求分析（L0）：调用 harmonyos-requirement-analysis Skill，先阅读其 SKILL.md 中的需求分析模板与示例，然后按照该 Skill 的流程将业务需求拆解成 UI 组件、数据结构和交互行为，不直接查业务词。
  2. 基础仓颉技能优先：在 L0 分析之后，调用 .opencode/common-skill-l1 中对应的基础技能（如 array、string、function、std、stdx 等 Skill），阅读各自 SKILL.md 的用法说明，再按照其中的示例完成语法、类型和标准库层面的推理与修复。
  3. L1 查询：如需进一步知识检索，调用 harmonyos-l1-query Skill，先阅读该 Skill 的 SKILL.md 中的环境配置、查询策略和脚本路径说明，再通过 .opencode/skills/cangjie-dev-harmonyos/scripts/ask_cangjie.py 按 API 关键字逐个检索。
  4. L3 本地文档搜索：如需进一步知识检索，调用 harmonyos-l3-query Skill，按照其 SKILL.md 中的初始化说明，首次使用或需要确保 L3 文档已初始化时，可以执行 python ask_cangjie.py "test" 生成本地文档树（初始化）；当 L1 无结果或不够时，再根据该 Skill 中给出的路径和搜索命令，基于 .opencode/skills/cangjie-dev-harmonyos/scripts/hm-docs/ 做本地官方文档搜索（UI、语法、stdx 文档），不要直接访问 cangjie-docs-full。
  5. stdx 依赖配置：当鸿蒙工程中需要 stdx 能力或出现 stdx 相关构建错误时，调用 harmonyos-stdx-dependency Skill，先阅读其 SKILL.md，按照其中描述的「解压到 <项目根>/cjnative/stdx + 修改 entry/cjpm.toml bin-dependencies.path-option」的步骤，通过 .opencode/skills/harmonyos-stdx-dependency/ 中的资源自动或半自动完成配置。
  6. 构建与排错：调用 harmonyos-build Skill，严格按照其 SKILL.md 中的说明复制并执行 build.ps1，获取 build-full.log，每一次报错必须必须按文档中规定的优先级：先查 Evolution.md → 再用 .opencode/common-skill-l1 调试→ 再用 harmonyos-l1-query 调试 → 最后用 harmonyos-l3-query 文档，分步处理构建错误。必须注意每一次鸿蒙项目构建报错都要按照skill的要求处理。
  7. 迭代记录：每次构建成功后，调用 harmonyos-evolution Skill，阅读其 SKILL.md 中给出的记录格式和示例，将本次遇到的重要问题与解决方案记录到 .opencode/skills/cangjie-dev-harmonyos/Evolution.md 中，以便在后续项目中迁移复用。

Plus depuis ce dépôt

même dépôt

harmonyos-build

zhenzhizhi12/NexusAgent

当需要构建鸿蒙应用项目时，使用此 Skill 执行构建流程。此 Skill 包含完整的构建命令、构建流程说明、构建失败处理流程。构建脚本会自动执行依赖安装、仓颉预编译、资源生成、编译、打包等步骤。

2026-03-122

harmonyos-stdx-dependency

zhenzhizhi12/NexusAgent

在鸿蒙应用（Cangjie）开发中，当需要使用 stdx 拓展库（如 crypto、encoding、net、log、actors 等），或在构建/链接阶段出现 stdx 相关错误时，使用此 Skill 获取/解压 stdx 包，并指导在 entry/cjpm.toml 中正确配置 bin-dependencies.path-option。

2026-03-122

cangjie-annotation

zhenzhizhi12/NexusAgent

仓颉语言内置注解。当需要了解仓颉 SDK 提供的内置注解（@sourcePackage/@sourceFile/@sourceLine/@When/@FastNative/@Frozen/@Attribute/@Deprecated）的用途、语法和最优实践时，应使用此 Skill。

2026-03-102

cangjie-appendix

zhenzhizhi12/NexusAgent

仓颉语言附录参考。当需要查阅仓颉语言的关键字列表、运算符优先级与结合性、运算符重载函数签名、运行时环境变量配置、包兼容性规则、TokenKind枚举类型时，应使用此 Skill。

2026-03-102

cangjie-std-array

zhenzhizhi12/NexusAgent

仓颉标准库 Array 类型详细指南。当需要了解 Array 的构造、元素访问、切片、拼接、查找、排序、拷贝、反转、映射、扁平化等操作的完整 API 和用法时，应使用此 Skill。

2026-03-102

cangjie-std-arraylist

zhenzhizhi12/NexusAgent

仓颉标准库 ArrayList 类型详细指南。当需要了解 ArrayList 的构造、增删改查、容量管理、切片、排序、迭代、与 Array 互转等操作的完整 API 和用法时，应使用此 Skill。

2026-03-102

name	base-skill
description	在进行仓颉工程或鸿蒙应用开发时的第一步，应该优先读取该SKILL，用来确定后续的开发步骤。

公共原则
- 一律使用仓颉编程语言实现功能。
- 严禁「猜语法」，遇到不确定的 API / 语法，必须通过 Skills 或官方文档确认后再写代码。
普通仓颉工程（非鸿蒙应用）
- 当 task.md 中不涉及鸿蒙 UI、ArkUI、HAP 构建等内容，仅是构建纯仓颉项目或命令行程序，遇到查询仓颉知识点的要求时，严格按以下流程工作，每一步都要显式调用对应 Skill，并先阅读该 Skill 的 SKILL.md 说明再执行操作：
  1. 前置学习：在开始写代码前，先读取 .opencode/skills/cangjie-evolution/Evolution.md 了解之前踩过的坑，避免重复犯错。
  2. common-skill-l1：直接优先使用目录.opencode/common-skill-l1 下的基础技能（如 basic_programming_concepts、array、string、std、stdx 等）学习和查询。
  3. 触发条件：当基础 common-skill-l1 无法找到对应知识点、或查到的内容明显过时/不适用于当前场景时，进入下一步。
  4. common-skill-l2：调用 common-skill-l2 Skill，先阅读其 SKILL.md 说明，通过执行 python .opencode/skills/cangjie-dev-harmonyos/scripts/ask_cangjie.py "<核心关键词>" 进行 L1 向量检索。当 L1 检索无结果或结果不相关时，使用 common-skill-l2 Skill 中的 L3 检索逻辑，基于 .opencode/skills/cangjie-dev-harmonyos/scripts/hm-docs/ 目录下的本地官方文档进行全量搜索。
  5. 经验记录：将构建过程中踩到的坑记录到 .opencode/skills/cangjie-evolution/Evolution.md 中（注意：此文件与鸿蒙的 Evolution.md 独立）。
  6. 修复报错：每次修复报错前，先读取 .opencode/skills/cangjie-evolution/Evolution.md 了解之前踩过的坑，避免重复犯错。
  7. 配置文件: 如果你的项目依赖了特定版本或外部模块，请使用工具修改自动生成的 cjpm.toml。如果你的代码中使用了 stdx，你必须强制执行以下步骤，否则编译一定会失败：
    1. 使用文件编辑工具，在当前生成项目的 cjpm.toml 末尾必须完整追加以下依赖声明。
    2. 关键绝对路径拼接：注意你当前所在的工作目录可能是 outputs/<项目名>。你必须基于最外层的工作区根目录（如 D:/Projects/OpenCode/Common-zhichao）来拼接路径，使其绝对指向外层的 stdx/dynamic/stdx。
```
# 示例配置如下：
[target.x86_64-w64-mingw32]
   [target.x86_64-w64-mingw32.bin-dependencies]
      path-option = ["C:/Users/zqw/Desktop/common-cangjie/stdx-for-windows/stdx/dynamic/stdx"]
```
      注意：Windows 系统路径必须使用正斜杠 /。严禁去修改 stdx 文件夹内的任何文件！
    3. 注意：stdx 本地库已预编译完成，无需额外修复版本字段。如果编译时报 stdx 相关错误，请检查路径配置是否正确。
鸿蒙应用开发任务（HarmonyOS + 仓颉）
- 当 task.md 中要求开发鸿蒙应用（如 ArkUI、HAP 构建、module.json5、鸿蒙页面/组件等）时，严格按以下流程工作，每一步都要显式调用对应 Skill，并先阅读该 Skill 的 SKILL.md 说明再执行操作：
  1. 需求分析（L0）：调用 harmonyos-requirement-analysis Skill，先阅读其 SKILL.md 中的需求分析模板与示例，然后按照该 Skill 的流程将业务需求拆解成 UI 组件、数据结构和交互行为，不直接查业务词。
  2. 基础仓颉技能优先：在 L0 分析之后，调用 .opencode/common-skill-l1 中对应的基础技能（如 array、string、function、std、stdx 等 Skill），阅读各自 SKILL.md 的用法说明，再按照其中的示例完成语法、类型和标准库层面的推理与修复。
  3. L1 查询：如需进一步知识检索，调用 harmonyos-l1-query Skill，先阅读该 Skill 的 SKILL.md 中的环境配置、查询策略和脚本路径说明，再通过 .opencode/skills/cangjie-dev-harmonyos/scripts/ask_cangjie.py 按 API 关键字逐个检索。
  4. L3 本地文档搜索：如需进一步知识检索，调用 harmonyos-l3-query Skill，按照其 SKILL.md 中的初始化说明，首次使用或需要确保 L3 文档已初始化时，可以执行 python ask_cangjie.py "test" 生成本地文档树（初始化）；当 L1 无结果或不够时，再根据该 Skill 中给出的路径和搜索命令，基于 .opencode/skills/cangjie-dev-harmonyos/scripts/hm-docs/ 做本地官方文档搜索（UI、语法、stdx 文档），不要直接访问 cangjie-docs-full。
  5. stdx 依赖配置：当鸿蒙工程中需要 stdx 能力或出现 stdx 相关构建错误时，调用 harmonyos-stdx-dependency Skill，先阅读其 SKILL.md，按照其中描述的「解压到 <项目根>/cjnative/stdx + 修改 entry/cjpm.toml bin-dependencies.path-option」的步骤，通过 .opencode/skills/harmonyos-stdx-dependency/ 中的资源自动或半自动完成配置。
  6. 构建与排错：调用 harmonyos-build Skill，严格按照其 SKILL.md 中的说明复制并执行 build.ps1，获取 build-full.log，每一次报错必须必须按文档中规定的优先级：先查 Evolution.md → 再用 .opencode/common-skill-l1 调试→ 再用 harmonyos-l1-query 调试 → 最后用 harmonyos-l3-query 文档，分步处理构建错误。必须注意每一次鸿蒙项目构建报错都要按照skill的要求处理。
  7. 迭代记录：每次构建成功后，调用 harmonyos-evolution Skill，阅读其 SKILL.md 中给出的记录格式和示例，将本次遇到的重要问题与解决方案记录到 .opencode/skills/cangjie-dev-harmonyos/Evolution.md 中，以便在后续项目中迁移复用。