harmony-skills-standalone 1.0.0

package/autotest-agent/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: autotest-agent
+description: Run the repository AutoTestAgent for a declared test-execution workflow node.
+---
+
+# AutoTest Agent Bridge
+
+Use the checked-in `SubAgents/AutoTestAgent-master` implementation to execute the
+test intent or test-case input named in the prompt.
+
+- Verify the device and HAP prerequisites before execution.
+- Never fabricate device interaction, screenshots, pass counts, or reports.
+- Preserve the AutoTestAgent raw report under the declared node output directory.
+- Write the declared `result` output as valid JSON containing the real command,
+  device, case totals, pass/fail counts, report paths, and blocking reason.
+- Emit structured JSON progress lines during setup, execution, attribution, and
+  report generation.
+- Fail when required device or application prerequisites are unavailable.

package/deveco-cli/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: deveco-cli
+description: Use DevEco CLI for HarmonyOS application creation, build, deployment, devices, emulators, logs, local documentation, UI inspection, and DevEco MCP setup. Use when a workspace contains build-profile.json5 or oh-package.json5, or the task mentions HarmonyOS, ArkTS, ArkUI, DevEco, HDC, Hvigor, HarmonyOS UI inspection, or HarmonyOS documentation.
+source: https://gitcode.com/openharmony-sig/deveco-cli
+upstream_version: 0.4.0
+---
+
+# DevEco CLI
+
+`devecocli` is the preferred entry point for the DevEco Studio toolchain. It wraps
+Hvigor, OHPM, HDC, emulators, logs, documentation search, UI inspection, Skill
+installation, and the bundled DevEco MCP server.
+
+## Operating rules
+
+- Run commands from the HarmonyOS project root containing `build-profile.json5`.
+- Prefer `devecocli` to manually assembling Hvigor/HDC commands.
+- Ask for a device selector when multiple devices are connected.
+- Do not repeatedly retry emulator image downloads, license prompts, or emulator
+  creation failures. Report the required user action.
+- Use `--uninstall` when installation fails because signing information differs.
+- Treat build, install, launch, emulator mutation, and package installation as
+  external operations that require the normal workspace authorization.
+
+## Common workflow
+
+```bash
+devecocli device list
+devecocli build
+devecocli run --device <name-or-serial>
+devecocli log --level E --from 5m --tail 200
+```
+
+Useful commands:
+
+| Goal | Command |
+|---|---|
+| Build default product | `devecocli build` |
+| Build modules | `devecocli build --modules entry feature` |
+| Release build | `devecocli build --build-mode release` |
+| Clean | `devecocli build clean` |
+| Build/install/launch | `devecocli run` |
+| Resolve signing mismatch | `devecocli run --uninstall` |
+| List devices | `devecocli device list` |
+| Device details | `devecocli device view -t <serial>` |
+| Crash logs | `devecocli log --crash --bundle-name <bundle>` |
+| Error logs | `devecocli log --level E --from 5m --tail 200` |
+| Search docs | `devecocli docs search <keywords...>` |
+| Read docs | `devecocli docs read <document-id>` |
+| UI tree | `devecocli ui layout --format json` |
+| Screenshot | `devecocli ui screenshot --path <output.png>` |
+| Windows | `devecocli ui window list --format json` |
+
+## DevEco MCP
+
+Start the bundled stdio MCP server with:
+
+```bash
+PROJECT_PATH=/absolute/path/to/project devecocli serve mcp
+```
+
+The MCP server currently exposes ArkTS and C/C++ diagnostic tools. The broader
+build, run, device, log, docs, and UI commands remain CLI capabilities directed by
+this Skill unless the installed MCP version explicitly advertises additional tools.
+
+Supported environment variables:
+
+- `PROJECT_PATH`: HarmonyOS project root. Required for deterministic project binding.
+- `DEVECO_PATH`: optional explicit DevEco Studio installation path.
+- `NODE_MAX_OLD_SPACE_SIZE`: optional Node memory limit; use `8192` for large projects.
+- `DEBUG=1`: emit MCP/toolchain diagnostics.
+
+Agent configuration can also be generated by DevEco CLI:
+
+```bash
+devecocli init --mcp --agent codex --project /absolute/path/to/project
+```
+
+## Setup and maintenance
+
+```bash
+devecocli init --skill --agent <agent>
+devecocli skills list --long
+devecocli skills find <keyword>
+devecocli update
+```
+
+For emulator license agreements, use an interactive terminal, or explicitly run
+`devecocli emulator license accept` in an approved non-interactive workflow.
+
+This local Skill is derived from the official OpenHarmony SIG DevEco CLI Skill.
+Consult the upstream repository when CLI behavior changes.

