@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/skill-generator/assets/SKILL_TEMPLATE.md

@@ -0,0 +1,183 @@
+# SKILL 模板
+
+> 生成新SKILL时可直接复制此模板，替换 `{占位符}` 内容。
+
+---
+
+## 目录结构
+
+```
+{skill-name}/
+├── SKILL.md
+├── references/
+│   └── REFERENCE.md
+├── assets/
+│   └── OUTPUT_TEMPLATE.md
+└── scripts/
+    └── {helper}.cjs
+```
+
+---
+
+## SKILL.md 模板
+
+```markdown
+---
+name: {skill-name}
+description: {做什么的简述}. Use when {触发场景}. {领域关键词}.
+license: Apache-2.0
+compatibility: {环境要求，如"需要git、网络访问"}
+metadata:
+  author: {作者}
+  version: "1.0.0"
+  category: {分类}
+---
+
+# {Skill标题}
+
+{一句话定位说明}
+
+> ⚠️ **核心原则：{本SKILL的关键约束}**
+
+---
+
+## 任务参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `{param1}` | string | ✅ | {说明} |
+| `{param2}` | string | ❌ | {说明} |
+| `outputDir` | string | ✅ | 输出目录绝对路径 |
+
+---
+
+## 输入依赖
+
+- **前置SKILL**: {前置SKILL名称，或"无"}
+- **输入文件**: {输入文件，或"无"}
+
+---
+
+## 工作流程概览
+
+\`\`\`
+Phase 1: {阶段1} → Phase 2: {阶段2} → Phase 3: {阶段3} → Phase 4: {输出}
+\`\`\`
+
+---
+
+## Phase 1：{阶段名}
+
+### 1.1 {步骤名}
+
+{步骤详细说明}
+
+### 1.2 {步骤名}
+
+{步骤详细说明}
+
+> 详细说明参见 [参考文档](references/REFERENCE.md)
+
+---
+
+## Phase 2：{阶段名}
+
+### 2.1 调用MCP工具
+
+调用 MCP 工具 `{serverName}_{toolName}`，传入参数：
+- `{param}`: {说明}
+
+### 2.2 处理返回结果
+
+{结果处理说明}
+
+---
+
+## Phase 3：{阶段名}
+
+### 3.1 {步骤名}
+
+{步骤详细说明}
+
+---
+
+## Phase 4：{输出阶段}
+
+### 输出文件
+
+- `{outputDir}/{file1}.md` — {说明}
+- `{outputDir}/{file2}.txt` — {说明}
+
+> 输出模板参见 [输出模板](assets/OUTPUT_TEMPLATE.md)
+```
+
+---
+
+## references/REFERENCE.md 模板
+
+```markdown
+# {领域}参考文档
+
+## 1. {主题1}
+
+### 1.1 {子主题}
+
+{详细内容}
+
+### 检查清单
+
+- [ ] {检查项1}
+- [ ] {检查项2}
+
+## 2. {主题2}
+
+{详细内容}
+```
+
+---
+
+## scripts/ 脚本模板
+
+> ⚠️ **脚本必须跨平台**（Windows/macOS/Linux 均可运行）：使用 Node.js（`.cjs`）或 Python（`.py`），**禁止 Bash（`.sh`）**。
+
+### Node.js 脚本（首选）
+
+```javascript
+#!/usr/bin/env node
+/**
+ * @tool {工具名}
+ * @description {工具描述}
+ * @param {param}: string - {参数说明}
+ */
+'use strict';
+
+// 参数解析：兼容 MCP Gateway JSON 模式与 CLI 模式
+function parseArgs(argv) {
+  if (argv.length > 0 && typeof argv[0] === 'string' && argv[0].startsWith('{')) {
+    try { return JSON.parse(argv[0]); } catch (e) { return {}; }
+  }
+  return { param: argv[0] || '' };
+}
+
+const args = parseArgs(process.argv.slice(2));
+
+// 脚本逻辑
+console.log('result');
+```
+
+### python 脚本
+
+```python
+#!/usr/bin/env python3
+# @tool {工具名}
+# @description {工具描述}
+# @param {param}: string - {参数说明}
+
+import sys, json
+
+args = json.loads(sys.argv[1]) if len(sys.argv) > 1 and sys.argv[1].startswith('{') else {}
+param = args.get("{param}", "")
+
+# 脚本逻辑
+print("result")
+```

package/vendor/Server/Skills/skill-generator/references/COMPLIANCE_CHECKLIST.md

