@ohos-cpf/3rdloop 0.0.2 → 0.0.4

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

@@ -1,183 +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")
-```
+# 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

@@ -1,82 +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 均可直接运行 | ✅ 已验证 |
+# 合规检查清单
+
+> 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 均可直接运行 | ✅ 已验证 |