@pzy560117/codex-harness 0.1.0 → 0.1.2

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/pptx/scripts/thumbnail.py

@@ -0,0 +1,450 @@
+#!/usr/bin/env python3
+"""
+Create thumbnail grids from PowerPoint presentation slides.
+
+Creates a grid layout of slide thumbnails with configurable columns (max 6).
+Each grid contains up to cols×(cols+1) images. For presentations with more
+slides, multiple numbered grid files are created automatically.
+
+The program outputs the names of all files created.
+
+Output:
+- Single grid: {prefix}.jpg (if slides fit in one grid)
+- Multiple grids: {prefix}-1.jpg, {prefix}-2.jpg, etc.
+
+Grid limits by column count:
+- 3 cols: max 12 slides per grid (3×4)
+- 4 cols: max 20 slides per grid (4×5)
+- 5 cols: max 30 slides per grid (5×6) [default]
+- 6 cols: max 42 slides per grid (6×7)
+
+Usage:
+    python thumbnail.py input.pptx [output_prefix] [--cols N] [--outline-placeholders]
+
+Examples:
+    python thumbnail.py presentation.pptx
+    # Creates: thumbnails.jpg (using default prefix)
+    # Outputs:
+    #   Created 1 grid(s):
+    #     - thumbnails.jpg
+
+    python thumbnail.py large-deck.pptx grid --cols 4
+    # Creates: grid-1.jpg, grid-2.jpg, grid-3.jpg
+    # Outputs:
+    #   Created 3 grid(s):
+    #     - grid-1.jpg
+    #     - grid-2.jpg
+    #     - grid-3.jpg
+
+    python thumbnail.py template.pptx analysis --outline-placeholders
+    # Creates thumbnail grids with red outlines around text placeholders
+"""
+
+import argparse
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+from inventory import extract_text_inventory
+from PIL import Image, ImageDraw, ImageFont
+from pptx import Presentation
+
+# Constants
+THUMBNAIL_WIDTH = 300  # Fixed thumbnail width in pixels
+CONVERSION_DPI = 100  # DPI for PDF to image conversion
+MAX_COLS = 6  # Maximum number of columns
+DEFAULT_COLS = 5  # Default number of columns
+JPEG_QUALITY = 95  # JPEG compression quality
+
+# Grid layout constants
+GRID_PADDING = 20  # Padding between thumbnails
+BORDER_WIDTH = 2  # Border width around thumbnails
+FONT_SIZE_RATIO = 0.12  # Font size as fraction of thumbnail width
+LABEL_PADDING_RATIO = 0.4  # Label padding as fraction of font size
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Create thumbnail grids from PowerPoint slides."
+    )
+    parser.add_argument("input", help="Input PowerPoint file (.pptx)")
+    parser.add_argument(
+        "output_prefix",
+        nargs="?",
+        default="thumbnails",
+        help="Output prefix for image files (default: thumbnails, will create prefix.jpg or prefix-N.jpg)",
+    )
+    parser.add_argument(
+        "--cols",
+        type=int,
+        default=DEFAULT_COLS,
+        help=f"Number of columns (default: {DEFAULT_COLS}, max: {MAX_COLS})",
+    )
+    parser.add_argument(
+        "--outline-placeholders",
+        action="store_true",
+        help="Outline text placeholders with a colored border",
+    )
+
+    args = parser.parse_args()
+
+    # Validate columns
+    cols = min(args.cols, MAX_COLS)
+    if args.cols > MAX_COLS:
+        print(f"Warning: Columns limited to {MAX_COLS} (requested {args.cols})")
+
+    # Validate input
+    input_path = Path(args.input)
+    if not input_path.exists() or input_path.suffix.lower() != ".pptx":
+        print(f"Error: Invalid PowerPoint file: {args.input}")
+        sys.exit(1)
+
+    # Construct output path (always JPG)
+    output_path = Path(f"{args.output_prefix}.jpg")
+
+    print(f"Processing: {args.input}")
+
+    try:
+        with tempfile.TemporaryDirectory() as temp_dir:
+            # Get placeholder regions if outlining is enabled
+            placeholder_regions = None
+            slide_dimensions = None
+            if args.outline_placeholders:
+                print("Extracting placeholder regions...")
+                placeholder_regions, slide_dimensions = get_placeholder_regions(
+                    input_path
+                )
+                if placeholder_regions:
+                    print(f"Found placeholders on {len(placeholder_regions)} slides")
+
+            # Convert slides to images
+            slide_images = convert_to_images(input_path, Path(temp_dir), CONVERSION_DPI)
+            if not slide_images:
+                print("Error: No slides found")
+                sys.exit(1)
+
+            print(f"Found {len(slide_images)} slides")
+
+            # Create grids (max cols×(cols+1) images per grid)
+            grid_files = create_grids(
+                slide_images,
+                cols,
+                THUMBNAIL_WIDTH,
+                output_path,
+                placeholder_regions,
+                slide_dimensions,
+            )
+
+            # Print saved files
+            print(f"Created {len(grid_files)} grid(s):")
+            for grid_file in grid_files:
+                print(f"  - {grid_file}")
+
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+
+def create_hidden_slide_placeholder(size):
+    """Create placeholder image for hidden slides."""
+    img = Image.new("RGB", size, color="#F0F0F0")
+    draw = ImageDraw.Draw(img)
+    line_width = max(5, min(size) // 100)
+    draw.line([(0, 0), size], fill="#CCCCCC", width=line_width)
+    draw.line([(size[0], 0), (0, size[1])], fill="#CCCCCC", width=line_width)
+    return img
+
+
+def get_placeholder_regions(pptx_path):
+    """Extract ALL text regions from the presentation.
+
+    Returns a tuple of (placeholder_regions, slide_dimensions).
+    text_regions is a dict mapping slide indices to lists of text regions.
+    Each region is a dict with 'left', 'top', 'width', 'height' in inches.
+    slide_dimensions is a tuple of (width_inches, height_inches).
+    """
+    prs = Presentation(str(pptx_path))
+    inventory = extract_text_inventory(pptx_path, prs)
+    placeholder_regions = {}
+
+    # Get actual slide dimensions in inches (EMU to inches conversion)
+    slide_width_inches = (prs.slide_width or 9144000) / 914400.0
+    slide_height_inches = (prs.slide_height or 5143500) / 914400.0
+
+    for slide_key, shapes in inventory.items():
+        # Extract slide index from "slide-N" format
+        slide_idx = int(slide_key.split("-")[1])
+        regions = []
+
+        for shape_key, shape_data in shapes.items():
+            # The inventory only contains shapes with text, so all shapes should be highlighted
+            regions.append(
+                {
+                    "left": shape_data.left,
+                    "top": shape_data.top,
+                    "width": shape_data.width,
+                    "height": shape_data.height,
+                }
+            )
+
+        if regions:
+            placeholder_regions[slide_idx] = regions
+
+    return placeholder_regions, (slide_width_inches, slide_height_inches)
+
+
+def convert_to_images(pptx_path, temp_dir, dpi):
+    """Convert PowerPoint to images via PDF, handling hidden slides."""
+    # Detect hidden slides
+    print("Analyzing presentation...")
+    prs = Presentation(str(pptx_path))
+    total_slides = len(prs.slides)
+
+    # Find hidden slides (1-based indexing for display)
+    hidden_slides = {
+        idx + 1
+        for idx, slide in enumerate(prs.slides)
+        if slide.element.get("show") == "0"
+    }
+
+    print(f"Total slides: {total_slides}")
+    if hidden_slides:
+        print(f"Hidden slides: {sorted(hidden_slides)}")
+
+    pdf_path = temp_dir / f"{pptx_path.stem}.pdf"
+
+    # Convert to PDF
+    print("Converting to PDF...")
+    result = subprocess.run(
+        [
+            "soffice",
+            "--headless",
+            "--convert-to",
+            "pdf",
+            "--outdir",
+            str(temp_dir),
+            str(pptx_path),
+        ],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0 or not pdf_path.exists():
+        raise RuntimeError("PDF conversion failed")
+
+    # Convert PDF to images
+    print(f"Converting to images at {dpi} DPI...")
+    result = subprocess.run(
+        ["pdftoppm", "-jpeg", "-r", str(dpi), str(pdf_path), str(temp_dir / "slide")],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        raise RuntimeError("Image conversion failed")
+
+    visible_images = sorted(temp_dir.glob("slide-*.jpg"))
+
+    # Create full list with placeholders for hidden slides
+    all_images = []
+    visible_idx = 0
+
+    # Get placeholder dimensions from first visible slide
+    if visible_images:
+        with Image.open(visible_images[0]) as img:
+            placeholder_size = img.size
+    else:
+        placeholder_size = (1920, 1080)
+
+    for slide_num in range(1, total_slides + 1):
+        if slide_num in hidden_slides:
+            # Create placeholder image for hidden slide
+            placeholder_path = temp_dir / f"hidden-{slide_num:03d}.jpg"
+            placeholder_img = create_hidden_slide_placeholder(placeholder_size)
+            placeholder_img.save(placeholder_path, "JPEG")
+            all_images.append(placeholder_path)
+        else:
+            # Use the actual visible slide image
+            if visible_idx < len(visible_images):
+                all_images.append(visible_images[visible_idx])
+                visible_idx += 1
+
+    return all_images
+
+
+def create_grids(
+    image_paths,
+    cols,
+    width,
+    output_path,
+    placeholder_regions=None,
+    slide_dimensions=None,
+):
+    """Create multiple thumbnail grids from slide images, max cols×(cols+1) images per grid."""
+    # Maximum images per grid is cols × (cols + 1) for better proportions
+    max_images_per_grid = cols * (cols + 1)
+    grid_files = []
+
+    print(
+        f"Creating grids with {cols} columns (max {max_images_per_grid} images per grid)"
+    )
+
+    # Split images into chunks
+    for chunk_idx, start_idx in enumerate(
+        range(0, len(image_paths), max_images_per_grid)
+    ):
+        end_idx = min(start_idx + max_images_per_grid, len(image_paths))
+        chunk_images = image_paths[start_idx:end_idx]
+
+        # Create grid for this chunk
+        grid = create_grid(
+            chunk_images, cols, width, start_idx, placeholder_regions, slide_dimensions
+        )
+
+        # Generate output filename
+        if len(image_paths) <= max_images_per_grid:
+            # Single grid - use base filename without suffix
+            grid_filename = output_path
+        else:
+            # Multiple grids - insert index before extension with dash
+            stem = output_path.stem
+            suffix = output_path.suffix
+            grid_filename = output_path.parent / f"{stem}-{chunk_idx + 1}{suffix}"
+
+        # Save grid
+        grid_filename.parent.mkdir(parents=True, exist_ok=True)
+        grid.save(str(grid_filename), quality=JPEG_QUALITY)
+        grid_files.append(str(grid_filename))
+
+    return grid_files
+
+
+def create_grid(
+    image_paths,
+    cols,
+    width,
+    start_slide_num=0,
+    placeholder_regions=None,
+    slide_dimensions=None,
+):
+    """Create thumbnail grid from slide images with optional placeholder outlining."""
+    font_size = int(width * FONT_SIZE_RATIO)
+    label_padding = int(font_size * LABEL_PADDING_RATIO)
+
+    # Get dimensions
+    with Image.open(image_paths[0]) as img:
+        aspect = img.height / img.width
+    height = int(width * aspect)
+
+    # Calculate grid size
+    rows = (len(image_paths) + cols - 1) // cols
+    grid_w = cols * width + (cols + 1) * GRID_PADDING
+    grid_h = rows * (height + font_size + label_padding * 2) + (rows + 1) * GRID_PADDING
+
+    # Create grid
+    grid = Image.new("RGB", (grid_w, grid_h), "white")
+    draw = ImageDraw.Draw(grid)
+
+    # Load font with size based on thumbnail width
+    try:
+        # Use Pillow's default font with size
+        font = ImageFont.load_default(size=font_size)
+    except Exception:
+        # Fall back to basic default font if size parameter not supported
+        font = ImageFont.load_default()
+
+    # Place thumbnails
+    for i, img_path in enumerate(image_paths):
+        row, col = i // cols, i % cols
+        x = col * width + (col + 1) * GRID_PADDING
+        y_base = (
+            row * (height + font_size + label_padding * 2) + (row + 1) * GRID_PADDING
+        )
+
+        # Add label with actual slide number
+        label = f"{start_slide_num + i}"
+        bbox = draw.textbbox((0, 0), label, font=font)
+        text_w = bbox[2] - bbox[0]
+        draw.text(
+            (x + (width - text_w) // 2, y_base + label_padding),
+            label,
+            fill="black",
+            font=font,
+        )
+
+        # Add thumbnail below label with proportional spacing
+        y_thumbnail = y_base + label_padding + font_size + label_padding
+
+        with Image.open(img_path) as img:
+            # Get original dimensions before thumbnail
+            orig_w, orig_h = img.size
+
+            # Apply placeholder outlines if enabled
+            if placeholder_regions and (start_slide_num + i) in placeholder_regions:
+                # Convert to RGBA for transparency support
+                if img.mode != "RGBA":
+                    img = img.convert("RGBA")
+
+                # Get the regions for this slide
+                regions = placeholder_regions[start_slide_num + i]
+
+                # Calculate scale factors using actual slide dimensions
+                if slide_dimensions:
+                    slide_width_inches, slide_height_inches = slide_dimensions
+                else:
+                    # Fallback: estimate from image size at CONVERSION_DPI
+                    slide_width_inches = orig_w / CONVERSION_DPI
+                    slide_height_inches = orig_h / CONVERSION_DPI
+
+                x_scale = orig_w / slide_width_inches
+                y_scale = orig_h / slide_height_inches
+
+                # Create a highlight overlay
+                overlay = Image.new("RGBA", img.size, (255, 255, 255, 0))
+                overlay_draw = ImageDraw.Draw(overlay)
+
+                # Highlight each placeholder region
+                for region in regions:
+                    # Convert from inches to pixels in the original image
+                    px_left = int(region["left"] * x_scale)
+                    px_top = int(region["top"] * y_scale)
+                    px_width = int(region["width"] * x_scale)
+                    px_height = int(region["height"] * y_scale)
+
+                    # Draw highlight outline with red color and thick stroke
+                    # Using a bright red outline instead of fill
+                    stroke_width = max(
+                        5, min(orig_w, orig_h) // 150
+                    )  # Thicker proportional stroke width
+                    overlay_draw.rectangle(
+                        [(px_left, px_top), (px_left + px_width, px_top + px_height)],
+                        outline=(255, 0, 0, 255),  # Bright red, fully opaque
+                        width=stroke_width,
+                    )
+
+                # Composite the overlay onto the image using alpha blending
+                img = Image.alpha_composite(img, overlay)
+                # Convert back to RGB for JPEG saving
+                img = img.convert("RGB")
+
+            img.thumbnail((width, height), Image.Resampling.LANCZOS)
+            w, h = img.size
+            tx = x + (width - w) // 2
+            ty = y_thumbnail + (height - h) // 2
+            grid.paste(img, (tx, ty))
+
+            # Add border
+            if BORDER_WIDTH > 0:
+                draw.rectangle(
+                    [
+                        (tx - BORDER_WIDTH, ty - BORDER_WIDTH),
+                        (tx + w + BORDER_WIDTH - 1, ty + h + BORDER_WIDTH - 1),
+                    ],
+                    outline="gray",
+                    width=BORDER_WIDTH,
+                )
+
+    return grid
+
+
+if __name__ == "__main__":
+    main()

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: prd-writer
+description: 撰写产品需求文档(PRD)并生成可交互原型。触发条件：用户提到"需求文档"、"PRD"、"产品需求"、"写需求"、"原型"、"feature list"等关键词。集成 UI-UX-Pro-Max 设计系统，支持 Cloudflare Pages 部署。
+---
+
+# PRD Writer
+
+产品需求文档撰写 + 原型生成工作流。
+
+## 工作流程
+
+### 阶段1：需求采集
+
+整理用户输入（会议记录/需求描述）为结构化格式：
+
+```
+## 核心业务流程
+- 🔴 P0 功能名称：功能描述
+
+## 用户端功能  
+- 🟡 P1 功能名称：功能描述
+
+## 管理端功能
+- 🟢 P2 功能名称：功能描述
+```
+
+优先级：🔴 P0（必须）/ 🟡 P1（重要）/ 🟢 P2（优化）
+
+详细 prompt 模板见 [references/prompts.md](references/prompts.md)
+
+### 阶段2：Feature List
+
+按模块组织功能表格，使用 [references/feature-list-template.md](references/feature-list-template.md)
+
+**完整性检查**：主动指出缺失环节（如有"加购物车"但没"购物车编辑"）
+
+### 阶段3：PRD 文档
+
+使用 [references/prd-template.md](references/prd-template.md) 生成完整 PRD。
+
+### 阶段4：原型生成
+
+本 skill 直接复用同级 [ui-ux-pro-max](../ui-ux-pro-max/SKILL.md) 的脚本和数据，不再维护内嵌副本。
+
+#### Step 1: 生成设计系统
+
+```bash
+python3 ../ui-ux-pro-max/scripts/search.py "<产品类型> <风格>" --design-system -p "项目名"
+```
+
+示例：
+```bash
+python3 ../ui-ux-pro-max/scripts/search.py "travel mobile app" --design-system -p "旅行App"
+python3 ../ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system -p "分析平台"
+```
+
+#### Step 2: 按需获取详细设计数据
+
+```bash
+# 配色方案
+python3 ../ui-ux-pro-max/scripts/search.py "modern elegant" --domain color
+
+# 字体配对
+python3 ../ui-ux-pro-max/scripts/search.py "professional" --domain typography
+
+# UX 准则
+python3 ../ui-ux-pro-max/scripts/search.py "mobile form" --domain ux
+
+# 技术栈指南
+python3 ../ui-ux-pro-max/scripts/search.py "responsive" --stack html-tailwind
+```
+
+可用 domain: `style`, `color`, `typography`, `ux`, `product`, `landing`, `chart`
+可用 stack: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `shadcn`, `swiftui`, `react-native`, `flutter`
+
+#### Step 3: 生成 HTML 原型
+
+基于设计系统输出，生成单文件 HTML（Tailwind CSS + 原生 JS）。
+
+技术规格见 [references/prototype-guide.md](references/prototype-guide.md)
+
+### 阶段5：部署（可选）
+
+Cloudflare Pages 部署（国内可访问）：
+
+```bash
+cd prototype && wrangler pages deploy . --project-name=your-project
+```
+
+详见 [references/cloudflare-deploy.md](references/cloudflare-deploy.md)
+
+## 质量检查
+
+完成后以四角色审视，详见 [references/quality-checklist.md](references/quality-checklist.md)：
+
+1. **技术负责人**：实现难度、性能、安全
+2. **挑剔用户**：操作便捷性、流程合理性
+3. **运营负责人**：数据分析、营销推广
+4. **测试工程师**：异常场景、边界问题
+
+## 输出文件
+
+- `feature_list.md` - 功能清单
+- `PRD.md` - 完整需求文档
+- `design-system/` - 设计系统
+- `prototype.html` - 可交互原型

package/package-source/docs/codex-harness-engineering/templates/package-assets/skills/prd-writer-skill/references/cloudflare-deploy.md

@@ -0,0 +1,133 @@
+# Cloudflare Pages 部署指南
+
+## 项目结构
+
+```
+prototype/
+├── index.html          # 原型页面
+└── (其他静态资源)
+```
+
+## 前置准备：API Token 配置
+
+在服务器/CI 环境中部署（无法交互式登录）时，需要提前配置 API Token。
+
+### 创建 API Token
+
+1. 访问 https://dash.cloudflare.com/profile/api-tokens
+2. 点击 **Create Token** → **Custom Token**
+3. 配置以下权限：
+
+| 权限 | 资源范围 | 说明 |
+|------|---------|------|
+| `Cloudflare Pages:Edit` | Account | 创建/更新 Pages 项目（必须） |
+| `Account Settings:Read` | Account | 读取账户信息（必须） |
+| `Zone:Read` | All Zones | 自定义域名时需要 |
+| `DNS:Edit` | 指定 Zone | 配置 DNS 绑定域名时需要 |
+
+4. 创建后复制 Token（只显示一次）
+
+### 获取 Account ID
+
+在 Cloudflare Dashboard 右侧边栏可以看到 **Account ID**，复制备用。
+
+### 配置环境变量
+
+```bash
+export CLOUDFLARE_API_TOKEN="your-api-token"
+export CLOUDFLARE_ACCOUNT_ID="your-account-id"
+```
+
+或写入 `.env` 文件（注意不要提交到 Git）：
+
+```
+CLOUDFLARE_API_TOKEN=your-api-token
+CLOUDFLARE_ACCOUNT_ID=your-account-id
+```
+
+配置好后，`wrangler` 会自动读取这两个环境变量，无需交互式登录。
+
+---
+
+## 部署方式
+
+### 方式1：Wrangler CLI（推荐）
+
+```bash
+# 安装 Wrangler
+npm install -g wrangler
+
+# 本地开发：交互式登录（浏览器授权）
+wrangler login
+
+# 服务器/CI：使用 API Token（见上方前置准备）
+# 确保已设置 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID
+
+# 部署到 Cloudflare Pages
+cd prototype
+wrangler pages deploy . --project-name=your-project-name
+```
+
+### 方式2：Cloudflare Dashboard
+
+1. 访问 https://dash.cloudflare.com
+2. 进入 **Workers & Pages** → **Create**
+3. 选择 **Pages** → **Upload assets**
+4. 拖入 `prototype` 文件夹
+5. 设置项目名称，点击部署
+
+### 方式3：连接 Git 仓库
+
+1. 访问 https://dash.cloudflare.com
+2. 进入 **Workers & Pages** → **Create**
+3. 选择 **Pages** → **Connect to Git**
+4. 选择 GitHub 仓库
+5. 构建设置：
+   - **Build command**: 留空（静态站点）
+   - **Build output directory**: `/` 或 `public`
+6. 点击 **Save and Deploy**
+
+## 环境变量（可选）
+
+如需配置环境变量：
+
+1. 进入项目设置 → **Environment variables**
+2. 添加变量（如 `API_URL`）
+3. 重新部署生效
+
+## 自定义域名（可选）
+
+1. 进入项目设置 → **Custom domains**
+2. 点击 **Set up a custom domain**
+3. 输入你的域名
+4. 按提示配置 DNS 记录
+
+## 常见问题
+
+### 1. 404 错误
+确保 `index.html` 在根目录
+
+### 2. 路由问题
+添加 `_redirects` 文件：
+```
+/*    /index.html   200
+```
+
+### 3. 缓存问题
+Cloudflare 自动处理缓存，无需额外配置
+
+## 优势
+
+- ✅ **国内可访问** - 无需科学上网
+- ✅ **免费额度充足** - 每月 500 次构建
+- ✅ **自动 HTTPS** - 免费 SSL 证书
+- ✅ **全球 CDN** - 访问速度快
+- ✅ **无需备案** - pages.dev 域名
+
+## 示例地址
+
+部署后会获得类似地址：
+```
+https://your-project.pages.dev
+https://abc12345.your-project.pages.dev
+```