@@ -0,0 +1,82 @@
+# 合规检查清单
+
+> SKILL生成后的完整合规性自检清单。
+
+---
+
+## 1. Frontmatter 检查
+
+| # | 检查项 | 规则 | 通过条件 |
+|---|--------|------|----------|
+| 1.1 | `name` 存在 | frontmatter 必须有 name 字段 | ✅ 存在 |
+| 1.2 | `name` 字符集 | 仅 `a-z`/`0-9`/`-` | ✅ 无大写/特殊字符 |
+| 1.3 | `name` 长度 | 1-64 字符 | ✅ 在范围内 |
+| 1.4 | `name` 首尾 | 不以 `-` 开头或结尾 | ✅ 合规 |
+| 1.5 | `name` 连续 | 无连续 `--` | ✅ 合规 |
+| 1.6 | `name` 匹配目录 | name === 父目录名 | ✅ 匹配 |
+| 1.7 | `description` 存在 | 必须有 description | ✅ 存在 |
+| 1.8 | `description` 长度 | ≤1024 字符 | ✅ 在范围内 |
+| 1.9 | `description` 内容 | 含"做什么"+"何时用"+关键词 | ✅ 三要素齐全 |
+| 1.10 | `license` 存在 | 推荐有 license | ✅ 存在 |
+| 1.11 | `metadata.author` | 推荐有 author | ✅ 存在 |
+| 1.12 | `metadata.version` | 推荐有 version | ✅ 存在 |
+
+---
+
+## 2. 结构检查
+
+| # | 检查项 | 规则 | 通过条件 |
+|---|--------|------|----------|
+| 2.1 | SKILL.md 存在 | 目录下必须有 SKILL.md | ✅ 存在 |
+| 2.2 | body 行数 | 推荐 < 500 行 | ✅ 或已拆分 |
+| 2.3 | body tokens | 推荐 < 5000 tokens | ✅ 或已拆分 |
+| 2.4 | references 深度 | 一层深度 | ✅ 无嵌套子目录 |
+| 2.5 | 文件引用路径 | 使用相对路径 | ✅ 无绝对路径 |
+| 2.6 | 引用文件存在 | 引用的文件实际存在 | ✅ 全部存在 |
+
+---
+
+## 3. 内容检查
+
+| # | 检查项 | 规则 | 通过条件 |
+|---|--------|------|----------|
+| 3.1 | 任务参数表 | body 包含参数说明 | ✅ 存在 |
+| 3.2 | 工作流程概览 | body 包含 Phase 概览 | ✅ 存在 |
+| 3.3 | 各 Phase 详细步骤 | 每个 Phase 有具体步骤 | ✅ 完整 |
+| 3.4 | 输出产物说明 | 说明最终输出什么 | ✅ 存在 |
+| 3.5 | MCP工具引用 | 引用的工具名含正确前缀 | ✅ 正确 |
+| 3.6 | 知识库内容融合 | 如适用，已融合知识库要点 | ✅ 或标注不适用 |
+| 3.7 | 核心原则提示 | 有 `> ⚠️` 关键约束 | ✅ 存在 |
+
+---
+
+## 4. 渐进式披露检查
+
+| # | 检查项 | 规则 | 通过条件 |
+|---|--------|------|----------|
+| 4.1 | L1 精准 | description 精准描述用途 | ✅ 含关键词 |
+| 4.2 | L2 完整 | body 可独立执行完整流程 | ✅ 无缺失步骤 |
+| 4.3 | L3 聚焦 | 每个reference专注一个主题 | ✅ 无混杂 |
+| 4.4 | 按需加载 | 详细内容在references不在body | ✅ body精炼 |
+
+---
+
+## 5. 自动化校验
+
+运行校验脚本执行上述检查（跨平台，仅需 Node.js）：
+
+```bash
+node {skillDir}/scripts/validate-skill.cjs {skillDir}
+```
+
+脚本输出 `ALL CHECKS PASSED` 表示全部通过，否则列出失败项。
+
+---
+
+## 6. 脚本跨平台检查
+
+| # | 检查项 | 规则 | 通过条件 |
+|---|--------|------|----------|
+| 6.1 | 脚本语言 | 使用 Node.js（`.cjs`）或 Python（`.py`） | ✅ 无 `.sh` 脚本 |
+| 6.2 | 路径处理 | 使用 `path` 模块 / `os.path`，不硬编码分隔符 | ✅ 跨平台 |
+| 6.3 | 可执行性 | Windows/macOS/Linux 均可直接运行 | ✅ 已验证 |

