aicortexpy 0.1.0__py3-none-any.whl

aicortexpy/data/default_skills/aicortex-cli-ops/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: aicortex-cli-ops
+description: >-
+  Manage AICortex agents, skills, and projects with the aicortex CLI.
+  Covers create/update, bind skills to agents, and create workspace skills
+  (default private). Use when the user mentions aicortex CLI, 上传 skill,
+  Agent 管理, or 项目管理.
+---
+
+# aicortex-cli-ops
+
+用 **`aicortex` CLI** 管 Agent / Skill / 项目。不要直接改 Postgres。
+
+新建 skill **默认 private**（仅当前工作空间）。
+
+## 准备
+
+```powershell
+aicortex auth status
+aicortex config
+aicortex workspace list
+```
+
+- 已登录、`server_url` 指向当前云端、`workspace_id` 是目标空间。
+- 换空间：`aicortex config set workspace_id <uuid>`
+- 不确定参数：`aicortex <command> --help`
+- 脚本输出：加 `--output json`
+
+当前 PDC 示例：`server_url` = `https://app-portal-pdc1.envisioniot.com/aicortex-web`
+
+## Agent
+
+```powershell
+aicortex runtime list --output json
+aicortex agent list
+aicortex agent get <id>
+
+aicortex agent create --name "My Agent" --instructions "你是..." --runtime-id <runtime-uuid>
+# 可选：--model "..." --visibility workspace --max-concurrent-tasks 6
+# 从模板：--from-template code-reviewer
+
+aicortex agent update <id> --instructions "..." --model "..."
+aicortex agent archive <id>
+aicortex agent restore <id>
+
+aicortex agent skills list <agent-id>
+aicortex agent skills set <agent-id> --skill-ids <skill-id-1,skill-id-2>
+```
+
+`agent create` 必须有 `--runtime-id`。`skills set` **整表替换**，要先 `skills list` 再带上要保留的 id。
+
+Agent 的 `--visibility` 是 Agent 对工作空间是否可见（`private` / `workspace`），与 skill 无关。
+
+## Skill
+
+```powershell
+aicortex skill list
+aicortex skill get <id>
+aicortex skill create --name "my-skill" --description "何时使用..." --content "<完整 SKILL.md>"
+aicortex skill update <id> --content "<完整 SKILL.md>" --description "..."
+aicortex skill files upsert <skill-id> --path extra.md --content "..."
+aicortex skill delete <id> --yes
+```
+
+规则：
+
+- `name` 同空间唯一（小写、数字、连字符）。
+- `content` 放完整 `SKILL.md`（含 YAML frontmatter）。
+- `skill create` 默认 **private**。
+- Windows 长正文不要用 PowerShell `--content "..."`，容易截断/乱码；把 SKILL.md 读入后再交给 CLI/API。
+
+绑到 Agent：
+
+```powershell
+aicortex agent skills set <agent-id> --skill-ids <skill-id>
+```
+
+## 项目
+
+状态：`planned | in_progress | paused | completed | cancelled`
+
+```powershell
+aicortex project list
+aicortex project get <id>
+aicortex project create --title "项目名" --description "..." --prompt "给 Agent 的项目指令"
+aicortex project update <id> --title "..." --status in_progress --prompt "..."
+aicortex project status <id> in_progress
+aicortex project resource add <project-id> --type github_repo --url https://github.com/org/repo
+aicortex project resource list <project-id>
+aicortex project delete <id>
+```
+
+Issue 挂到项目：`aicortex issue create --title "..." --project <project-id>`。
+
+## 常见顺序
+
+1. `runtime list` → `agent create`
+2. 写 SKILL.md → `aicortex skill create`（默认 private）
+3. `agent skills set` 绑到 Agent
+4. `project create`，issue 带 `--project`

