codewave-openclaw-installer 2.1.13 → 2.2.0

package/skills/ppt-master/audit_report_workflow.md

@@ -1,233 +0,0 @@
-# PPT Master Skill — 审计报告 4: 流程完整性 & 文档一致性
-
-**审计日期**: 2026-04-07  
-**审计员**: Subagent (Workflow Auditor)
-
----
-
-## A. 流程完整性
-
-### A1. Step 1-7 逐步检查
-
-#### Step 1: Source Content Processing
-- **GATE**: ✅ 清晰 — "User has provided source material"
-- **输出/Checkpoint**: ✅ "Confirm source content is ready, proceed to Step 2"
-- **问题**: 无
-
-#### Step 2: Project Initialization
-- **GATE**: ✅ "Step 1 complete; source content is ready"
-- **输出/Checkpoint**: ✅ "Confirm project structure created successfully"
-- **问题**: 无
-
-#### Step 3: Template Selection
-- **GATE**: ✅ "Step 2 complete; project directory structure is ready"
-- **BLOCKING**: ✅ 正确标记为 ⛔ BLOCKING
-- **输出/Checkpoint**: ✅ "User has responded with template selection"
-- **问题**: 无
-
-#### Step 4: Strategist Phase
-- **GATE**: ✅ "Step 3 complete; user has confirmed template selection"
-- **BLOCKING**: ✅ 八项确认标记为 ⛔ BLOCKING
-- **输出/Checkpoint**: ✅ `design_spec.md` 输出明确
-- **问题**: 无
-
-#### Step 4.5: Bid Presentation Scene Recognition
-- **GATE**: ✅ "Step 4 complete; Design Specification generated"
-- **触发条件**: ✅ 条件型步骤，有清晰触发条件
-- **输出/Checkpoint**: ✅ "46 fixed SVGs copied, 9 dynamic pages identified"
-- **问题**: 无
-
-#### Step 5: Image_Generator Phase
-- **GATE**: ✅ "Step 4 complete; Design Specification generated and user confirmed"
-- **条件型**: ✅ 正确标记为 Conditional
-- **输出/Checkpoint**: ✅ "All images saved to images/"
-- **问题**: 无
-
-#### Step 6: Executor Phase
-- **GATE**: ✅ "Step 4 (and Step 5 if triggered) complete"
-- **输出/Checkpoint**: ✅ "All SVGs generated + speaker notes generated"
-- **问题**: 无
-
-#### Step 7: Post-processing & Export
-- **GATE**: ✅ "Step 6 complete; all SVGs generated; speaker notes generated"
-- **子步骤**: ✅ 7.1/7.2/7.2.5/7.3/7.4 逐一明确
-- **输出/Checkpoint**: ✅ PPTX 文件 + 质量检查
-- **⚠️ 问题 W-01**: Step 7.4 质量检查后没有明确的"交付给用户"确认步骤。流程在质量检查后就结束了，缺少一个最终 "Deliver to user & confirm receipt" 的 checkpoint。
-  - **行号**: SKILL.md ~Step 7.4 末尾
-  - **建议**: 增加 Step 7.5 或在 7.4 末尾增加交付确认 checkpoint
-
-### A2. 八项确认（Eight Confirmations）
-
-| # | 确认项 | 定义位置 | 默认值 |
-|---|--------|----------|--------|
-| 1 | Canvas format | Step 4 + `design_spec_reference.md` | `ppt169` (在 Step 2 `--format` 中有默认值) |
-| 2 | Page count range | Step 4 | ❌ **无明确默认值** |
-| 3 | Target audience | Step 4 | ❌ **无明确默认值** |
-| 4 | Style objective | Step 4 | ❌ **无明确默认值** |
-| 5 | Color scheme | Step 4 | ❌ **无明确默认值** |
-| 6 | Icon usage approach | Step 4 | ❌ **无明确默认值** |
-| 7 | Typography plan | Step 4 | ❌ **无明确默认值** |
-| 8 | Image usage approach | Step 4 | ❌ **无明确默认值** |
-
-- **⚠️ 问题 W-02**: 八项确认中仅 Canvas format 有隐含默认值 (`ppt169`)，其余 7 项均无默认值。虽然 Step 4 是 BLOCKING 会等用户确认，但如果用户说"全部默认"，AI 没有具体默认值可用。
-  - **行号**: Step 4 八项确认列表处
-  - **建议**: 在 `design_spec_reference.md` 或 `strategist.md` 中为每项定义合理默认值（如 Page count: 10-15, Style: professional modern, Color: blue/gray corporate, Typography: sans-serif 等）
-
-### A3. 边界情况
-
-#### 源文档类型覆盖
-| 类型 | 流程是否走通 | 备注 |
-|------|-------------|------|
-| PDF | ✅ | `pdf_to_md.py` |
-| DOCX | ✅ | `doc_to_md.py` |
-| URL | ✅ | `web_to_md.py` / `web_to_md.cjs` |
-| Markdown | ✅ | 直接读取 |
-| 纯文字描述 | ✅ | Step 2 说明 "content is already in conversation context" |
-| EPUB/HTML/LaTeX/RST | ✅ | `doc_to_md.py` 统一处理 |
-
-#### 页数边界
-- **⚠️ 问题 W-03**: 无特殊处理逻辑。
-  - **<10 页**: 无问题，正常流程。
-  - **>100 页**: 无警告或分批策略。Sub-agent 分 2-3 批的规则 (Step 6) 在 100+ 页时可能不够 — 每批 30-50 页对 sub-agent 来说负担过重。
-  - **行号**: Step 6 sub-agent 协作规则处
-  - **建议**: 增加页数阈值判断，>50 页时增加批次数或提示用户确认
-
-#### 用户中途修改设计稿
-- **⚠️ 问题 W-04**: SKILL.md 无任何回退/修改机制描述。
-  - 如果用户在 Step 6（SVG 生成中）要求修改 design_spec，没有指导如何回退
-  - **建议**: 增加一个 "Revision Protocol" 小节，说明：
-    1. 修改 design_spec → 重新从 Step 6 开始
-    2. 修改个别页面 → 手动重写对应 SVG
-    3. 修改模板选择 → 需要从 Step 3 重新开始
-
-### A4. 遗漏步骤
-
-- **⚠️ 问题 W-05**: 缺少最终用户交付确认步骤。Step 7.4 质量检查后直接结束，没有：
-  1. 向用户发送文件的明确步骤
-  2. 用户确认收到并满意的 checkpoint
-  3. 项目归档/清理的指导
-- **建议**: 增加 Step 8 "Delivery & Archive"
-
----
-
-## B. 文档一致性
-
-### B1. SKILL.md 引用的脚本 vs scripts/ 目录
-
-| SKILL.md 引用的脚本 | scripts/ 中是否存在 | 状态 |
-|---------------------|-------------------|------|
-| `pdf_to_md.py` | ✅ | OK |
-| `doc_to_md.py` | ✅ | OK |
-| `web_to_md.py` | ✅ | OK |
-| `web_to_md.cjs` | ✅ | OK |
-| `project_manager.py` | ✅ | OK |
-| `bid_init.py` | ✅ | OK |
-| `analyze_images.py` | ✅ | OK |
-| `image_gen.py` | ✅ | OK |
-| `arch_diagram.py` | ✅ | OK |
-| `svg_page_gen.py` | ✅ | OK |
-| `drawio_gen.py` | ✅ | OK |
-| `drawio_to_svg.py` | ✅ | OK |
-| `svg_quality_checker.py` | ✅ | OK |
-| `total_md_split.py` | ✅ | OK |
-| `finalize_svg.py` | ✅ | OK |
-| `svg_to_pptx.py` | ✅ | OK |
-
-**结论**: ✅ 所有 SKILL.md 引用的脚本都存在于 scripts/ 目录中。
-
-### B2. SKILL.md 引用的 reference 文件 vs references/ 目录
-
-| SKILL.md 引用的文件 | references/ 中是否存在 | 状态 |
-|--------------------|---------------------|------|
-| `references/strategist.md` | ✅ | OK |
-| `references/executor-base.md` | ✅ | OK |
-| `references/executor-general.md` | ✅ | OK |
-| `references/executor-consultant.md` | ✅ | OK |
-| `references/executor-consultant-top.md` | ✅ | OK |
-| `references/image-generator.md` | ✅ | OK |
-| `references/shared-standards.md` | ✅ | OK |
-| `references/canvas-formats.md` | ✅ | OK |
-| `references/image-layout-spec.md` | ✅ | OK |
-| `references/svg-image-embedding.md` | ✅ | OK |
-| `references/drawio-integration.md` | ✅ | OK |
-| `references/bid-presentation.md` | ✅ | OK |
-| `references/bid-content-template.md` | ✅ | OK |
-| `templates/design_spec_reference.md` | ✅ | OK |
-| `workflows/create-template.md` | ✅ | OK |
-
-**额外发现**: `references/` 中有 `template-designer.md` 和 `company_intro.md`，它们在 SKILL.md 中未被直接引用（可能被 workflows/ 或其他 reference 文件间接引用）。不算 bug，但可考虑在 SKILL.md Reference Resources 表中补充。
-
-**结论**: ✅ 所有引用的 reference 文件都存在。
-
-### B3. 脚本命令行参数一致性（抽查 5 个关键脚本）
-
-#### 1. `svg_to_pptx.py`
-- **SKILL.md 写法**: `python3 svg_to_pptx.py <project_path> -s final --only native`
-- **实际 --help**: 支持 `--only {native,legacy}` ✅
-- **⚠️ 问题 D-01**: SKILL.md 末尾 Notes 中写 "Do NOT add extra flags like `--only`"，但 Step 7.3 的命令中明确使用了 `--only native`。**自相矛盾**。
-  - **行号**: Step 7.3 命令 vs Notes 末尾
-  - **建议**: 删除 Notes 中关于 `--only` 的禁止说明，因为 `--only native` 是推荐用法
-
-#### 2. `finalize_svg.py`
-- **SKILL.md 写法**: `python3 finalize_svg.py <project_path>`
-- **实际 --help**: `finalize_svg.py project_dir` ✅ 一致
-- **状态**: ✅ OK
-
-#### 3. `svg_quality_checker.py`
-- **SKILL.md 写法**: `python3 svg_quality_checker.py <project_path> --fix` 和 `--format ppt169`
-- **实际 help**: 支持 `<directory> --fix`，但 **不接受 `--help`**（用法通过无参数运行显示），也**未显示 `--format` 参数**。
-- **⚠️ 问题 D-02**: SKILL.md Step 7.2.5 中使用了 `--format ppt169` 参数，但脚本的用法说明中未列出此参数。可能是隐藏参数，也可能不存在。
-  - **行号**: Step 7.2.5 第二条命令
-  - **建议**: 确认 `--format` 参数是否真实存在。如果不存在，从 SKILL.md 中移除
-
-#### 4. `project_manager.py`
-- **SKILL.md 写法**: `python3 project_manager.py init <project_name> --format <format>`
-- **实际 help**: `init <project_name> [--format ppt169]` ✅ 一致
-- **状态**: ✅ OK
-
-#### 5. `image_gen.py`
-- **SKILL.md 写法**: `python image_gen.py "prompt" --aspect_ratio 16:9 --image_size 1K -o <dir>`
-- **实际 --help**: 支持 `--aspect_ratio`, `--image_size`, `-o` ✅ 一致
-- **状态**: ✅ OK
-
-### B4. 示例命令可运行性
-
-| 命令 | 是否可运行 | 备注 |
-|------|-----------|------|
-| `python3 scripts/project_manager.py init test_project --format ppt169` | ✅ 可运行 | 需替换实际 project_name |
-| `python3 scripts/finalize_svg.py <project_path>` | ✅ 可运行 | 需要有效项目路径 |
-| `python3 scripts/svg_to_pptx.py <project_path> -s final --only native` | ✅ 可运行 | 参数匹配 |
-| `python3 scripts/svg_quality_checker.py <project_path> --fix` | ✅ 可运行 | |
-| `python3 scripts/svg_quality_checker.py <project_path> --format ppt169` | ⚠️ 存疑 | `--format` 参数未在 help 中出现 |
-
----
-
-## 问题汇总
-
-### 严重度: 🔴 Error / 🟡 Warning / 🟢 Info
-
-| ID | 严重度 | 类别 | 描述 | 位置 |
-|----|--------|------|------|------|
-| D-01 | 🔴 | 文档矛盾 | Step 7.3 使用 `--only native`，但 Notes 写"不要加 --only" | Step 7.3 + Notes |
-| D-02 | 🟡 | 参数不一致 | `svg_quality_checker.py --format ppt169` 参数在脚本 help 中未出现 | Step 7.2.5 |
-| W-01 | 🟡 | 流程遗漏 | 缺少最终交付确认步骤 | Step 7 末尾 |
-| W-02 | 🟡 | 默认值缺失 | 八项确认中 7/8 项无默认值 | Step 4 |
-| W-03 | 🟢 | 边界未处理 | >100 页时无特殊分批策略 | Step 6 |
-| W-04 | 🟡 | 流程缺失 | 无回退/修改机制 | 全局 |
-| W-05 | 🟡 | 流程遗漏 | 缺少项目归档/清理步骤 | Step 7 后 |
-
-### 修复建议优先级
-
-1. **D-01 (立即修复)**: 删除 Notes 中 "Do NOT add extra flags like `--only`" 的说明，因为 `--only native` 是当前推荐用法
-2. **D-02 (验证)**: 运行 `svg_quality_checker.py <dir> --format ppt169` 确认参数是否有效；如无效则从 SKILL.md 移除
-3. **W-04 (建议增加)**: 增加 "Revision Protocol" 小节
-4. **W-02 (建议增加)**: 为八项确认增加默认值
-5. **W-01/W-05 (建议增加)**: 增加 Step 8 交付与归档
-
----
-
-## 总体评价
-
-**流程完整性: 8/10** — 主流程清晰、GATE/BLOCKING 标记准确、依赖关系正确。主要扣分项是缺少回退机制和交付确认步骤。
-
-**文档一致性: 9/10** — 所有脚本和 reference 文件都存在，命令行参数大部分一致。唯一的严重问题是 `--only` 的自相矛盾说明，以及 `--format` 参数的存疑。