package/vendor/Server/Skills/skill-generator/references/KB_QUERY_GUIDE.md

@@ -0,0 +1,110 @@
+# 知识库查询指南
+
+> 本文档说明如何查询鸿蒙知识库，补充大模型通用知识不够具体的场景。
+
+---
+
+## 1. 何时查询知识库
+
+| 场景 | 是否查询 |
+|------|----------|
+| 通用编程任务（非鸿蒙） | ❌ 不需要 |
+| 鸿蒙API使用，通用知识足够 | ❌ 不需要 |
+| ArkTS特定约束，通用知识模糊 | ✅ 需要 |
+| OpenHarmony特定最佳实践 | ✅ 需要 |
+| 鸿蒙三方库检视的检查标准 | ✅ 需要 |
+| ArkTS编译错误修复 | ✅ 需要 |
+| ArkUI响应式/状态管理陷阱 | ✅ 需要 |
+
+**判断原则**：当不确定通用知识是否准确覆盖鸿蒙特定行为时，查询知识库。
+
+---
+
+## 2. 查询流程
+
+### 2.1 构建检索词
+
+从SKILL需求中提取关键词，组合检索词：
+
+**提取维度**：
+- 技术栈：ArkTS、OpenHarmony、HarmonyOS、ArkUI
+- 具体领域：内存泄漏、生命周期、状态管理、NAPI、权限
+- 操作动作：检测、检视、修复、最佳实践
+
+**组合示例**：
+```
+需求：检测ArkTS三方库内存泄漏
+检索词：["ArkTS 内存泄漏", "OpenHarmony 生命周期泄漏", "ArkTS 事件监听清理"]
+```
+
+### 2.2 调用知识库工具
+
+调用 `kb-server_` 前缀的知识检索工具（具体工具名通过 `gateway_list_tools` 获取）。
+
+**调用策略**：
+- 一次查询一个关键词
+- 若返回不相关，调整关键词重试（最多3轮）
+- 记录查询过的关键词，避免重复
+
+### 2.3 结果处理
+
+对知识库返回的内容分类处理：
+
+| 内容类型 | 处理方式 | 放置位置 |
+|----------|----------|----------|
+| 检查清单 | 整合为检查项 | references/ 的检查文档 |
+| 代码示例 | 提取关键模式 | assets/ 的模板中 |
+| 最佳实践 | 精简引用 | SKILL.md body 对应Phase |
+| 注意事项 | 精简引用 | SKILL.md body 或 references/ |
+| 错误模式 | 记录为反模式 | references/ |
+
+---
+
+## 3. 知识融合原则
+
+### 3.1 不照搬全文
+
+知识库返回的内容可能很长，**不要**完整复制到SKILL中。应：
+- 提取核心要点
+- 精简为1-3句话引用
+- 详细内容放入 references/，SKILL.md 中用链接引用
+
+### 3.2 标注来源
+
+在引用知识库内容时，标注来源：
+
+```markdown
+> 📖 来源：鸿蒙知识库，关键词"ArkTS 内存泄漏"
+```
+
+### 3.3 验证适用性
+
+知识库返回的内容需验证是否适用于当前SKILL场景：
+- API版本是否匹配（API 12+ vs 更低版本）
+- 场景是否匹配（三方库 vs 系统应用）
+- 约束是否仍然有效
+
+---
+
+## 4. 常见鸿蒙知识库查询场景
+
+### 4.1 ArkTS 编译规范
+
+检索词建议：
+- `ArkTS 编译错误` — 常见编译约束
+- `ArkTS 类型系统` — 类型限制
+- `arkts-no-any` — 具体规则
+
+### 4.2 ArkUI 响应式
+
+检索词建议：
+- `ArkUI 状态管理` — @State/@Prop/@Link
+- `ArkTS @Builder 响应式` — @Builder 陷阱
+- `ArkUI 组件生命周期` — 生命周期回调
+
+### 4.3 鸿蒙性能与稳定性
+
+检索词建议：
+- `ArkTS 内存泄漏` — 泄漏检测
+- `OpenHarmony 稳定性` — 崩溃分析
+- `ArkTS 异步处理` — Promise/async

package/vendor/Server/Skills/skill-generator/references/MCP_TOOL_DISCOVERY.md