package/htrace-converter/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: htrace-converter
+description: >
+  将鸿蒙 HarmonyOS trace 文件（.htrace、.ftrace）转换为 SQLite .db 格式。
+  当用户提到"转换 htrace"、"convert htrace"、"htrace 转 db"、"ftrace 转 db"、
+  "trace_streamer"、"解析 trace 文件"时使用。
+---
+
+# HTrace 文件转换工具
+
+将 HarmonyOS 抓取的 `.htrace` 或 `.ftrace` trace 文件，通过 `trace_streamer` 工具转换为可查询的 SQLite `.db` 格式，以便后续分析使用。
+
+## 使用方式
+
+| 命令 | 说明 |
+|------|------|
+| `/htrace-converter <trace文件路径>` | 转换指定 trace 文件为 .db |
+| `/htrace-converter install` | 安装/更新 trace_streamer 到系统 PATH |
+| `/htrace-converter check` | 检查当前环境中 trace_streamer 是否可用 |
+
+## 执行步骤
+
+### 步骤一：环境检查
+
+检查 `trace_streamer` 是否可用，按以下顺序查找：
+
+1. **系统 PATH**：`which trace_streamer_mac`（或对应平台名）
+2. **当前目录**：`./trace_streamer_binary/<平台二进制名>`
+3. **上级目录**：`../trace_streamer_binary/<平台二进制名>`
+4. **应用包内**（macOS）：`<jar所在目录>/../trace_streamer/<平台二进制名>`
+
+检测当前平台：
+
+```bash
+uname -s
+```
+
+平台到二进制名的映射：
+- `Darwin`（macOS）→ `trace_streamer_mac`
+- `Linux` → `trace_streamer_linux`
+- `MINGW*` / `CYGWIN*`（Windows）→ `trace_streamer_windows.exe`
+
+### 步骤二：安装 trace_streamer（仅 `/htrace-converter install` 时执行）
+
+从 [华为 SmartPerf-Host 项目](https://gitee.com/openharmony/developtools_smartperf_host/releases) 或随 trace-analyzer 一起发布的 `trace_streamer_binary` 目录中获取二进制文件。
+
+安装步骤：
+1. 从 trace-analyzer 项目的 `trace_streamer_binary/` 目录复制对应平台二进制到 `/usr/local/bin/`
+2. 赋予执行权限：`chmod +x /usr/local/bin/trace_streamer_<platform>`
+3. 验证：运行 `trace_streamer_mac --version`（或对应名称）
+
+**也可以直接配置环境变量指向 `trace_streamer_binary/` 目录，无需复制到系统 PATH。**
+
+### 步骤三：执行转换
+
+确认以下信息：
+- **输入文件**：`.htrace` 或 `.ftrace` 文件路径
+- **输出路径**（可选）：默认输出到系统临时目录 `/tmp/trace-analyzer/<basename>.htrace_db`
+
+执行转换命令：
+
+```bash
+# macOS
+trace_streamer_mac <input.htrace> -e <output.db>
+
+# Linux
+trace_streamer_linux <input.htrace> -e <output.db>
+
+# Windows
+trace_streamer_windows.exe <input.htrace> -e <output.db>
+```
+
+**缓存策略**：如果输出 `.db` 文件已存在且比输入文件更新，跳过转换直接使用缓存。
+
+### 步骤四：验证结果
+
+转换完成后验证 `.db` 文件：
+
+```bash
+# 检查文件存在且非空
+ls -lh <output.db>
+
+# 验证是有效的 SQLite 文件（可选）
+sqlite3 <output.db> ".tables" 2>/dev/null | head -5
+```
+
+### 步骤五：输出结果
+
+成功后告知用户：
+
+```
+转换完成！
+
+输入文件: /path/to/input.htrace
+输出文件: /tmp/trace-analyzer/input.htrace_db
+文件大小: XX MB
+
+可使用以下工具继续分析：
+  - trace-analyzer <output.db> -m <线程名>   # 卡顿/完成时延分析
+  - sqlite3 <output.db>                      # 直接查询数据库
+```
+
+## 错误处理
+
+| 错误情况 | 处理方式 |
+|----------|----------|
+| 输入文件不存在 | 提示用户确认文件路径 |
+| trace_streamer 不存在 | 引导用户运行 `/htrace-converter install` |
+| 转换失败（非零退出码） | 显示完整错误输出，建议检查文件是否损坏 |
+| 输出目录无写权限 | 建议用户指定其他输出路径 |
+
+## 说明
+
+- `trace_streamer` 是华为开源的 HarmonyOS trace 解析工具，来自 [SmartPerf-Host](https://gitee.com/openharmony/developtools_smartperf_host) 项目
+- 转换后的 `.db` 是标准 SQLite 文件，包含线程调度、函数调用、CPU 状态等信息
+- 支持 `.htrace`（二进制格式）和 `.ftrace`（文本格式）两种输入格式
+- 转换耗时取决于文件大小，通常 100MB 的 trace 文件需要 10-30 秒

package/htrace-converter/SKILL.zh-CN.md

@@ -0,0 +1,117 @@
+---
+name: htrace-converter
+description: >
+  将鸿蒙 HarmonyOS trace 文件（.htrace、.ftrace）转换为 SQLite .db 格式。
+  当用户提到"转换 htrace"、"convert htrace"、"htrace 转 db"、"ftrace 转 db"、
+  "trace_streamer"、"解析 trace 文件"时使用。
+---
+
+# HTrace 文件转换工具
+
+将 HarmonyOS 抓取的 `.htrace` 或 `.ftrace` trace 文件，通过 `trace_streamer` 工具转换为可查询的 SQLite `.db` 格式，以便后续分析使用。
+
+## 使用方式
+
+| 命令 | 说明 |
+|------|------|
+| `/htrace-converter <trace文件路径>` | 转换指定 trace 文件为 .db |
+| `/htrace-converter install` | 安装/更新 trace_streamer 到系统 PATH |
+| `/htrace-converter check` | 检查当前环境中 trace_streamer 是否可用 |
+
+## 执行步骤
+
+### 步骤一：环境检查
+
+检查 `trace_streamer` 是否可用，按以下顺序查找：
+
+1. **系统 PATH**：`which trace_streamer_mac`（或对应平台名）
+2. **当前目录**：`./trace_streamer_binary/<平台二进制名>`
+3. **上级目录**：`../trace_streamer_binary/<平台二进制名>`
+4. **应用包内**（macOS）：`<jar所在目录>/../trace_streamer/<平台二进制名>`
+
+检测当前平台：
+
+```bash
+uname -s
+```
+
+平台到二进制名的映射：
+- `Darwin`（macOS）→ `trace_streamer_mac`
+- `Linux` → `trace_streamer_linux`
+- `MINGW*` / `CYGWIN*`（Windows）→ `trace_streamer_windows.exe`
+
+### 步骤二：安装 trace_streamer（仅 `/htrace-converter install` 时执行）
+
+从 [华为 SmartPerf-Host 项目](https://gitee.com/openharmony/developtools_smartperf_host/releases) 或随 trace-analyzer 一起发布的 `trace_streamer_binary` 目录中获取二进制文件。
+
+安装步骤：
+1. 从 trace-analyzer 项目的 `trace_streamer_binary/` 目录复制对应平台二进制到 `/usr/local/bin/`
+2. 赋予执行权限：`chmod +x /usr/local/bin/trace_streamer_<platform>`
+3. 验证：运行 `trace_streamer_mac --version`（或对应名称）
+
+**也可以直接配置环境变量指向 `trace_streamer_binary/` 目录，无需复制到系统 PATH。**
+
+### 步骤三：执行转换
+
+确认以下信息：
+- **输入文件**：`.htrace` 或 `.ftrace` 文件路径
+- **输出路径**（可选）：默认输出到系统临时目录 `/tmp/trace-analyzer/<basename>.htrace_db`
+
+执行转换命令：
+
+```bash
+# macOS
+trace_streamer_mac <input.htrace> -e <output.db>
+
+# Linux
+trace_streamer_linux <input.htrace> -e <output.db>
+
+# Windows
+trace_streamer_windows.exe <input.htrace> -e <output.db>
+```
+
+**缓存策略**：如果输出 `.db` 文件已存在且比输入文件更新，跳过转换直接使用缓存。
+
+### 步骤四：验证结果
+
+转换完成后验证 `.db` 文件：
+
+```bash
+# 检查文件存在且非空
+ls -lh <output.db>
+
+# 验证是有效的 SQLite 文件（可选）
+sqlite3 <output.db> ".tables" 2>/dev/null | head -5
+```
+
+### 步骤五：输出结果
+
+成功后告知用户：
+
+```
+转换完成！
+
+输入文件: /path/to/input.htrace
+输出文件: /tmp/trace-analyzer/input.htrace_db
+文件大小: XX MB
+
+可使用以下工具继续分析：
+  - trace-analyzer <output.db> -m <线程名>   # 卡顿/完成时延分析
+  - sqlite3 <output.db>                      # 直接查询数据库
+```
+
+## 错误处理
+
+| 错误情况 | 处理方式 |
+|----------|----------|
+| 输入文件不存在 | 提示用户确认文件路径 |
+| trace_streamer 不存在 | 引导用户运行 `/htrace-converter install` |
+| 转换失败（非零退出码） | 显示完整错误输出，建议检查文件是否损坏 |
+| 输出目录无写权限 | 建议用户指定其他输出路径 |
+
+## 说明
+
+- `trace_streamer` 是华为开源的 HarmonyOS trace 解析工具，来自 [SmartPerf-Host](https://gitee.com/openharmony/developtools_smartperf_host) 项目
+- 转换后的 `.db` 是标准 SQLite 文件，包含线程调度、函数调用、CPU 状态等信息
+- 支持 `.htrace`（二进制格式）和 `.ftrace`（文本格式）两种输入格式
+- 转换耗时取决于文件大小，通常 100MB 的 trace 文件需要 10-30 秒

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "harmony-skills-standalone",
+  "version": "1.0.0",
+  "description": "Skills: standalone",
+  "files": [
+    "autotest-agent",
+    "deveco-cli",
+    "htrace-converter",
+    "workflow-generalist"
+  ]
+}

package/workflow-generalist/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: workflow-generalist
+description: Execute one statically declared workflow node and write its declared result.
+---
+
+# Workflow Generalist
+
+Execute only the node described by the supplied prompt.
+
+- Treat all input paths as read-only unless the prompt explicitly identifies the target project as writable.
+- Do not invent upstream results or report success for work that was not performed.
+- Keep changes within the authorized target project and declared task output paths.
+- Write the declared `result` output as valid JSON.
+- Include `status`, `summary`, `evidence`, and `artifacts` fields.
+- Emit progress as one-line JSON objects with `type`, `phase`, `message`, and `progress`.
+- Return a non-zero result when the requested operation cannot be completed or verified.