package/skills/ppt-master/fix_report_bid.md

@@ -1,51 +0,0 @@
-# Fix Report B: 述标模式通用化
-
-## 修复摘要
-
-将述标 PPT 流程从硬编码的网易/CodeWave 内容改造为通用模板框架。
-
-## 修改文件清单
-
-### 改造的文件
-
-| 文件 | 变更说明 |
-|------|---------|
-| `references/bid-presentation.md` | **核心改造**：将所有网易/CodeWave 硬编码内容替换为 `{占位符}`；新增"用户必填信息"章节，定义 Strategist 阶段需收集的公司信息（8个必填项 + 8个建议项）；更新 Content Outline 示例使用占位符；配色方案改为基于 `{brand_color}`；快速生成流程增加公司匹配检查说明 |
-| `references/bid-content-template.md` | **核心改造**：55页内容全部通用化，第5-11页公司介绍、第18-32页核心优势、第34-40页案例、第42-48页服务、第50-55页交付全部使用占位符；删除具体的网易营收数据、员工姓名、产品细节等，保留页面结构和内容指引 |
-| `scripts/bid_init.py` | 增加警告信息：提示预制 SVG 包含特定公司内容，如投标公司不同需从零生成 |
-
-### 新增的示例文件
-
-| 文件 | 说明 |
-|------|------|
-| `references/bid-example-netease.md` | 原 `bid-presentation.md` 的完整备份，添加"示例参考"标头 |
-| `references/bid-content-example-netease.md` | 原 `bid-content-template.md` 的完整备份，添加"示例参考"标头 |
-
-## 通用化要点
-
-### 占位符体系
-
-- `{company_name}` — 投标公司名称（替代"网易"）
-- `{product_name}` — 核心产品名称（替代"CodeWave"）
-- `{business_unit}` — 业务单元名称（替代"CodeWave业务中心"）
-- `{brand_color}` — 品牌主色（替代 #C5282E）
-- 其他：`{company_founding_years}`, `{employee_count}`, `{company_slogan}`, `{website_url}` 等
-
-### Strategist 集成
-
-- 新增用户信息收集步骤（在 Eight Confirmations 之前）
-- 支持从用户提供的公司介绍文档自动提取信息
-- 必填项未提供时逐项询问
-
-### 向后兼容
-
-- `references/bid-svgs/` 中的预制 SVG 保持不变（仍为网易内容）
-- `references/company_intro.md` 和 `company_intro_images/` 保持不变
-- `bid_init.py` 机制不变，仅增加警告
-- 网易完整示例保存为 `bid-example-netease.md` + `bid-content-example-netease.md`
-
-## 影响范围
-
-- 新的述标项目将使用通用模板，需要用户提供公司信息
-- 如果投标方恰好是网易，可直接参考示例文件快速填充
-- 现有的预制 SVG（bid-svgs/）仍可用于网易项目，其他公司需从零生成