aicortexpy/data/default_skills/aicortex-graph/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: aicortex-graph
+description: "Search and write workspace Knowledge collections bound to this Agent. Use for project documents when the user explicitly asks to save to 知识库. 「记住」is NOT this skill — use aicortex memory."
+inclusion: always
+---
+
+# aicortex-graph
+
+工作区 **知识库**（团队可检索的资料）。和 **agent-memory** 是两个 skill。
+
+- 检索：Agent 详情 **Knowledge** 勾选的库，用 `aicortex graph search`
+- 写入：**仅当用户明确要求保存到知识库** 时才 `aicortex graph write`
+- 「记住」、偏好、纠正 → **`aicortex memory`**，不要 `graph write`，不要写名叫 MEMORY 的库
+
+不要用 `aicorkit graph remote login/use`。不要用本命令搜 Agent Memory（在 `.agent_context/memory.md`）。
+
+## 命令
+
+```
+aicortex graph search "architecture"
+aicortex graph search "API" --mode hybrid -n 10
+aicortex graph fetch --chunk-ids "id1,id2"
+aicortex graph walk "last week's decision" -n 5
+aicortex graph collections
+aicortex graph write --collection <slug-or-id> --title "api-auth-notes.md" --body-file ./note.md
+```
+
+不传 `--collection` 时，search 只搜已勾选的库。write 必须指定已勾选的库（只勾选一个时可省略）。没有勾选则没有命中、也不能写。
+
+需要原文时先 search 再 `fetch`。Windows 长文本用 `--body-file`。

