关于 paw-ps-publish-ready-check
paw-ps-publish-ready-check 是用于评估产品能否进入生产、发布或销售阶段的质量检查工作流,面向产品创建者。它按产品类型匹配标准,记录缺口、分级问题并生成带依据的结论。
主要功能
- 01按产品类型匹配评估标准
- 02评估功能、完整度、清晰度和易用性
- 03将缺口分为关键、重要和次要
- 04生成就绪结论及可执行修复清单
- 05输出 HTML 与 Markdown 报告
适用场景
- 01发布前检查产品是否达到目标标准
- 02找出阻碍产品上线或销售的问题
- 03以无提示模式批量执行就绪评估
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ pawbytes/ skill-suites --skill paw-ps-publish-ready-check安装后在 Claude Code 中输入/paw-ps-publish-ready-check确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/01-load-bundle.md02-assess-quality.md03-check-gaps.md04-generate-verdict.mdreadiness-criteria.csv详细介绍
发布就绪检查
概述
一套严谨的质量评估工作流,用于判定产品是否达到投产、发布或销售的门槛。此工作流通过应用明确的质量标准,而非流于表面的批准,避免套件夸大产品的就绪程度。
参数: 支持使用 --headless / -H 进行非交互式执行。
输出: 就绪情况报告(HTML)、差距分析,以及最终判定;如适用,还会提供修复清单。
流程
阶段 1:加载产品包
加载 ./references/01-load-bundle.md
收集打包好的产品包,并找到所有相关标准和上下文文件。确定正在评估的产品类型,以及适用的标准。
推进条件: 找到产品包并识别产品类型后继续。
阶段 2:评估质量
加载 ./references/02-assess-quality.md
系统地应用质量标准,评估所有维度:功能性、完整性、清晰度、易用性和文档。根据既定标准为每个维度评分。
推进条件: 评估并完成所有质量维度的评分后继续。
阶段 3:检查差距
加载 ./references/03-check-gaps.md
确定具体阻碍发布的问题。将差距分类为关键(必须修复)、重要(应该修复)或次要(有则更好)。生成可执行的修复清单。
推进条件: 记录所有差距并完成严重程度分类后继续。
阶段 4:生成判定
加载 ./references/04-generate-verdict.md
作出最终判定:可投产、可发布、可销售或尚未就绪。根据目标就绪级别应用相应门槛。
推进条件: 完成判定并记录后结束。
激活时
- 确定产品工作区根目录:
{project-root}/.pawbytes/prodig-suites/ - 如果
.pawbytes/prodig-suites/active-product.md存在,则识别当前活跃产品 - 如果没有活跃产品且未处于无头模式,请提示用户指定:
- 产品标识(要评估哪个产品)
- 目标就绪级别(投产 / 发布 / 销售)
- 从阶段 1 开始执行流程
就绪级别
| 级别 | 定义 | 质量标准 |
|---|---|---|
| 可投产 | 完整、可运行,并且目标受众可以使用 | 核心功能正常,文档充分,没有关键缺陷 |
| 可发布 | 格式完善、经过润色,可在发布平台发布 | 达到可投产标准 + 专业的呈现效果,并符合平台要求 |
| 可销售 | 完整、经过润色,并具备所有销售素材 | 达到可发布标准 + 营销素材、定价和支持材料 |
层级关系: 可销售需要达到可发布标准,而可发布需要达到可投产标准。
输入来源
| 来源 | 文件路径 | 用途 |
|---|---|---|
| 产品包 | .pawbytes/prodig-suites/products/{product-slug}/bundle/ | 打包的产品文件 |
| 输出标准 | .pawbytes/prodig-suites/memory/paw-ps-sidecar/curated/output-standards.md | 质量标准 |
| 产品上下文 | .pawbytes/prodig-suites/products/{product-slug}/product-context.md | 产品类型和要求 |
| 产品简介 | .pawbytes/prodig-suites/products/{product-slug}/product-brief.md | 范围和承诺 |
| 产品决策 | .pawbytes/prodig-suites/products/{product-slug}/product-decisions.md | 先前的决策 |
最低要求: 产品包必须存在。如果工作区中没有标准,可从 references 加载。
输出结构
.pawbytes/prodig-suites/products/{product-slug}/
├── readiness-report.html # Structured assessment (HTML)
├── readiness-report.md # Plain text version
├── gap-analysis.md # Detailed gap breakdown
├── fix-list.md # Actionable fixes (if not ready)
└── product-decisions.md # Appended verdict
每日日志条目位于:
.pawbytes/prodig-suites/memory/paw-ps-sidecar/daily/YYYY-MM-DD.md
参考资料查找协议
- 阅读
./references/readiness-criteria.csv— 按产品类型编排标准的轻量索引 - 将产品类型与相关标准行匹配
- 在阶段 2 评估期间应用匹配的标准
- 仅在需要时从
./references/frameworks/查阅完整标准
输出约定
每次执行都会提供:
- 操作类型: 就绪度评估
- 判定: 可投入生产 / 可发布 / 可销售 / 尚未就绪
- 保存的文件:
readiness-report.html— 结构化评估readiness-report.md— 纯文本版本gap-analysis.md— 差距分析fix-list.md—(尚未就绪时)可执行的修复项
- 建议: 根据判定给出后续步骤
- 文件保存至:
.pawbytes/prodig-suites/products/{product-slug}/
无头模式
使用 --headless 或 -H 调用时:
- 尝试从
.pawbytes/prodig-suites/active-product.md读取当前产品 - 如果未找到,则扫描最近修改的产品工作区
- 除非通过参数另行指定,否则将目标就绪级别设为
publish-ready - 无需提示,执行所有阶段
- 在报告中记录任何假设
- 退出状态码:
- 0:已就绪(判定符合目标)
- 1:尚未就绪(存在差距)
- 2:错误(缺少输入)
质量关卡
| 阶段 | 关卡条件 |
|---|---|
| 加载套件 | 已找到产品套件,并识别产品类型 |
| 评估质量 | 已对所有质量维度评分 |
| 检查差距 | 已记录所有差距及其严重程度 |
| 生成判定 | 已给出判定及其理由 |
不可妥协事项
此工作流必须采用明确的质量标准,而非敷衍批准:
- 不走过场 — 每项判定都必须有证据支撑
- 差距透明 — 记录所有阻碍问题,不得隐瞒
- 诚实评估 — 延迟发布也好过推出有缺陷的产品
- 明确告知用户 — 修复清单必须具体且可执行
- 标准至关重要 — 应用既定标准,不得降低要求
升级处理路径
| 信号 | 路由至 | 原因 |
|---|---|---|
| 发现质量问题 | paw-ps-agent-product-builder | 与专家协调修复 |
| 标准不明确 | paw-ps-strategist | 澄清质量要求 |
| 需要检查多个产品 | paw-ps-agent-product-builder | 协调批量处理 |