@@ -0,0 +1,122 @@
+# MCP 能力检索指南
+
+> 本文档说明如何检索 MCP Gateway 中可复用的脚本工具和下游工具。
+
+---
+
+## 1. MCP Gateway 架构概览
+
+MCP Gateway 位于 `3rdLibraryLoop/MCP/`，聚合三类工具：
+
+| 工具来源 | 命名前缀 | 注册方式 |
+|----------|----------|----------|
+| 脚本工具 | `script_` | 扫描 `MCP/scripts/` 目录，解析 `@tool` 注释 |
+| 下游工具 | `{serverName}_` | 连接下游 MCP Server，拉取工具列表 |
+| 内置工具 | `gateway_` | Gateway 自带管理工具 |
+
+---
+
+## 2. 检索工具列表
+
+### 2.1 调用 gateway_list_tools
+
+调用 MCP 工具 `gateway_list_tools` 获取所有已注册工具的完整列表。
+
+返回的工具对象包含：
+```json
+{
+  "name": "script_git操作",
+  "description": "[via scripts] 执行 Git 操作",
+  "inputSchema": { ... }
+}
+```
+
+### 2.2 分类筛选
+
+根据工具名前缀分类：
+
+- **脚本工具**：名称以 `script_` 开头 → 对应 `MCP/scripts/` 下的脚本
+- **知识库工具**：名称以 `kb-server_` 开头 → 鸿蒙知识库
+- **GitCode工具**：名称以 `gitcode_` 开头 → GitCode 平台操作
+- **内置工具**：名称以 `gateway_` 开头 → Gateway 管理功能
+
+---
+
+## 3. 脚本工具详情
+
+### 3.1 脚本头部注释约定
+
+脚本前20行必须包含 `@tool` 注释：
+
+```javascript
+#!/usr/bin/env node
+/**
+ * @tool {工具名}                        // 必填，工具名（中文可用）
+ * @description {描述}                    // 给AI的工具说明
+ * @param {参数名}: {类型} - {说明}       // 参数定义
+ */
+```
+
+> ⚠️ **脚本必须跨平台**：使用 Node.js（`.cjs`）或 Python（`.py`），禁止 Bash（`.sh`），确保 Windows/macOS 均可运行。
+
+### 3.2 参数传递方式
+
+Gateway 将参数序列化为 **JSON 字符串**，作为脚本**第一个命令行参数**传入：
+
+- node: `process.argv[2]` → `JSON.parse()` 解析
+- python: `sys.argv[1]` → `json.loads()` 解析
+
+### 3.3 现有脚本工具
+
+| 工具名 | 脚本文件 | 能力 | 参数 |
+|--------|----------|------|------|
+| `script_rn_scan_exports` | `rn-scan-exports.cjs` | 扫描RN三方库导出接口/TurboModule Spec | `dir`, `compare`, `dir1`, `dir2` |
+| `script_rn_extract_interfaces` | `rn-extract-interfaces.cjs` | 提取RN三方库接口信息 | `dir` |
+| `script_render_spec_doc` | `render-spec-doc.cjs` | 渲染接口规格文档 | `spec`, `output` |
+
+### 3.4 创建新脚本
+
+若SKILL需要新的脚本能力：
+
+1. 在SKILL的 `scripts/` 目录创建脚本（**必须跨平台**：Node.js `.cjs` 或 Python `.py`，禁止 `.sh`）
+2. 添加 `@tool` 头部注释
+3. 若需全局复用，复制到 `MCP/scripts/` 目录
+4. Gateway 热加载会自动注册（`hotReload: true`）
+
+---
+
+## 4. 下游工具详情
+
+### 4.1 kb-server（鸿蒙知识库）
+
+- **URL**: `https://mcp.huaness.tech/mcp`
+- **认证**: `Bearer test-secret`
+- **工具前缀**: `kb-server_`
+- **用途**: 鸿蒙/OpenHarmony/ArkTS 领域知识检索
+
+### 4.2 gitcode（GitCode MCP）
+
+- **URL**: `https://api.gitcode.com/mcp-server/v1/mcp`
+- **工具前缀**: `gitcode_`
+- **用途**: 仓库操作、PR管理、代码搜索
+
+---
+
+## 5. 在SKILL中引用MCP工具
+
+在SKILL.md的对应Phase中，按以下方式引用：
+
+```markdown
+### 获取仓库信息
+
+调用 MCP 工具 `gitcode_获取仓库信息`，传入 `owner` 和 `repo` 参数。
+
+### 查询鸿蒙知识
+
+调用 MCP 工具 `kb-server_知识检索`，传入关键词查询。
+```
+
+引用要点：
+- 使用完整工具名（含前缀）
+- 说明调用参数
+- 说明返回数据的用途

