@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/task-decomposition/assets/OUTPUT_EXAMPLES.md

@@ -0,0 +1,451 @@
+# 输出示例
+
+> task-decomposition SKILL 输出的完整 JSON 示例，供 LLM 参考格式。
+
+---
+
+## 示例 1：库移植分析（线性 + 回退）
+
+```json
+{
+  "keyParameters": {
+    "versionNumbers": ["7.88.0"],
+    "branchNames": [],
+    "repoUrls": ["https://github.com/curl/curl.git"],
+    "libraryNames": ["libcurl"]
+  },
+  "steps": [
+    {
+      "stepId": 1,
+      "taskDescription": "对 libcurl 7.88.0 源码进行鸿蒙化可行性分析：git clone 源码仓库到工作目录，扫描源码结构、第三方依赖、平台相关代码（#ifdef 平台宏）及构建系统（CMake/Makefile），输出标准化分析报告（analysis-report.md）",
+      "dependId": 0,
+      "nextStepId": 2,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac1_1",
+          "criterion": "分析报告文件 analysis-report.md 已生成且非空（≥1KB）",
+          "type": "output",
+          "verification": "检查 ${taskDir}/analysis-report.md 文件是否存在且文件大小 > 1024",
+          "taskACIds": ["ac1"]
+        },
+        {
+          "id": "ac1_2",
+          "criterion": "报告包含源码结构、依赖列表、平台相关代码分析三个章节",
+          "type": "quality",
+          "verification": "读取 analysis-report.md，检查包含'源码结构'、'依赖列表'、'平台相关代码'三个标题",
+          "taskACIds": ["ac1", "ac2"]
+        }
+      ]
+    },
+    {
+      "stepId": 2,
+      "taskDescription": "对 libcurl 进行接口分析：扫描导出 API、头文件暴露接口、回调注册机制，输出接口清单（interface-list.md），标注鸿蒙化需适配的接口",
+      "dependId": 1,
+      "nextStepId": 3,
+      "failStepId": 4,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac2_1",
+          "criterion": "接口清单文件 interface-list.md 已生成且非空",
+          "type": "output",
+          "verification": "检查 ${taskDir}/interface-list.md 文件是否存在且文件大小 > 0",
+          "taskACIds": ["ac2"]
+        },
+        {
+          "id": "ac2_2",
+          "criterion": "清单中每个接口标注了鸿蒙化适配状态（需适配/可直接使用/不适用）",
+          "type": "quality",
+          "verification": "读取 interface-list.md，检查每个接口条目包含适配状态标注",
+          "taskACIds": ["ac2", "ac3"]
+        }
+      ]
+    },
+    {
+      "stepId": 3,
+      "taskDescription": "对 libcurl 进行鸿蒙化编译验证：使用鸿蒙 NDK 编译源码，记录编译错误和警告，输出编译日志（compile-log.txt）和编译结果摘要（compile-result.md）",
+      "dependId": 2,
+      "nextStepId": 5,
+      "failStepId": 4,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac3_1",
+          "criterion": "编译结果摘要文件 compile-result.md 已生成",
+          "type": "output",
+          "verification": "检查 ${taskDir}/compile-result.md 文件是否存在",
+          "taskACIds": ["ac3"]
+        },
+        {
+          "id": "ac3_2",
+          "criterion": "编译无 error 级别错误，或所有 error 已记录并分析",
+          "type": "compliance",
+          "verification": "读取 compile-log.txt，检查 error 行数；若存在 error，确认 compile-result.md 中有对应分析",
+          "taskACIds": ["ac3", "ac4"]
+        }
+      ]
+    },
+    {
+      "stepId": 4,
+      "taskDescription": "对编译失败的问题进行修复：分析编译错误原因，修改源码或构建配置，输出修复记录（fix-record.md），记录每个问题的修复方案",
+      "dependId": -1,
+      "nextStepId": 3,
+      "failStepId": 5,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac4_1",
+          "criterion": "修复记录文件 fix-record.md 已生成且包含至少一个问题的修复方案",
+          "type": "output",
+          "verification": "检查 ${taskDir}/fix-record.md 文件存在且内容包含'问题'和'修复方案'关键词",
+          "taskACIds": ["ac4"]
+        }
+      ]
+    },
+    {
+      "stepId": 5,
+      "taskDescription": "生成鸿蒙化可行性总结报告：汇总分析报告、接口清单、编译结果和修复记录，输出最终报告（final-report.md），包含可行性结论和建议",
+      "dependId": 3,
+      "nextStepId": 0,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac5_1",
+          "criterion": "最终报告文件 final-report.md 已生成且非空（≥2KB）",
+          "type": "output",
+          "verification": "检查 ${taskDir}/final-report.md 文件是否存在且文件大小 > 2048",
+          "taskACIds": ["ac1", "ac4"]
+        },
+        {
+          "id": "ac5_2",
+          "criterion": "报告包含明确的可行性结论（可行/有条件可行/不可行）",
+          "type": "quality",
+          "verification": "读取 final-report.md，检查包含'可行'或'不可行'关键词",
+          "taskACIds": ["ac4"]
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+## 示例 2：代码质量检查（并行）
+
+```json
+{
+  "keyParameters": {
+    "versionNumbers": [],
+    "branchNames": ["main"],
+    "repoUrls": [],
+    "libraryNames": ["libexample"]
+  },
+  "steps": [
+    {
+      "stepId": 1,
+      "taskDescription": "准备代码质量检查环境：克隆 libexample 仓库 main 分支到工作目录，安装依赖，确认项目可正常加载",
+      "dependId": 0,
+      "nextStepId": 2,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac1_1",
+          "criterion": "仓库已克隆到工作目录且依赖已安装",
+          "type": "output",
+          "verification": "检查 ${taskDir} 目录存在 node_modules 或 oh_modules 子目录",
+          "taskACIds": ["ac1"]
+        }
+      ]
+    },
+    {
+      "stepId": 2,
+      "taskDescription": "执行代码质量检查：运行 ArkTS 编码规范检查工具，扫描所有 .ets/.ts 文件，输出检查报告（code-quality-report.md）",
+      "dependId": 1,
+      "nextStepId": 4,
+      "failStepId": 5,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac2_1",
+          "criterion": "代码质量检查报告 code-quality-report.md 已生成",
+          "type": "output",
+          "verification": "检查 ${taskDir}/code-quality-report.md 文件存在",
+          "taskACIds": ["ac2"]
+        },
+        {
+          "id": "ac2_2",
+          "criterion": "报告无 arkts-no-any、arkts-no-unknown 严重违规",
+          "type": "compliance",
+          "verification": "读取报告，检查无 arkts-no-any 和 arkts-no-unknown 标记",
+          "taskACIds": ["ac2", "ac3"]
+        }
+      ]
+    },
+    {
+      "stepId": 3,
+      "taskDescription": "执行文档质量检查：扫描 README、API 文档、注释覆盖率，输出文档质量报告（doc-quality-report.md）",
+      "dependId": 1,
+      "nextStepId": 4,
+      "failStepId": 5,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac3_1",
+          "criterion": "文档质量报告 doc-quality-report.md 已生成",
+          "type": "output",
+          "verification": "检查 ${taskDir}/doc-quality-report.md 文件存在",
+          "taskACIds": ["ac3"]
+        },
+        {
+          "id": "ac3_2",
+          "criterion": "公共 API 文档覆盖率 ≥ 80%",
+          "type": "performance",
+          "verification": "读取报告，解析 API 文档覆盖率数值 ≥ 80",
+          "taskACIds": ["ac3"]
+        }
+      ]
+    },
+    {
+      "stepId": 4,
+      "taskDescription": "汇总代码质量与文档质量检查结果，生成综合质量报告（quality-summary.md）",
+      "dependId": 2,
+      "nextStepId": 0,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac4_1",
+          "criterion": "综合质量报告 quality-summary.md 已生成且包含代码质量和文档质量两部分",
+          "type": "quality",
+          "verification": "读取 quality-summary.md，检查包含'代码质量'和'文档质量'章节",
+          "taskACIds": ["ac2", "ac3", "ac4"]
+        }
+      ]
+    },
+    {
+      "stepId": 5,
+      "taskDescription": "对检查发现的问题进行修复：根据质量报告中的问题清单，逐项修复代码或文档问题，输出修复记录（fix-record.md）",
+      "dependId": -1,
+      "nextStepId": 2,
+      "failStepId": 4,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac5_1",
+          "criterion": "修复记录 fix-record.md 已生成且记录了修复方案",
+          "type": "output",
+          "verification": "检查 ${taskDir}/fix-record.md 文件存在且非空",
+          "taskACIds": ["ac4"]
+        }
+      ]
+    }
+  ]
+}
+```
+
+> **注意**：步骤2和步骤3的 `dependId` 都指向步骤1，Orchestrator 会在步骤1成功后并行执行步骤2和步骤3。
+
+---
+
+## 示例 3：最简线性流程
+
+```json
+{
+  "keyParameters": {
+    "versionNumbers": [],
+    "branchNames": ["feature/fix-123"],
+    "repoUrls": [],
+    "libraryNames": []
+  },
+  "steps": [
+    {
+      "stepId": 1,
+      "taskDescription": "获取 PR 信息并克隆仓库：通过 git clone 获取目标仓库 feature/fix-123 分支代码，记录 PR 变更文件列表",
+      "dependId": 0,
+      "nextStepId": 2,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac1_1",
+          "criterion": "仓库已克隆且变更文件列表已记录",
+          "type": "output",
+          "verification": "检查 ${taskDir} 下仓库目录存在，且 changed-files.txt 文件存在且非空",
+          "taskACIds": ["ac1"]
+        }
+      ]
+    },
+    {
+      "stepId": 2,
+      "taskDescription": "分析变更文件：逐个审查变更文件的代码质量、安全风险、逻辑正确性，输出分析报告（review-report.md）",
+      "dependId": 1,
+      "nextStepId": 3,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac2_1",
+          "criterion": "检视报告 review-report.md 已生成且覆盖所有变更文件",
+          "type": "quality",
+          "verification": "读取 review-report.md，对比 changed-files.txt 确认所有文件均已审查",
+          "taskACIds": ["ac2"]
+        }
+      ]
+    },
+    {
+      "stepId": 3,
+      "taskDescription": "生成 PR 检视总结：汇总分析结果，给出批准/修改建议，输出最终检视意见（pr-review.md）",
+      "dependId": 2,
+      "nextStepId": 0,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac3_1",
+          "criterion": "检视意见 pr-review.md 已生成且包含明确结论（批准/需修改/拒绝）",
+          "type": "output",
+          "verification": "读取 pr-review.md，检查包含'批准'或'需修改'或'拒绝'关键词",
+          "taskACIds": ["ac3"]
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+> **keyParameters 字段说明**：所有示例均在 `steps` 之前包含 `keyParameters` 字段，由 Phase 1.4 从任务描述中提取版本号、分支名、仓库 URL、库名。步骤描述中引用这些参数时必须与 `keyParameters` 中的值逐字一致，由 `validate-param-consistency.cjs` 强制校验。若任务描述中不含某类参数（如无版本号），对应数组留空 `[]` 即可。
+
+---
+
+## 示例 4：RN 三方库框架升级适配（含 specifiedSkill 绑定）
+
+> 该示例展示「RN 三方库框架升级适配」领域模板的标准 6 步拆解。**绑定了 specifiedSkill 的步骤（2/3/4/6）`taskDescription` 只描述任务目标与关键参数，技术细节由 SKILL 承载，绑定关系写入 `specifiedSkill` 字段；未绑定的步骤（1/5）仍写明具体操作。**
+
+```json
+{
+  "keyParameters": {
+    "versionNumbers": ["0.82", "0.84", "19.2"],
+    "branchNames": ["br_rnoh0.82", "br_rnoh0.84"],
+    "repoUrls": [
+      "https://gitcode.com/CPF-RN/rntpc_react-native-netinfo/tree/br_rnoh0.82",
+      "https://gitcode.com/CPF-RN/rntpc_react-native-netinfo"
+    ],
+    "libraryNames": ["rntpc_react-native-netinfo", "react-native-netinfo"]
+  },
+  "steps": [
+    {
+      "stepId": 1,
+      "taskDescription": "从 https://gitcode.com/CPF-RN/rntpc_react-native-netinfo/tree/br_rnoh0.82 克隆 br_rnoh0.82 分支到工作目录；克隆后执行 git branch --show-current 确认当前分支为 br_rnoh0.82；执行 ls 确认目录结构包含 package.json、src/、harmony/ 三部分；输出克隆与结构验证记录。",
+      "dependId": 0,
+      "nextStepId": 2,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac1_1",
+          "criterion": "仓库已克隆到工作目录，当前分支为 br_rnoh0.82",
+          "type": "output",
+          "verification": "在工作目录执行 git branch --show-current，输出为 br_rnoh0.82",
+          "taskACIds": ["ac1"]
+        }
+      ]
+    },
+    {
+      "stepId": 2,
+      "taskDescription": "对 rntpc_react-native-netinfo 进行版本差异分析，对比 br_rnoh0.82 基线版本与 0.84 目标版本的差异，检查 br_rnoh0.84 分支是否存在，输出版本分析报告。",
+      "specifiedSkill": "rnoh-lib-version-diff",
+      "dependId": 1,
+      "nextStepId": 3,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac2_1",
+          "criterion": "版本分析报告已生成且 JSON.parse 成功",
+          "type": "output",
+          "verification": "检查版本分析报告文件存在且可被 JSON.parse 解析",
+          "taskACIds": ["ac2"]
+        }
+      ]
+    },
+    {
+      "stepId": 3,
+      "taskDescription": "对 rntpc_react-native-netinfo 进行 0.82→0.84 框架升级代码适配与编译验证（框架依赖升级至 react 19.2），输出适配变更清单。",
+      "specifiedSkill": "rnoh-lib-code-adapt",
+      "dependId": 2,
+      "nextStepId": 4,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac3_1",
+          "criterion": "package.json 中框架依赖版本已升级到目标版本",
+          "type": "compliance",
+          "verification": "读取 package.json 检查 react/react-native/@react-native-oh/react-native-harmony 版本号匹配",
+          "taskACIds": ["ac3"]
+        }
+      ]
+    },
+    {
+      "stepId": 4,
+      "taskDescription": "对 rntpc_react-native-netinfo 移植上游测试 demo 并执行测试验证，补充缺失测试用例，输出测试结果。",
+      "specifiedSkill": "rnoh-lib-test-align",
+      "dependId": 3,
+      "nextStepId": 5,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac4_1",
+          "criterion": "jest 测试已执行并输出通过率与覆盖率数据",
+          "type": "quality",
+          "verification": "执行 jest 测试，检查输出含通过率与覆盖率数据",
+          "taskACIds": ["ac8"]
+        }
+      ]
+    },
+    {
+      "stepId": 5,
+      "taskDescription": "确保 build-profile.json5 中 signingConfigs 已配置且非空；构建产出 entry-default-signed.hap（已签名），确认 size > 0；部署到设备获取 UI 树 JSON grep 搜索 netinfo 关键词命中；获取 hilog 按 level=F/E 过滤确认无崩溃；输出设备验证记录。",
+      "dependId": 4,
+      "nextStepId": 6,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac5_1",
+          "criterion": "entry-default-signed.hap 签名构建产物已生成且 size > 0",
+          "type": "output",
+          "verification": "检查构建产物路径下 entry-default-signed.hap 存在，ls -l 显示 size > 0",
+          "taskACIds": ["ac6"]
+        }
+      ]
+    },
+    {
+      "stepId": 6,
+      "taskDescription": "基于适配变更清单与设备验证记录，对 rntpc_react-native-netinfo 生成功能测试 checklist 与 fix-summary.json，标注高风险场景。",
+      "specifiedSkill": "rnoh-lib-func-test",
+      "dependId": 5,
+      "nextStepId": 0,
+      "failStepId": 0,
+      "maxRetries": 3,
+      "acceptanceCriteria": [
+        {
+          "id": "ac6_1",
+          "criterion": "fix-summary.json 独立文件已生成且 JSON.parse 成功",
+          "type": "output",
+          "verification": "检查 fix-summary.json 独立存在，对其执行 JSON.parse 成功",
+          "taskACIds": ["ac8"]
+        }
+      ]
+    }
+  ]
+}
+```

package/vendor/Server/Skills/task-decomposition/references/ACCEPTANCE_CRITERIA_GUIDE.md

@@ -0,0 +1,179 @@
+# 验收标准编写指南
+
+> 如何生成高质量、可验证的步骤级验收标准。步骤级验收标准是 task-decomposition SKILL 的核心产出之一，直接影响 acceptance-check SKILL 的准出评估准确性。
+
+---
+
+## 1. 核心原则
+
+> **每条标准必须能通过检查文件、执行命令或人工审查来判定 pass/fail。**
+
+- ❌ `"分析完成"` — 无法判定"完成"的定义
+- ❌ `"代码质量好"` — "好"是主观的
+- ✅ `"分析报告文件 analysis-report.md 已生成且非空（≥1KB）"` — 可检查文件大小
+- ✅ `"编译无 error 级别错误"` — 可执行编译命令检查
+
+---
+
+## 2. type 分类
+
+| type | 说明 | 验证方式 | 示例 |
+|------|------|----------|------|
+| `output` | 产物检查 — 文件/内容是否存在、是否完整 | 检查文件存在性、大小、格式 | "分析报告文件已生成且可解析" |
+| `quality` | 质量要求 — 产物质量是否达标 | 内容审查、规则匹配 | "报告覆盖所有关键维度" |
+| `performance` | 性能指标 — 定量指标 | 执行命令获取数值 | "扫描覆盖率 ≥ 80%" |
+| `compliance` | 合规性 — 是否符合规范 | 规范比对、lint 检查 | "代码符合 ArkTS 编码规范" |
+
+---
+
+## 3. ID 命名规则
+
+步骤级验收标准的 ID 格式为 `ac{stepId}_{序号}`：
+
+| 步骤 | 序号 | ID |
+|------|------|----|
+| 步骤1 | 第1条 | `ac1_1` |
+| 步骤1 | 第2条 | `ac1_2` |
+| 步骤2 | 第1条 | `ac2_1` |
+| 步骤3 | 第3条 | `ac3_3` |
+
+---
+
+## 4. taskACIds 追溯字段
+
+`taskACIds` 建立步骤级标准 → 任务级标准的追溯关系：
+
+```json
+{
+  "id": "ac1_1",
+  "criterion": "分析报告文件 analysis-report.md 已生成且非空",
+  "type": "output",
+  "verification": "检查 ${taskDir}/analysis-report.md 文件是否存在且文件大小 > 0",
+  "taskACIds": ["ac1"]
+}
+```
+
+**设计意图**：合并所有步骤的 `taskACIds` 后，应覆盖所有任务级 AC 的 ID。
+
+### 覆盖校验
+
+```
+任务级 AC: ac1, ac2, ac3, ac4
+
+步骤1 AC.taskACIds: ["ac1", "ac2"]     → 覆盖 ac1, ac2
+步骤2 AC.taskACIds: ["ac2", "ac3"]     → 覆盖 ac2, ac3
+步骤3 AC.taskACIds: ["ac3", "ac4"]     → 覆盖 ac3, ac4
+
+合并覆盖: ac1, ac2, ac3, ac4 ✅ 全覆盖
+```
+
+> 允许一条步骤级 AC 关联多个任务级 AC（如上例 ac2_1 同时关联 ac2 和 ac3）。
+> 也允许多条步骤级 AC 关联同一个任务级 AC（不同步骤从不同角度验证同一任务级标准）。
+
+---
+
+## 5. 每条标准必含字段
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `id` | ✅ | 格式 `ac{stepId}_{序号}` |
+| `criterion` | ✅ | 具体标准描述，非空，可验证 |
+| `type` | ✅ | `output`/`quality`/`performance`/`compliance` |
+| `verification` | ✅ | 验证方式（具体到可执行命令或检查方法） |
+| `taskACIds` | ✅ | 关联的任务级标准 ID 列表（如 `["ac1"]`） |
+
+---
+
+## 6. 编写模式
+
+### 6.1 产物检查模式
+
+```
+criterion: "{文件名} 已生成且 {条件}"
+type: "output"
+verification: "检查 {路径} 文件存在，且 {验证条件}"
+taskACIds: ["ac1"]
+```
+
+### 6.2 覆盖率模式
+
+```
+criterion: "{指标} ≥ {阈值}"
+type: "performance"
+verification: "执行 {命令}，解析输出获取 {指标}，判断 ≥ {阈值}"
+taskACIds: ["ac3"]
+```
+
+### 6.3 规范合规模式
+
+```
+criterion: "{产物} 符合 {规范名}"
+type: "compliance"
+verification: "运行 {lint/check工具}，检查 {规则} 错误数为 0"
+taskACIds: ["ac2"]
+```
+
+### 6.4 内容完整性模式
+
+```
+criterion: "{产物} 包含 {必要内容列表}"
+type: "quality"
+verification: "读取 {产物}，逐项检查 {内容项} 均存在且非空"
+taskACIds: ["ac1", "ac4"]
+```
+
+---
+
+## 7. 好的验收标准示例
+
+```json
+{
+  "id": "ac1_1",
+  "criterion": "分析报告文件 analysis-report.md 已生成且非空",
+  "type": "output",
+  "verification": "检查 ${taskDir}/analysis-report.md 文件是否存在且文件大小 > 0",
+  "taskACIds": ["ac1"]
+}
+```
+
+```json
+{
+  "id": "ac2_1",
+  "criterion": "编译无 error 级别错误，warning 数量 ≤ 10",
+  "type": "compliance",
+  "verification": "执行编译命令，检查 stderr 中无 'error' 关键字，统计 'warning' 出现次数 ≤ 10",
+  "taskACIds": ["ac2", "ac3"]
+}
+```
+
+---
+
+## 8. 差的验收标准示例
+
+```json
+{
+  "id": "ac1_1",
+  "criterion": "分析完成"
+}
+```
+
+**问题**：无法验证、缺少 type/verification/taskACIds 字段。
+
+```json
+{
+  "criterion": "代码质量好",
+  "type": "quality",
+  "verification": "人工检查"
+}
+```
+
+**问题**：标准模糊、验证方式不可自动化、缺少 id 和 taskACIds。
+
+---
+
+## 9. 数量建议
+
+- 每个步骤通常 1-3 条验收标准
+- 关键步骤可增加到 3-5 条
+- 简单步骤（如报告生成）1 条即可
+- 总数不宜过多，避免审核成本过高