aicortexpy/data/default_skills/graphify/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: graphify
+description: >-
+  Codebase AST knowledge graph for cheaper retrieval. Use when exploring
+  architecture, finding call paths, or answering code questions.
+  Run `graphify query` / `path` / `explain`. Install: `pip install graphifyy`
+  (https://github.com/Graphify-Labs/graphify).
+inclusion: always
+---
+
+# graphify
+
+仓库**代码**知识图谱（AST）。先 `graphify query` / `path` / `explain`，再决定要不要 grep。  
+文档/邮件/会议用 **aicorkit-graph**；工作区知识库用 **aicortex-graph**。
+
+上游：https://github.com/Graphify-Labs/graphify  
+PyPI 包名暂时是 **`graphifyy`**，CLI 仍是 **`graphify`**。
+
+## Platform
+
+Invoke `graphify` via Bash/PowerShell in the agent shell. On Windows prefer `python -m graphify` if `graphify` is not on PATH.
+
+## Requirements
+
+- Python 3.10+
+- `pip install graphifyy`
+- Test: `graphify --help`
+- Windows：命令找不到时把 `%APPDATA%\Python\Python3xx\Scripts` 加进 PATH，或 `pipx install graphifyy`
+- macOS / Linux（externally-managed）：`pipx install graphifyy`，或 `pip install graphifyy --break-system-packages`
+
+缺 CLI 再装，不要每次任务都重装。
+
+## Storage
+
+仓库根目录 `graphify-out/`（`graph.json`、`GRAPH_REPORT.md`、可选 `wiki/`）。不要把 `graphify-out/` 提交进 git。
+
+## Keep the corpus small
+
+大仓库全量扫描 / 频繁 update 很容易卡住或极慢。优先靠 **仓库根 `.graphifyignore`**（gitignore 语法）收窄语料：
+
+- 排除静态资源、设计稿/示例页、生成物、文档、vendor、测试夹具等低价值目录
+- `graphifyy` **对 JS/TS 不走 AST 缓存**：语料里若有大量前端文件，每次 `update` 都会重抽，成本很高。大 monorepo 可只索引后端/核心语言，或把前端树写进 ignore
+- ignore 写法同 gitignore：**不要用** `{ts,tsx}` 花括号（不生效）；扩展名分行写，例如 `*.ts` / `*.tsx`
+- 改过 `.graphifyignore` 后：用 `graphify extract . --code-only --no-cluster` 全量重抽；普通 `update` 会对「仍在磁盘但已 ignore」的文件 fail-closed 保留旧节点
+
+若仓库已有 `.graphifyignore`，以它为准；没有且 update 很慢时，再补一份再 extract。
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `graphify query "<question>"` | 按问题取子图 |
+| `graphify path "A" "B"` | 两个概念之间的最短路径 |
+| `graphify explain "<concept>"` | 解释一个节点 |
+| `graphify update . --no-cluster` | 在仓库根增量刷新（AST-only，跳过 community cluster） |
+| `graphify extract . --code-only --no-cluster` | 全量重抽代码图谱（缺图或改 ignore 后用） |
+| `graphify hook install` | 可选：post-commit 自动重建（只改 `.git/hooks`） |
+
+不要默认 `--mode deep`（语义/LLM 抽取，耗 token）。  
+大仓避免无 `--no-cluster` 的全量 cluster。
+
+## Usage
+
+checkout / 进入**仓库根**之后：
+
+1. `graphify --help`，失败则 `pip install graphifyy`
+2. 没有 `graphify-out/graph.json`：`graphify extract . --code-only --no-cluster`（或已有 ignore 时同样用这条建图）
+3. 已有图谱：直接 query，**不要**每次任务全量重建
+4. `.gitignore` 没有 `graphify-out/` 就补一行
+
+查架构、调用关系、模块职责：
+
+```
+graphify query "where is authentication handled?"
+graphify query "request routing" --budget 1500
+graphify path "Handler" "Repository"
+graphify explain "main"
+```
+
+`graphify-out/wiki/index.md` 存在时顺着 wiki 走。`GRAPH_REPORT.md` 只在总览架构、或 query/path/explain 不够时再读。
+
+### Update 纪律
+
+- **默认不跑 update**。即使用 `--no-cluster`，合并写盘也可能很慢。
+- 仅当本轮改了**图谱语料内**的代码、且后续还要靠图谱导航时：在仓库根执行 `graphify update . --no-cluster`
+- 改动落在 ignore 之外（例如被排除的前端树）→ **跳过** update，直接读文件 / grep
+- **禁止** `graphify update <subdir>`：会在子目录生成嵌套 `*/graphify-out/`，根目录 `query` 读不到
+
+查询时若发现命中路径明显不在当前工作范围（例如全是静态页），说明语料过大或 ignore 未生效——先收窄 `.graphifyignore` 再 extract，不要靠反复全仓 update。
+
+## Rules
+
+1. 本 skill 已挂到 Agent 上 → 整场任务保持激活；语料内代码先图谱后 grep，语料外直接 grep。
+2. **Read-only**（无需确认）：`query` / `path` / `explain` / `--help`。
+3. 缺图谱时的 `extract --code-only --no-cluster`、补 `.gitignore` / `.graphifyignore` 可直接做；`--mode deep` 仅当用户明确要求。
+4. 不要提交 `graphify-out/`。
+5. 文档/邮件检索走 **aicorkit-graph**；工作区知识库走 **aicortex-graph**。

aicortexpy/data/default_skills/question-form/SKILL.md

@@ -0,0 +1,162 @@
+# Interactive Question Forms
+
+## When to use this skill
+
+**When you need to ask the user more than one question, you MUST use a `<question-form>` block.** Never ask questions one at a time in prose — batch them into a single interactive form. The frontend renders these as tappable forms so users can answer by clicking instead of typing.
+
+Use this skill for any multi-question scenario:
+- Gathering personal info (name, preferences, background)
+- Collecting project requirements (platform, audience, features)
+- Design preferences (style, colors, mood)
+- Feedback collection (ratings, comments, suggestions)
+- Configuration setup (settings, options, parameters)
+- Any situation where the user needs to provide multiple pieces of information
+
+## Format
+
+```html
+<question-form id="unique-id" title="What you're asking about">
+{
+  "questions": [
+    // ... question objects ...
+  ]
+}
+</question-form>
+```
+
+The `id` and `title` can be set as attributes on the opening tag OR as keys in the JSON body. `title` is shown to the user as the form heading. `description` (optional, in JSON body) appears as a subtitle.
+
+Use `id` values that are short, descriptive, and unique within the form (e.g. "name", "platform", "audience").
+
+## Supported question types
+
+### radio — single choice
+```json
+{"id": "platform", "label": "What platform?", "type": "radio",
+ "options": ["Mobile (iOS/Android)", "Desktop web", "Responsive"],
+ "required": true}
+```
+Aliases: `single`, `choice`. Renders as chip-style selectable buttons. Exactly one can be picked.
+
+### checkbox — multiple choice
+```json
+{"id": "features", "label": "Must-have features?", "type": "checkbox",
+ "options": ["Authentication", "Payments", "Search", "Notifications"],
+ "maxSelections": 3}
+```
+Aliases: `multi`, `multiple`. Renders as chip-style toggle buttons. Use `maxSelections` to cap how many the user can pick.
+
+### select — dropdown menu
+```json
+{"id": "style", "label": "Visual style?", "type": "select",
+ "options": ["Minimal", "Bold", "Classic", "Playful"]}
+```
+Alias: `dropdown`. Renders as a native dropdown. Good for lists of 5+ options.
+
+### text — single line input
+```json
+{"id": "name", "label": "Your name?", "type": "text",
+ "placeholder": "e.g. Zhang San"}
+```
+Renders as a single-line text input.
+
+### textarea — multi-line input
+```json
+{"id": "requirements", "label": "Additional requirements?", "type": "textarea",
+ "placeholder": "Describe any specific needs..."}
+```
+Aliases: `long`, `paragraph`. Renders as a resizable multi-line text area.
+
+## Option formats
+
+Options can be simple strings or objects:
+
+```json
+// Simple strings
+"options": ["Mobile", "Desktop", "Responsive"]
+
+// Objects with descriptions
+"options": [
+  {"label": "Mobile", "value": "mobile", "description": "iOS and Android apps"},
+  {"label": "Desktop", "value": "desktop", "description": "Web browser on desktop"}
+]
+```
+
+When using objects:
+- `label` — shown to the user (required)
+- `value` — sent back in the answer (defaults to label if omitted)
+- `description` — shown as a subtitle below the label (optional)
+
+## Other field properties
+
+- `required: true` — user must answer before submitting
+- `placeholder: "..."` — shown when the field is empty (text/textarea only)
+- `help: "..."` — hint text shown below the label
+- `defaultValue: "..."` — pre-filled value (also accepts `default` as alias)
+
+## How answers come back
+
+When the user submits the form, you'll receive a message like:
+
+```
+[form answers — discovery]
+- Platform: Mobile (iOS/Android)
+- Name: Zhang San
+- Features: Auth, Payments
+```
+
+Read this message to understand the user's answers, then continue the conversation.
+
+## Examples
+
+### Example 1: Gathering user info
+```html
+<question-form id="user-info" title="Tell me about yourself">
+{
+  "questions": [
+    {"id": "name", "label": "Your name", "type": "text", "required": true},
+    {"id": "gender", "label": "Gender", "type": "radio",
+     "options": ["Male", "Female", "Other"], "required": true},
+    {"id": "goal", "label": "What do you want to build?", "type": "textarea",
+     "placeholder": "Describe your goal or project..."}
+  ]
+}
+</question-form>
+```
+
+### Example 2: Project requirements
+```html
+<question-form id="project-brief" title="Project requirements">
+{
+  "description": "Help me understand what you need so I can build it right.",
+  "questions": [
+    {"id": "type", "label": "Project type", "type": "radio",
+     "options": ["Landing page", "Web app", "Mobile app", "API", "Other"],
+     "required": true},
+    {"id": "platform", "label": "Target platform", "type": "checkbox",
+     "options": ["Web", "iOS", "Android", "Desktop"], "maxSelections": 3},
+    {"id": "deadline", "label": "When do you need this?", "type": "text",
+     "placeholder": "e.g. Next week, End of month"},
+    {"id": "budget", "label": "Budget or constraints?", "type": "select",
+     "options": ["No limit", "Under $100", "$100-$500", "$500+", "Just exploring"]},
+    {"id": "details", "label": "Any other details?", "type": "textarea",
+     "placeholder": "Links, references, specific requirements..."}
+  ]
+}
+</question-form>
+```
+
+### Example 3: Simple survey
+```html
+<question-form id="feedback">
+{
+  "title": "Quick feedback",
+  "questions": [
+    {"id": "satisfaction", "label": "How satisfied are you?", "type": "radio",
+     "options": ["Very satisfied", "Satisfied", "Neutral", "Unsatisfied"],
+     "required": true},
+    {"id": "comments", "label": "Any comments?", "type": "textarea"}
+  ]
+}
+</question-form>
+```

aicortexpy/data/default_skills/test-report-generator/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: test-report-generator
+description: >-
+  生成规范的软件功能测试文档：Word（.docx）测试报告 + Excel（.xlsx）测试用例清单。
+  含完整文档结构规范、字段定义和可直接运行的 Python 生成脚本（python-docx + openpyxl）。
+  Use when the user mentions 生成测试报告、编写测试用例、输出测试文档、or 测试总结.
+inclusion: always
+---
+
+# 测试文档生成技能（Test Report Generator）
+
+本技能用于指导 AGENT 生成两类交付物，二者配套使用：
+
+1. **Word 测试报告（.docx）** —— 面向管理者/客户的总结性报告，说明测试目的、范围、环境、执行结果、缺陷统计与结论。
+2. **Excel 测试用例清单（.xlsx）** —— 面向测试执行的详细用例明细，按功能模块分 Sheet 组织。
+
+本技能的结构规范提炼自真实交付样例《天合户储云管理平台-P2功能测试报告》，请严格遵循下述结构与字段。
+
+**执行用例（页面/交互验收）不在本技能范围内**：按 Excel 跑测、用宿主机 Chrome CDP 验页面、修缺陷并回写结果，改用工作区技能 `aicortex-bridge-cdp`。本技能只负责用例/报告的**文档结构与生成**。
+
+---
+
+## 何时使用本技能
+
+命中以下任一意图时启用：
+
+- "生成/编写测试报告"、"输出测试文档"、"测试总结报告"
+- "编写测试用例"、"整理测试用例清单"、"用例明细表"
+- 需求测试完成后需要交付测试文档
+- 用户提供了功能清单/缺陷数据，要求整理成规范测试交付物
+
+---
+
+## 环境准备
+
+生成脚本依赖两个 Python 库：
+
+```bash
+pip install python-docx openpyxl
+```
+
+- `python-docx`：生成 Word（.docx）
+- `openpyxl`：生成 Excel（.xlsx）
+
+Windows / PowerShell 下用 `;` 串联命令，不要用 `&&`。脚本内已用 UTF-8，无需额外配置。
+
+---
+
+## 一、Word 测试报告结构规范
+
+报告采用固定章节结构。**除非用户明确要求增减，务必保留全部章节。** 章节与内容如下：
+
+### 封面（首页）
+居中依次排列：
+- 平台/系统名称（如：`天合户储云管理平台`）
+- 测试阶段（如：`P2阶段`）
+- `测试报告`（大标题）
+- 编制单位（如：`远景智能科技有限公司`）
+- 报告日期（如：`2024年07月08日`）
+
+### 文档修订信息（表格）
+| 版本 | 修改内容描述 | 修改人 | 日期 | 审批人 |
+|---|---|---|---|---|
+| V1.0 | 初始编制 | 张三 | 2024/7/08 | 李四 |
+
+### 目录
+自动/占位目录，列出以下三级标题。
+
+### 1. 概述
+- **1.1 测试目的**：一段话说明本次测试针对的项目、环境、验证目标（新增功能 + 原有功能回归）。
+- **1.2 测试范围**：用表格列出被测模块及核心功能。
+  | # | 模块 | 核心功能 |
+  |---|---|---|
+  | 1 | 三方登录和绑定 | 绑定三方账号 / 使用三方账号登录 / 解绑三方账号 |
+- **1.3 参考资料**：项目符号列表，列出依赖文档（产品规格说明书、测试计划等）。
+
+### 2. 测试内容
+- **2.1 测试版本**：被测软件版本表。
+  | 软件名称及组织 | 软件版本 |
+  |---|---|
+  | 前端 | tag_1.0.8_xxx_2024070401 |
+  | 后端 | tag_1.2.8_240708 |
+- **2.2 测试环境**：包含三张表：
+  - 环境地址表：`环境 | 地址`（功能测试 / 集成测试 / 设备集成等）
+  - 移动端机型表：`系统 | 型号 | 版本`（iOS / Android / HarmonyOS）
+  - Web 端浏览器表：`浏览器 | 版本`
+- **2.3 测试执行**：
+  - **2.3.1 功能测试及结果**：`# | 模块 | 核心功能 | 测试结果`，测试结果取值 `Pass / Fail`。
+  - **2.3.2 集成测试及结果**：`ID | 所属模块 | 核心测试点 | 测试结果`。
+  - **2.3.3 详细测试用例**：一段说明，指向配套的 Excel 用例清单（"详细测试用例见附件 Excel《xxx测试用例.xlsx》"）。
+
+### 3. 测试结论
+- **3.1 测试结果**：
+  - 首行给出结论：`测试通过。` 或 `测试不通过。`
+  - 一段过程描述：执行了几轮功能/集成/回归测试、共执行多少用例、发现多少缺陷、修复率、是否达到上线标准。
+  - **缺陷统计表**：
+    | 问题总数 | 严重问题数 | 中等问题数 | 较轻问题 | 未解决问题数 | 问题解决率 | 严重问题比率 |
+    |---|---|---|---|---|---|---|
+    | 110 | 8 | 65 | 37 | 2 | 98% | 7% |
+- **3.2 遗留问题列表**：
+  | 模块 | 问题描述 | 说明 |
+  |---|---|---|
+  | 建站管理 | 使用欧洲地址建站时时区显示错误 | 下一版本修复 |
+
+---
+
+## 二、Excel 测试用例结构规范
+
+### Sheet 组织
+- **一个功能模块对应一个 Sheet**，Sheet 名即模块名（如 `三方登录注册和绑定`、`电价设置`、`消息中心`）。
+- 用例数量多时按功能维度拆分 Sheet，保持每个 Sheet 聚焦单一模块。
+
+### 列定义（标准 8 列，可选第 9 列责任人）
+| 列 | 字段 | 说明 |
+|---|---|---|
+| A | ID | 用例唯一编号（数字或字符串）。多步骤用例仅首行填 ID，后续步骤行留空 |
+| B | 用例名称 | 简短标题，描述测试点 |
+| C | 所属模块 | **路径式层级**，如 `/0630需求/三方登录/APP端/账号登录/正常场景` |
+| D | 前置条件 | 执行前需满足的条件，可为空 |
+| E | 备注 | 补充说明，可为空 |
+| F | 步骤描述 | 操作步骤；多步骤用 `1. … / 2. …` 或分行 |
+| G | 预期结果 | 与步骤一一对应的预期 |
+| H | 用例等级 | `P0`（冒烟/核心）/ `P1`（重要）/ `P2`（一般）/ `P3`（边缘） |
+| I | 责任人(ID) | 可选，执行人标识 |
+
+### 关键约定
+- **表头行冻结、加粗、加背景色**，正文自动换行、顶端对齐。
+- **多步骤用例**：一个用例含多组"步骤→预期"时，第一行填完整信息，后续每组步骤/预期各占一行，ID、用例名称、所属模块、前置条件列留空（表示延续上一用例）。
+- **所属模块务必用 `/` 分隔的路径**表达功能层级，便于筛选与追溯。
+- **用例等级必须落在 P0–P3**，缺省按 P1 处理。
+
+---
+
+## 三、生成脚本
+
+本技能附带 `scripts/generate_report.py` 与 `scripts/generate_cases.py`，会随 skill 下发到 Agent 工作目录。
+
+常见路径（按 runtime 取已存在的那个）：
+
+- Cursor：`.cursor/skills/test-report-generator/scripts/`
+- 默认：`.agent_context/skills/test-report-generator/scripts/`
+- Claude：`.claude/skills/test-report-generator/scripts/`
+
+**推荐做法**：根据用户数据改脚本顶部的 `SAMPLE_DATA` / `SAMPLE_MODULES`（或调用 `build_report` / `build_workbook`），再运行脚本。
+
+### 生成 Word 报告
+
+```powershell
+python ".cursor/skills/test-report-generator/scripts/generate_report.py" --output "功能测试报告.docx"
+```
+
+### 生成 Excel 用例清单
+
+```powershell
+python ".cursor/skills/test-report-generator/scripts/generate_cases.py" --output "测试用例.xlsx"
+```
+
+Linux / aicortexpod 用同样相对路径，命令用 bash。
+
+---
+
+## 四、AGENT 工作流
+
+1. **确认交付物**：明确用户要 Word 报告、Excel 用例，还是两者都要。
+2. **收集数据**：向用户索取或从项目上下文提取——系统名称、测试阶段、模块清单、环境信息、版本号、执行结果、缺陷统计、遗留问题；用例则需模块 + 每条用例的名称/步骤/预期/等级。
+3. **信息缺失时**：使用合理占位（如 `待补充`、`TBD`）并在回复中明确列出需要用户补充的字段，不要臆造缺陷数量、修复率等关键结论性数据。
+4. **构造数据结构**：把数据填入脚本的 `data` / `modules`。
+5. **运行脚本生成文件**，并校验：文件能被 python-docx / openpyxl 正常打开、表格行列数正确、无空 Sheet。
+6. **交付**：告知文件路径，并列出使用了占位符、需人工复核的部分。
+
+---
+
+## 五、注意事项
+
+- 测试结论中的**缺陷统计、修复率、是否达到上线标准**属于关键判断，必须来自真实数据，禁止编造。
+- 生成后务必人工复核，尤其是缺陷数据与测试结论。
+- 中文内容全程使用 UTF-8；文件名可含中文。
+- 若用户提供了自有模板（.docx/.xlsx），优先按其模板的样式与字段调整，本规范作为兜底结构。
+- 用户要求「完成测试 / CDP 验收 / 按用例测试并修复」时：先读并遵循 `aicortex-bridge-cdp`，再用本技能出 Word（若需要）。