package/vendor/Server/Skills/skill-generator/references/SKILL_SPEC.md

@@ -0,0 +1,121 @@
+# SKILL 编写规范
+
+> 基于 [Agent Skills Specification](https://agentskills.io/specification)
+
+---
+
+## 1. 目录结构
+
+```
+skill-name/
+├── SKILL.md          # 必需：YAML frontmatter + Markdown 指令
+├── scripts/          # 可选：可执行代码
+├── references/       # 可选：详细参考文档
+├── assets/           # 可选：模板、静态资源
+└── ...               # 其他文件
+```
+
+---
+
+## 2. SKILL.md 格式
+
+### 2.1 Frontmatter（YAML）
+
+| 字段 | 必填 | 约束 |
+|------|------|------|
+| `name` | ✅ | ≤64字符，仅 `a-z`/`0-9`/`-`，不能首尾 `-`，不能连续 `--`，**必须等于父目录名** |
+| `description` | ✅ | ≤1024字符，描述"做什么"+"何时用"，含关键词 |
+| `license` | ❌ | 许可证名称或引用文件 |
+| `compatibility` | ❌ | ≤500字符，环境要求 |
+| `metadata` | ❌ | key-value map，推荐含 `author`、`version` |
+| `allowed-tools` | ❌ | 空格分隔的预批准工具列表（实验性） |
+
+#### name 校验规则
+
+```
+有效: pdf-processing, data-analysis, code-review, arkts-api-audit
+无效: PDF-Processing（大写）, -pdf（连字符开头）, pdf--processing（连续连字符）
+```
+
+#### description 编写
+
+**好的示例**：
+```yaml
+description: 对ArkTS鸿蒙化库核心代码进行编码质量检视，依据华为ArkTS规范评分。当需要对鸿蒙化ArkTS库进行编码质量检视时使用。支持命名规范、格式规范、ArkTS约束等维度。
+```
+
+**差的示例**：
+```yaml
+description: 帮助检视代码。
+```
+
+### 2.2 Body（Markdown）
+
+**推荐结构**：
+1. 标题 + 一句话定位
+2. 核心原则提示（`> ⚠️`）
+3. 任务参数表
+4. 输入依赖
+5. 工作流程概览（Phase 1 → N）
+6. 各 Phase 详细步骤
+7. 输出产物说明
+
+**长度约束**：
+- 推荐 < 500 行
+- 推荐 < 5000 tokens
+- 超过时必须拆分到 references/
+
+---
+
+## 3. 渐进式披露
+
+Agent 按需加载SKILL内容，分三层：
+
+| 层级 | 内容 | 加载时机 | Token量 |
+|------|------|----------|---------|
+| L1 | name + description | 启动时加载所有SKILL元数据 | ~100 tokens |
+| L2 | SKILL.md body | SKILL被激活时加载 | < 5000 tokens |
+| L3 | references/assets/scripts | 任务需要时按需读取 | 按需 |
+
+**设计要点**：
+- L1 要精准：description 决定SKILL是否被选中
+- L2 要完整：body 包含完整可执行的流程
+- L3 要聚焦：每个reference文件专注一个主题
+
+---
+
+## 4. 文件引用
+
+- 使用**相对路径**（从SKILL根目录起）
+- 保持**一层深度**：`references/REF.md` ✅
+- 避免深层嵌套：`references/a/b/c.md` ❌
+- 引用格式：`参见 [参考文档](references/REFERENCE.md)`
+
+---
+
+## 5. scripts/ 目录
+
+脚本要求：
+- 自包含或清晰声明依赖
+- 包含有用的错误信息
+- 优雅处理边界情况
+- **必须跨平台**（Windows/macOS/Linux 均可运行）：支持 Node.js（`.cjs`/`.js`）或 Python（`.py`），**禁止 Bash（`.sh`）**
+- 脚本内路径操作使用 `path` 模块（Node.js）或 `os.path`/`pathlib`（Python），禁止硬编码 `/` 或 `\` 分隔符拼接
+
+若脚本需注册到 MCP Gateway：
+1. 添加头部注释（`@tool`、`@description`、`@param`）
+2. 复制到 `MCP/scripts/` 目录
+3. Gateway 自动发现并注册为 `script_{工具名}` 工具
+
+---
+
+## 6. 验证
+
+使用规范校验：
+```bash
+# 项目内校验脚本（跨平台，仅需 Node.js）
+node scripts/validate-skill.cjs /path/to/skill
+
+# 或使用官方工具
+npx skills-ref validate /path/to/skill
+```