@ohos-cpf/3rdloop 0.0.2 → 0.0.3

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

@@ -1,110 +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
+# 知识库查询指南
+
+> 本文档说明如何查询鸿蒙知识库，补充大模型通用知识不够具体的场景。
+
+---
+
+## 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

@@ -1,122 +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_知识检索`，传入关键词查询。
-```
-
-引用要点：
-- 使用完整工具名（含前缀）
-- 说明调用参数
-- 说明返回数据的用途
+# 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_知识检索`，传入关键词查询。
+```
+
+引用要点：
+- 使用完整工具名（含前缀）
+- 说明调用参数
+- 说明返回数据的用途