paw-ps-product-package-assembler

产品包组装器

概述

此工作流会将执行阶段的产品成果打包成一个完整、可投入生产的产品包。它会收集执行器的输出，根据产品类型要求检查完整性，将内容整理成结构化产品包，并生成全面的清单，确保所有输出看起来像一个统一的产品，而不是零散的草稿。

**参数：**接受 --headless / -H，用于非交互式执行。

**输出：**打包后的产品包，包含整理好的目录结构、完整性报告和打包清单。

**不可妥协的要求：**必须确保所有输出看起来像一个产品，而不是零散的草稿。

激活时

从 {project-root}/.pawbytes/config/config.yaml 和 {project-root}/.pawbytes/config/config.user.yaml（根级别和 ps 部分）加载可用配置。如果配置缺失，请告知用户可随时通过 paw-ps-setup 配置该模块。解析：

• {user_name}（null）——用姓名称呼用户
• {communication_language}（English）——用于所有沟通
• {document_output_language}（English）——用于生成的文档内容
• {output_directory}（.pawbytes/prodig-suites）——基础输出路径

从 {project-root}/.pawbytes/prodig-suites/index.md 加载共享记忆。从 {project-root}/.pawbytes/prodig-suites/output-standards.md 加载输出标准。

**产品上下文解析：**从记忆中识别当前产品，或接受作为参数传入的产品 slug。产品工作区预期位于 .pawbytes/prodig-suites/products/{product-slug}/。如果无法确定产品，请询问用户。

如果传入 --headless 或 -H，则不进行交互，运行完整流程：收集成果、检查完整性、整理产品包并生成清单。

否则，向用户问候，确认目标产品，然后按以下阶段执行。

流程

此工作流分为四个阶段。每个阶段都会使用文档即缓存模式更新打包状态文件，以便在上下文压缩后继续执行。

阶段	用途	参考资料
1. 收集成果	收集所有执行器的执行成果	加载 ./references/01-gather-artifacts.md
2. 检查完整性	根据产品类型要求进行验证	加载 ./references/02-check-completeness.md
3. 整理产品包	整理成结构统一的产品包	加载 ./references/03-organize-bundle.md
4. 生成清单	创建产品包清单和说明	加载 ./references/04-generate-manifest.md

**进度推进：**每个阶段都会在加载下一阶段之前，将结果更新到 packaging-status.md。如果流程中断，请读取 packaging-status.md，从上一个已完成的阶段继续。

打包状态文件

所有进度都写入 {project-root}/.pawbytes/prodig-suites/products/{product-slug}/packaging-status.md。此文件既是输出成果，也是恢复缓存。

---
product: '{product-slug}'
status: 'in-progress'  # pending | in-progress | complete | incomplete
current_stage: '01-gather-artifacts'
created: 'ISO-8601'
updated: 'ISO-8601'
artifacts_found: 0
artifacts_packaged: 0
missing_items: []
---

成果来源

从执行器的输出中收集成果：

来源	内容	清单文件
发现 Agent	研究报告、简报、规格说明	discovery-manifest.json
策略师	策略文档、计划	strategy-manifest.json
执行器 Agent	内容、代码、设计、媒体	executor-manifest.json
综合工作流	集成成果	synthesis-manifest.json

产品类型与完整性标准

不同产品类型需要不同的成果：

产品类型	必需成果
文档	主文档、大纲、研究笔记
应用程序	代码包、README、文档
活动	创意素材、文案、策略简报
报告	报告文档、数据来源、方法论
演示文稿	幻灯片、演讲者备注、讲义

输出结构

.pawbytes/prodig-suites/products/{product-slug}/package/
├── manifest.json           # Package manifest
├── completeness-report.md  # What's present, what's missing
├── packaging-notes.md      # Special considerations
├── artifacts/              # All gathered artifacts
│   ├── {artifact-1}
│   ├── {artifact-2}
│   └── ...
└── metadata/               # Supporting metadata
    ├── source-manifests/
    └── audit-trail.json

记忆约定

读取：

• {project-root}/.pawbytes/prodig-suites/index.md — 模块状态
• {project-root}/.pawbytes/prodig-suites/output-standards.md — 输出标准
• {project-root}/.pawbytes/prodig-suites/products/{product-slug}/product-context.md — 产品背景
• 执行阶段的执行器清单

写入：

• {project-root}/.pawbytes/prodig-suites/products/{product-slug}/packaging-status.md — 打包进度
• {project-root}/.pawbytes/prodig-suites/products/{product-slug}/package/ — 打包后的软件包
• {project-root}/.pawbytes/prodig-suites/daily/{date}.md — 每日日志（追加，标记为 [Packaging]）

升级路径

信号	路由至
缺少执行器输出	paw-ps-agent-product-builder（重新运行执行）
产物不完整	相应的执行器 Agent
质量问题	paw-ps-quality-reviewer
导出需求	paw-ps-export-handler

输出约定

每项打包交付内容都包含：

• 操作类型： 捆绑、完整性检查、整理
• 已保存文件： 所有已创建文件的路径
• 完整性状态： 已包含与缺失的内容
• 建议： 后续步骤（质量审查、重新执行等）
• 软件包位置： 已解析的软件包路径