package/skills/ppt-master/fix_report_scripts.md

@@ -1,41 +0,0 @@
-# Fix Report: Scripts Exception Handling
-
-## Summary
-
-Added exception handling to 4 files across 3 scripts. No core logic was changed.
-
-## Changes
-
-### 1. `scripts/svg_to_pptx/pptx_cli.py`
-- **Top-level try/except**: Wrapped `main()` with `_main_impl()` pattern. Catches `KeyboardInterrupt` (exit 130), re-raises `SystemExit`, catches all other exceptions with type+message to stderr.
-- **Existing**: Per-slide error isolation was already present in `pptx_builder.py` — no changes needed there.
-
-### 2. `scripts/svg_to_pptx/pptx_builder.py`
-- **Improved failure reporting**: Enhanced the final summary to explicitly note when slides failed and were skipped.
-- **Existing**: Per-slide `try/except Exception` isolation was already in place (each SVG page failure is caught, logged, and skipped). ✅
-
-### 3. `scripts/svg_page_gen.py`
-- **Top-level try/except**: Same `main()` → `_main_impl()` pattern with `KeyboardInterrupt`, `SystemExit`, generic `Exception`.
-- **JSON parse error handling**: `json.JSONDecodeError` caught with clear error message pointing to the input file.
-- **File I/O errors**: `FileNotFoundError` and `IOError` caught for input file reading and output directory creation.
-- **Per-page error isolation**: Each page generation+write is now wrapped in try/except. Failed pages are skipped, counted, and listed in the final summary.
-- **Background image loading**: `load_bg()` now catches `IOError` and returns `None` gracefully instead of crashing.
-
-### 4. `scripts/finalize_svg.py`
-- **Top-level try/except**: Same `main()` → `_main_impl()` pattern.
-- **Existing**: Individual step functions (`process_flatten_text`, `process_rounded_rect`) already had try/except. ✅
-
-## Error Isolation Behavior
-
-| Script | Failure Scope | Behavior |
-|--------|--------------|----------|
-| `svg_to_pptx` | Single slide | Skip failed slide, continue others, report at end |
-| `svg_page_gen` | Single page | Skip failed page, continue others, list failures at end |
-| `finalize_svg` | Single step/file | Individual steps already isolated, top-level added |
-
-## Design Decisions
-- Used `_main_impl()` pattern to keep arg parsing clean while wrapping everything
-- Specific exception types: `FileNotFoundError`, `json.JSONDecodeError`, `IOError`, `OSError`, `KeyboardInterrupt`
-- No bare `except:` anywhere — all catches are typed
-- Error messages include exception type name for debuggability
-- `sys.stderr` used for error output to separate from normal stdout