# skills **Repository Path**: wangluyao1024/skills ## Basic Information - **Project Name**: skills - **Description**: 一个关于OpenHarmony开发相关的skill仓库,注意此仓库下的skill之间含有依赖关系 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-03-09 - **Last Updated**: 2026-03-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # OpenHarmony 开发技能集合 这是一个为 OpenHarmony 开发设计的 Claude 技能集合,提供了一系列专业化的工作流程和工具,涵盖编译、测试、设备通信、崩溃分析、环境配置等开发全流程。 > ⭐ **快速上手提示**:推荐直接使用 **openharmony-dev-workflow** 通用技能,它能够自动协调所有必要技能,提供完整的开发流程管理。详见下方 [openharmony-dev-workflow 详细使用指南](#openharmony-dev-workflow-详细使用指南)。 --- ## 技能列表 ### 1. openharmony-cross-compile **OpenHarmony 交叉编译** 为 OpenHarmony ARM 设备编译可执行二进制程序。 **主要功能:** - ARM64 和 ARMv7 架构支持 - C/C++ 程序编译 - 静态链接优化 - 部署到设备 **使用场景:** - 编译 C/C++ 程序 - 构建原生二进制文件 - 创建独立可执行文件 --- ### 2. openharmony-build **OpenHarmony 项目编译** 编译整个项目、编译特定模块、TDD 测试编译、代码修改后快速重编译或生成 compile_commands.json。 **主要功能:** - 整个项目编译 - 单个模块编译 - TDD 测试编译 - 快速重编译(未修改 BUILD.gn 时) - 自动推送 .so 文件到设备 **使用场景:** - 编译模块或目标 - 编译 TDD 测试 - 代码修改后快速重编译 - 生成 compile_commands.json 供 IDE 使用 --- ### 3. openharmony-tdd-test **OpenHarmony TDD 测试编写** 基于 GN 构建系统和 GoogleTest 的单元测试规范。 **主要功能:** - 测试文件模板和命名规范 - BUILD.gn 测试目标配置 - Mock 对象实现 - 测试运行和验证 - TDD 测试框架集成 - 测试报告解析 **使用场景:** - 编写测试、创建 BUILD.gn 目标 - 实现 Mock 对象 - 运行测试并验证结果 - 调试测试失败(mock 错误、链接错误) **注意:** 编译使用 openharmony-build skill,崩溃问题使用 openharmony-crash-analyzer skill。 --- ### 4. hdc-tool **OpenHarmony Device Connector (HDC)** 设备通信工具,用于在 OpenHarmony 设备上传输文件和执行 shell 命令。 **主要功能:** - 检查设备连接 - 文件传输(发送/接收) - 执行 shell 命令 - 应用管理 - 日志与调试 **使用场景:** - 传输文件到/从设备 - 在 OpenHarmony 设备上执行 shell 命令 --- ### 5. openharmony-crash-analyzer **OpenHarmony 崩溃分析专家** 分析应用崩溃,包括 Signal 11 (SIGSEGV)、Signal 6 (SIGABRT)、段错误和内存访问问题。 **主要功能:** - 识别崩溃类型 - 获取崩溃日志 - 正向反汇编分析 - 堆栈跟踪分析 - 根本原因识别 **使用场景:** - 遇到崩溃、信号问题 - 分析设备崩溃日志 - TDD 测试崩溃分析 --- ### 6. openharmony-env-setup **OpenHarmony 环境配置** 为新开发环境配置 OpenHarmony 开发环境。 **主要功能:** - 配置环境变量(HDC_HOME、TDD_TEST_ENV、OHOS_PROJECT_PATH、OHOS_OUTPUT_PATH、PRODUCT_NAME、OHOS_DOCS_PATH) - 验证环境配置 - 克隆文档仓库(自动克隆 oh_agent_docs 到 OHOS_DOCS_PATH) - TDD 环境设置 - 故障排除 **使用场景:** - 设置 OpenHarmony 开发环境 - 配置环境变量 - 验证环境配置 - 克隆文档仓库到指定目录 - 排查环境设置问题 --- ### 7. git-commit-pusher **Git 仓库提交和推送自动化** 支持自动生成提交消息和添加 Signed-off-by 署名。 **主要功能:** - 分析仓库状态 - 验证提交消息(包含 Signed-off-by 和 Co-Authored-By: Agent) - 生成提交消息 - 处理合并冲突 - 推送到远程仓库 **使用场景:** - 提交 Git 仓库的更改 - 需要描述性提交消息(总结更改和受影响的文件) - 添加 Signed-off-by 署名 - 推送提交到远程仓库 - 处理合并冲突 --- ### 8. openharmony-doc-generator **OpenHarmony 文档生成器** 为 OpenHarmony 模块生成完整的文档,包括递归依赖分析。 **主要功能:** - 在 $OHOS_DOCS_PATH 目录创建文档 - 分析 bundle.json 依赖关系 - 生成所有依赖仓库的文档 - 创建模块索引文件 - 使用并发子代理读取项目和生成文档 **使用场景:** - 为 OpenHarmony 模块生成文档 - 分析模块依赖关系 - 创建模块索引和分类列表 **注意:** 需要用户明确确认后才执行文档生成。 --- ### 9. openharmony-doc-query **OpenHarmony 文档查询系统** 通过索引系统查询模块文档,查找使用模式和 API 参考。 **主要功能:** - 查询模块文档 - 查找特定模块的使用模式 - 理解模块 API 和接口 - 引用模块特定文档 **使用场景:** - 当前项目缺少参考代码时 - 需要理解模块 API 或接口 - 需要引用模块特定文档 - 查找特定 OpenHarmony 模块的使用模式 **注意:** 此技能仅返回参考文档,不执行命令。 --- ### 10. openharmony-repo-finder **OpenHarmony 仓库路径查找器** 在 OpenHarmony 代码库中定位组件的源代码仓库。 **主要功能:** - 查找组件所属子系统 - 定位组件的源代码路径 - 查询 rich.json 和 subsystem_config.json **使用场景:** - 查找组件的源代码位置 - 确定组件所属子系统 - 导航到组件的源代码 - 调试或分析特定组件实现 **注意:** 此技能仅返回路径信息,不执行命令。 --- ### 11. skill-creator **技能创建指南** 用于创建有效技能的指南,扩展 Claude 的能力。 **主要功能:** - 技能创建流程 - 设计原则 - 资源组织(scripts、references、assets) - 技能打包和分发 **使用场景:** - 创建新技能 - 更新现有技能 - 扩展 Claude 的能力 ### 12. openharmony-dev-workflow ⭐ 核心技能 **OpenHarmony 开发流程协调器** > 💡 **这是本技能集合的核心技能**,推荐 OpenHarmony 开发任务使用此技能。它能够自动协调其他技能,提供完整的开发流程管理。 **主要功能:** - **单Agent模式(简单任务)**:小bug修复、简单功能添加、配置修改 - **多Agent模式(复杂任务)**:重要新功能、架构变更、全面测试覆盖 - **自动化工作流程**:Phase 0 → Phase 9(简单任务)或 Phase 0 → Phase 7(复杂任务) - **子Agent协作**:功能开发Agent、测试开发Agent - **质量保证**:自动代码格式化、编译验证、测试执行、代码审查 - **用户确认节点**:Phase 2 设计确认、最终代码审查 **工作流程阶段:** - **Phase 0**: 环境检查 - 验证必需的环境变量 - **Phase 1**: Git分支管理 - 创建功能分支 - **Phase 2**: 方案设计 - 分析需求并设计方案 - **Phase 2.1**: 设计确认 - 获取用户批准 - **Phase 3**: 功能开发 - 实现功能代码 - **Phase 4**: 编译功能代码 - 验证编译通过 - **Phase 5**: 测试开发 - 编写TDD测试 - **Phase 6**: 编译测试代码 - 验证测试编译 - **Phase 7**: 执行测试 - 运行测试并验证 - **Phase 8**: 代码审查 - 审查代码质量 - **Phase 9**: 合并回原分支 - 完成开发 **参考文档结构:** - `references/workflows/` - 工作流程说明 - `references/agents/` - Agent通信格式和指令 - `references/phases/` - 各阶段详细说明 --- ## 开发工作流程 ### 推荐的skill安装流程 1. cd ~/.claude 2. 克隆skill仓库并保存为skills文件夹 3. 获取更新,cd到skills目录内执行git pull ### 典型的 OpenHarmony 开发流程 #### ⭐ 方式一:使用开发流程协调器(强烈推荐) **加载 openharmony-dev-workflow skill** 这是最简单、最推荐的方式,适合所有开发任务。 **优势:** - 一键启动完整开发流程 - 自动协调所有必要技能 - 标准化质量检查 - 减少人为错误 - 适合新手和资深开发者 **使用方法:** ``` 加载 openharmony-dev-workflow skill ``` 系统会自动: 1. 要求选择任务复杂度(简单/复杂) 2. 根据选择加载相应工作流程 3. 指导完成完整开发周期(环境→设计→开发→测试→审查→提交) #### 方式二:手动使用各独立技能(适合特定场景) 仅在以下情况使用手动方式: - 只需要某个特定技能的功能(如仅编译、仅查询文档) - 非常熟悉各技能,需要自定义流程 - 特殊需求无法被工作流程覆盖 #### 方式二:手动使用各独立技能 1. **环境配置** (openharmony-env-setup) - 配置开发环境变量 - 克隆文档仓库到 OHOS_DOCS_PATH - 设置 TDD 测试环境 2. **方案设计** (brainstorming) - 澄清需求和设计 3. **查询文档** (openharmony-doc-query + openharmony-repo-finder) - 查询模块文档(如需要) - 查找组件源代码(如需要) 4. **编译项目** (openharmony-build) - 编译整个项目或特定模块 - 快速重编译 5. **编写测试** (openharmony-tdd-test) - 创建测试文件 - 实现 Mock 对象 - 配置 BUILD.gn 6. **编译测试** (openharmony-build) - 编译 TDD 测试 7. **运行测试** (openharmony-tdd-test + hdc-tool) - 推送测试二进制到设备 - 运行测试并验证结果 8. **调试问题** (openharmony-crash-analyzer) - 分析崩溃日志 - 定位根本原因 9. **生成文档** (openharmony-doc-generator) - 为模块生成文档(如需要) - 分析依赖关系 10. **提交代码** (git-commit-pusher) - 生成提交消息 - 验证提交格式 - 推送到远程仓库 --- ## 技能协作关系 ``` ┌─────────────────────────────────────────────────────────┐ │ openharmony-dev-workflow(核心协调器)⭐ │ │ │ │ 统一管理完整开发周期,自动协调所有必要技能 │ └────────────────────┬────────────────────────────────────┘ │ ┌────────────┼────────────┐ ▼ ▼ ▼ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ 基础技能 │ │开发技能 │ │ 其他技能 │ └─────────┘ └─────────┘ └─────────┘ │ │ │ ┌────┴────┐ ┌────┴────┐ ┌────┴────┐ ▼ ▼ ▼ ▼ ▼ ▼ env-setup build tdd-test cross-compile repo-finder │ │ │ doc-generator doc-query │ │ │ skill-creator │ ▼ │ hdc-tool crash-analyzer ``` --- ## openharmony-dev-workflow 详细使用指南 ### 使用流程 #### 第一步:加载技能 ``` 加载 openharmony-dev-workflow skill ``` #### 第二步:选择任务复杂度 技能会自动询问: ``` 请选择任务复杂度: 1. 简单任务(单Agent模式) - 小bug修复(1-2个文件,<100行代码) - 简单功能添加(直接实现) - 配置或文档修改 - 调试现有问题 - 快速补丁或热修复 2. 复杂任务(多Agent模式) - 重要新功能(多个新文件、重大重构) - 复杂业务逻辑或架构变更 - 需要全面测试覆盖 - 跨组件或跨子系统依赖 - 用户明确要求多Agent方式 请选择 1 或 2: ``` **选择建议:** - 不确定或首次使用 → 选择 1(简单任务) - 涉及多个文件或复杂逻辑 → 选择 2(复杂任务) - 需要全面测试覆盖 → 选择 2(复杂任务) #### 第三步:自动执行工作流程 根据您的选择,技能会自动: **简单任务(单Agent模式):** 1. 环境检查 2. 创建Git功能分支 3. 方案设计(需要您确认) 4. 功能开发 5. 编译功能代码 6. 测试开发 7. 编译测试代码 8. 执行测试 9. 代码审查 10. 合并回原分支 **复杂任务(多Agent模式):** 1. 环境检查 2. 创建Git功能分支 3. 方案设计(需要您确认) 4. 委托功能开发Agent(开发+编译) 5. 实现验证 6. 委托测试开发Agent(测试+编译+运行) 7. 最终代码审查(需要您确认) 8. 合并回原分支 ### 实际使用示例 #### 示例1:修复小Bug(简单任务) ``` 用户:帮我修复 account_os_account 模块中的崩溃问题 系统:加载 openharmony-dev-workflow skill 系统:请选择任务复杂度: 1. 简单任务(单Agent模式) 2. 复杂任务(多Agent模式) 用户:1 系统:[自动执行] ✓ 环境检查通过 ✓ 创建功能分支 feature/20260309-143000 ✓ 定位问题(使用 openharmony-repo-finder) ✓ 分析崩溃原因(使用 openharmony-crash-analyzer) ✓ 输出修复方案 系统:请审查修复方案并确认 用户:确认 系统:[自动执行] ✓ 实现修复代码 ✓ 格式化代码(.clang-format) ✓ 编译功能代码(使用 openharmony-build) ✓ 编写测试用例(使用 openharmony-tdd-test) ✓ 编译测试代码 ✓ 运行测试 - 全部通过 ✓ 代码审查通过 ✓ 合并回原分支 系统:✓ Bug修复完成! ``` #### 示例2:实现新功能(复杂任务) ``` 用户:为系统服务添加用户认证功能 系统:加载 openharmony-dev-workflow skill 系统:请选择任务复杂度: 1. 简单任务(单Agent模式) 2. 复杂任务(多Agent模式) 用户:2 系统:[自动执行] ✓ 环境检查通过 ✓ 创建功能分支 feature/20260309-150000 ✓ 加载 brainstorming skill ✓ 分析需求并设计架构 ✓ 查询相关文档(使用 openharmony-doc-query) ✓ 输出完整功能设计 系统:请审查功能设计并确认 用户:[提供反馈]:建议使用JWT令牌而不是Session 系统:[根据反馈修订设计] ✓ 更新设计文档 系统:请审查更新后的设计并确认 用户:确认 系统:[委托功能开发Agent] ✓ 实现认证管理器类 ✓ 实现登录/注销服务 ✓ 实现JWT令牌处理 ✓ 格式化代码 ✓ 编译功能代码 ✓ 返回实现摘要 系统:[实现验证] ✓ 审查实现完整性 ✓ 验证架构匹配 ✓ 验证API暴露 系统:[委托测试开发Agent] ✓ 编写认证单元测试 ✓ 创建Mock对象 ✓ 编写集成测试 ✓ 编译测试代码 ✓ 运行测试 - 全部通过 ✓ 返回测试摘要 系统:请进行最终代码审查 用户:审查通过 系统:[自动执行] ✓ 合并功能分支 ✓ 清理临时分支 系统:✓ 功能开发完成! ``` ### 关键特性说明 #### 1. 自动技能协调 技能会根据需要自动加载和协调以下技能: - `openharmony-env-setup` - 环境配置 - `openharmony-repo-finder` - 仓库查找 - `openharmony-doc-query` - 文档查询 - `openharmony-build` - 代码编译 - `openharmony-tdd-test` - 测试开发 - `openharmony-crash-analyzer` - 崩溃分析 - `hdc-tool` - 设备通信 #### 2. 质量检查点 在关键节点进行质量检查: - **Phase 2**: 设计审查 - 确保方案合理 - **Phase 4**: 编译检查 - 确保代码可编译 - **Phase 6**: 测试编译检查 - 确保测试可编译 - **Phase 7**: 测试执行 - 确保功能正确 - **Phase 8**: 代码审查 - 确保代码质量 #### 3. 错误处理 遇到错误时自动处理: - **编译失败** → 自动修复并重新编译 - **测试失败** → 自动分析并修复 - **崩溃问题** → 使用崩溃分析工具定位 - **设计问题** → 要求反馈并修订设计 #### 4. 用户确认 在关键节点要求用户确认: - 方案设计确认 - 最终代码审查确认 确保开发方向正确,减少返工。 ### 最佳实践 1. **首次使用建议从简单任务开始**,熟悉流程后再使用复杂任务模式 2. **在设计确认阶段仔细审查方案**,避免后续返工 3. **保持环境变量正确配置**,这是流程成功的基础 4. **关注自动化测试的覆盖率**,确保功能质量 5. **定期检查Git状态**,确认分支和提交正确 ### 与其他技能的关系 ``` openharmony-dev-workflow(协调器) ↓ 自动调用 ├── openharmony-env-setup(环境配置) ├── openharmony-repo-finder(仓库查找) ├── openharmony-doc-query(文档查询) ├── openharmony-build(编译) ├── openharmony-tdd-test(测试) ├── openharmony-crash-analyzer(崩溃分析) └── hdc-tool(设备通信) ``` **何时单独使用其他技能:** - 只需编译项目 → 使用 `openharmony-build` - 只需查询文档 → 使用 `openharmony-doc-query` - 只需分析崩溃 → 使用 `openharmony-crash-analyzer` - 只需配置环境 → 使用 `openharmony-env-setup` - 其他特定场景 **何时使用 openharmony-dev-workflow:** - 完整的开发任务 - 需要多步骤的开发流程 - 需要质量保证的开发任务 - 不确定使用哪些技能时 --- ## 快速开始 ### 🚀 首次使用(推荐方式) 1. 开发环境准备: 确保当前的设备环境为Ubuntu22.04(如果是windows设备,请安装wsl2+Ubuntu22.04) - 拉取OpenHarmony源码,推荐参考:[官方文档](https://gitcode.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/sourcecode-acquire.md) - 配置好了OpenHarmony编译环境,推荐参考: [三方博客](https://forums.openharmony.cn/forum.php?mod=viewthread&tid=897) 1. 配置开发环境(首次): ``` 加载 openharmony-env-setup skill ``` 系统会自动: - 配置必需的环境变量 - 克隆文档仓库到 OHOS_DOCS_PATH - 设置 TDD 测试环境(可选) 2. 开始开发任务: ``` 加载 openharmony-dev-workflow skill ``` 3. 系统会自动引导完成: - 选择任务复杂度(简单/复杂) - 环境检查 - 方案设计(需要确认) - 功能开发 - 测试开发 - 代码审查 - 合并提交 --- ## 贡献指南 如需添加新技能或改进现有技能: 1. 参考 skill-creator 技能了解创建流程 2. 遵循现有技能的命名和组织规范 3. 使用中文描述和文档 4. 确保技能之间的协作关系清晰 --- ## 许可证 请查看各个技能目录中的 LICENSE.txt 文件了解具体许可信息。