paw-ps-setup

Prodig Suites 安装设置

概述

将 Prodig Suites 安装并配置到项目中。Prodig Suites 是一个产品创建系统，可引导用户从模糊的想法迈向可投入生产的产品，并支持四类产品：知识、模板、软件和服务。

此安装设置技能会搭建完整的工作区结构，包括：

• {project-root}/.pawbytes/prodig-suites/ — 模块根目录
• {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/ — 共享记忆侧车
• {project-root}/.pawbytes/prodig-suites/products/ — 产品工作区
• {project-root}/.pawbytes/prodig-suites/artifacts/ — 生成的输出

配置将写入 Pawbytes 生态系统配置文件：

• {project-root}/.pawbytes/config/config.yaml — 共享项目配置，包含用于模块专属值的 ps: 部分
• {project-root}/.pawbytes/config/config.user.yaml — 个人设置（user_name、communication_language）
• {project-root}/.pawbytes/config/module-help.csv — 注册模块功能

{project-root} 是配置值中的字面标记，切勿将其替换为实际路径。它用于向使用该值的大模型表明，此值相对于项目根目录。

原则

• 合理的默认值：每项设置都有合理的默认值；用户只需覆盖自己关心的设置
• 幂等安装设置：多次运行安装设置会保留现有工作和记忆
• 明确确认：写入文件前，准确展示将发生的更改
• 渐进式披露：搭建包含标题和简短说明的起始文件，而非完整内容
• 功能检测：验证可选的研究和报告功能，并注明缺少的内容

激活时

1. 读取 ./assets/module.yaml，获取模块元数据和变量定义（code 字段 ps 是模块标识符）
2. 检查 {project-root}/.pawbytes/prodig-suites/ 是否存在 — 如果存在，告知用户这是一次更新
3. 检查 Pawbytes 核心配置文件 {project-root}/.pawbytes/config/config.yaml 是否存在

如果用户提供了参数（例如 accept all defaults、--headless，或内联值，例如 default mode is template, quality bar is publish-ready），将提供的值映射到配置键，其余使用默认值，并跳过交互式提问。最后仍需显示完整的确认摘要。

收集配置

询问用户各项设置的值，并在方括号中显示默认值。将所有值放在一起展示，让用户只需一次性回复想要更改的值（例如“质量标准改为 publish-ready，其他都没问题”）。切勿告诉用户“按回车”或“留空”——在聊天界面中，他们必须输入内容才能回复。

默认值优先级（从高到低）：现有配置值 > ./assets/module.yaml 默认值。

核心配置（仅在尚无核心键时询问）：user_name（默认值：Pawbytes）、communication_language 和 document_output_language（默认值：英语 — 将二者合并为一个语言问题，两项键使用相同答案）。其中，user_name 和 communication_language 仅写入 config.user.yaml。

模块配置：读取 ./assets/module.yaml 中每个带有 prompt 字段的变量。使用对应的提示词及其默认值提问。

加载 ./references/config-variables.md，了解各配置变量的详细说明。

创建目录结构

收集完配置后，创建完整的工作区结构：

注意： {project-root} 是一个字面标记，运行时会解析为项目根目录。不要将其替换为实际路径。

# Main module directories
mkdir -p "{project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/product-types"
mkdir -p "{project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/daily"
mkdir -p "{project-root}/.pawbytes/prodig-suites/products"
mkdir -p "{project-root}/.pawbytes/prodig-suites/artifacts"

创建 Sidecar 文件

1. 创建 index.md（导航文件）

创建 {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/index.md：

# Prodig Suites Memory Index

**Created:** {YYYY-MM-DD}
**Last Updated:** {YYYY-MM-DD}

Welcome to Prodig Suites! This is the shared memory system that maintains context across all your product creation sessions.

## Active Products

No products yet. Start your first product with:
- "I want to create a course about..."
- "Help me build a template pack for..."
- "I have an idea for a SaaS product..."
- "I want to productize my service for..."

## Recent Activity

*No activity yet — this will be populated as you work.*

## Curated Files Status

| File | Status | Description |
|------|--------|-------------|
| product-context.md | Pending | Active product definition |
| market-intelligence.md | Pending | Research synthesis |
| audience-intelligence.md | Pending | Customer insights |
| product-decisions.md | Pending | Decision history |
| output-standards.md | Ready | Quality criteria (has defaults) |

## Product Types

Prodig Suites supports four product families:

1. **Knowledge Products** — Courses, ebooks, guides, memberships
2. **Template Products** — Templates, prompt packs, digital kits
3. **Software Products** — SaaS, apps, AI tools
4. **Service Products** — Productized services, consulting packages

## How Memory Works

- **Daily files** capture session activity (chronological, append-only)
- **Curated files** hold structured knowledge (updated as you progress)
- **Index** (this file) provides quick orientation
- All agents share this memory, so context persists across sessions

## Quick Reference

| Skill | Purpose |
|-------|---------|
| paw-ps-agent-product-builder | Main coordinator — start here |
| paw-ps-discovery | Idea exploration and validation |
| paw-ps-research | Market and competitor research |
| paw-ps-audience | Customer research and personas |
| paw-ps-research-to-brief | Convert research into product brief |
| paw-ps-strategist | Product packaging and positioning |
| paw-ps-concept-to-product-plan | Transform brief into executor-ready plan |
| paw-ps-knowledge-executor | Build courses, ebooks, guides |
| paw-ps-template-executor | Build templates, prompt packs, kits |
| paw-ps-software-executor | Build SaaS, apps, AI tools |
| paw-ps-service-executor | Build productized services |
| paw-ps-product-package-assembler | Bundle into deliverable package |
| paw-ps-publish-ready-check | Evaluate production readiness |

## Getting Started

Tell me what you want to create, and I'll help you through the full journey from idea to production-ready product.

2. 创建精选起始文件

为每个精选文件创建标题和简短说明：

product-context.md

# Product Context

*No active product yet. This file will be populated when you start a product.*

## How to Use This File

This file captures the essential context for your active product:

- **Product Name** — Working title
- **Product Type** — Knowledge, Template, Software, or Service
- **Core Premise** — What it does and why
- **Target Audience** — Who it's for
- **Current Stage** — discovery, research, brief, execution

## Starting a Product

Tell the orchestrator:
- What product you want to create
- What type it might be (if you know)
- Who it's for (if you know)

market-intelligence.md

# Market Intelligence

*Market research will be synthesized here.*

## Purpose

Captures competitive landscape, market positioning, and opportunity signals.

## Sections (populated by research)

- **Competitive Landscape** — Who else serves this market
- **Market Gaps** — Underserved needs and opportunities
- **Positioning Signals** — How to differentiate
- **Validation Points** — Evidence of demand

audience-intelligence.md

# Audience Intelligence

*Customer insights will be synthesized here.*

## Purpose

Captures deep understanding of target customers and their needs.

## Sections (populated by research)

- **Primary Persona** — Core customer profile
- **Pain Points** — Problems they're trying to solve
- **Desired Outcomes** — What success looks like
- **Buying Triggers** — What motivates purchase
- **Language Patterns** — How they describe their problems

product-decisions.md

# Product Decisions

*Key decisions will be logged here.*

## Purpose

Tracks important decisions made during product development with context for future reference.

## Decision Log Format

| Date | Decision | Rationale | Alternatives Considered |
|------|----------|-----------|------------------------|
| | | | |

## Why This Matters

- Provides context for future iterations
- Helps explain "why did we do X?"
- Prevents revisiting settled questions

output-standards.md

# Output Standards

Quality criteria for Prodig Suites deliverables.

## Configured Quality Bar

**Current Setting:** {quality_bar from config}

### Quality Bar Definitions

| Level | Definition |
|-------|------------|
| draft | Complete structure with placeholder content |
| production-ready | Complete, no placeholders, usable by intended audience |
| publish-ready | Polished, formatted, ready for publication |
| sellable-ready | Complete, polished, ready to sell |

## Product-Type Standards

### Knowledge Products
- Clear learning objectives
- Logical progression
- Actionable content
- Complete materials

### Template Products
- Working templates
- Clear instructions
- Consistent formatting
- Reusable design

### Software Products
- Clear feature definition
- User flow documented
- Technical requirements stated
- MVP scope defined

### Service Products
- Clear offer structure
- Defined deliverables
- Scope boundaries
- Pricing logic

## Output Style

**Current Setting:** {output_style from config}

| Style | Description |
|-------|-------------|
| structured-practical | Clear sections, actionable, ready to use |
| narrative-engaging | Story-driven, conversational, engaging |
| technical-detailed | Comprehensive, thorough, documentation-heavy |

3. 创建产品类型文件

创建 {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/product-types/：

knowledge-products.md

# Knowledge Products

Best practices and structures for courses, ebooks, guides, and memberships.

## Product Types

### Courses
- Define learning outcomes first
- Structure in modules → lessons → topics
- Include practice activities
- Plan assessments

### Ebooks/Guides
- Define reader transformation
- Structure in chapters → sections
- Include examples and templates
- Plan call-to-actions

### Memberships
- Define content pillars
- Plan release cadence
- Structure access levels
- Design community elements

## Output Structure

```text
knowledge-product/
├── curriculum.md        # Course outline or chapter structure
├── modules/
│   ├── module-1.md
│   └── ...
├── materials/           # Supporting materials
└── assets/              # Images, downloads, etc.
```

## Quality Checklist

- [ ] Learning objectives defined
- [ ] Logical progression verified
- [ ] Practice activities included
- [ ] All content complete (no placeholders)

template-products.md

# Template Products

Best practices for templates, prompt packs, and digital kits.

## Product Types

### Templates
- Solve specific problems
- Include clear instructions
- Use placeholder conventions
- Design for reusability

### Prompt Packs
- Group by use case
- Include example outputs
- Document parameters
- Provide variation templates

### Digital Kits
- Combine complementary assets
- Provide assembly guide
- Include source files
- Document dependencies

## Output Structure

```text
template-product/
├── templates/
│   └── template-1.{ext}
├── guide.md            # Usage instructions
├── examples/           # Example outputs
└── assets/             # Supporting files
```

## Quality Checklist

- [ ] Templates are functional
- [ ] Instructions are clear
- [ ] Formatting is consistent
- [ ] Design is reusable

software-products.md

# Software Products

Best practices for SaaS, apps, and AI tools.

## Product Types

### SaaS/Apps
- Define core value proposition
- Map user journeys
- Define MVP features
- Plan technical architecture

### AI Tools
- Define AI capabilities
- Document prompts/flows
- Plan integrations
- Design user interface

## Output Structure

```text
software-product/
├── prd-lite.md         # Product requirements
├── features/
│   └── feature-1.md
├── user-flows/
│   └── flow-1.md
└── technical/
    └── architecture.md
```

## Quality Checklist

- [ ] Value proposition clear
- [ ] MVP scope defined
- [ ] User flows documented
- [ ] Technical requirements stated

service-products.md

# Service Products

Best practices for productized services and consulting packages.

## Product Types

### Productized Services
- Define clear deliverables
- Set scope boundaries
- Standardize process
- Create pricing tiers

### Consulting Packages
- Define outcomes
- Structure engagements
- Create templates
- Document process

## Output Structure

```text
service-product/
├── offer.md            # Offer structure and pricing
├── deliverables/
│   └── deliverable-1.md
├── process.md          # Delivery process
└── templates/          # Service delivery templates
```

## Quality Checklist

- [ ] Deliverables are clear
- [ ] Scope is bounded
- [ ] Pricing is defined
- [ ] Process is documented

验证功能

检查是否具备可增强 Prodig Suites 的可选功能：

研究功能

• 可用的网页搜索工具（WebSearch、mcp__exa__web_search_exa）
• 可用的代码图谱上下文（mcp__CodeGraphContext__*）

报告功能

• 可用的演示文稿生成工具（paw-tools-presentation）
• 可用的发布工具（paw-tools-release）

在确认消息中注明缺少的功能。这些功能为可选项，但能增强套件的能力。

写入文件

将收集到的答案写入临时 JSON 文件，结构为 {"core": {...}, "module": {...}}（如果 core 已存在，则省略）。然后运行两个脚本：

python3 ./scripts/merge-config.py \
  --config-path "{project-root}/.pawbytes/config/config.yaml" \
  --user-config-path "{project-root}/.pawbytes/config/config.user.yaml" \
  --module-yaml ./assets/module.yaml \
  --answers {temp-file}

python3 ./scripts/merge-help-csv.py \
  --target "{project-root}/.pawbytes/config/module-help.csv" \
  --source ./assets/module-help.csv \
  --module-code ps

两个脚本都会将 JSON 结果输出到 stdout。如果任何一个脚本以非零状态码退出，请显示错误并停止。

运行 ./scripts/merge-config.py --help 或 ./scripts/merge-help-csv.py --help 查看完整用法。

确认

使用脚本的 JSON 输出显示已写入的内容——设置的配置值、写入 config.user.yaml 的用户设置（结果中的 user_keys）、添加的帮助条目，以及这是全新安装还是更新。然后向用户显示 ./assets/module.yaml 中的 module_greeting。

显示完整摘要：

## Setup Complete

### Configuration
- Default product mode: {value}
- Quality bar: {value}
- Output style: {value}
- Research depth: {value}

### Created Directories
- .pawbytes/prodig-suites/memory/paw-ps-sidecar/
- .pawbytes/prodig-suites/products/
- .pawbytes/prodig-suites/artifacts/

### Created Files
- index.md — Orientation file
- product-context.md — Active product context
- market-intelligence.md — Market research synthesis
- audience-intelligence.md — Customer insights
- product-decisions.md — Decision log
- output-standards.md — Quality criteria
- product-types/*.md — Product family guides

### Capability Status
{List available/missing optional capabilities}

### What's Next
Start with `paw-ps-agent-product-builder` to create your first product.

然后向用户显示 ./assets/module.yaml 中的 module_greeting。

结果

一旦知道用户的 user_name 和 communication_language（来自收集的输入、参数或现有配置），在本次会话剩余时间内都应始终使用它们：以用户配置的姓名称呼用户，并使用其配置的语言进行交流。

输出约定

安装完成后，以下内容将得到保证：

• 操作类型：模块安装/配置
• 创建的文件：
  • {project-root}/.pawbytes/prodig-suites/ 目录结构
  • {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/index.md
  • {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/*.md
  • {project-root}/.pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/product-types/*.md
  • {project-root}/.pawbytes/config/config.user.yaml（如果已收集核心配置）
• 建议：建议运行 paw-ps-agent-product-builder，开始打造首个产品
• 文件保存位置：{project-root}/.pawbytes/prodig-suites/