mcpField
P
paw-ps-publish-ready-check

paw-ps-publish-ready-check

github.com/pawbytes测试与质量115143 次安装4 周前更新
代码仓库

关于 paw-ps-publish-ready-check

paw-ps-publish-ready-check 是用于评估产品能否进入生产、发布或销售阶段的质量检查工作流,面向产品创建者。它按产品类型匹配标准,记录缺口、分级问题并生成带依据的结论。

主要功能

  1. 01按产品类型匹配评估标准
  2. 02评估功能、完整度、清晰度和易用性
  3. 03将缺口分为关键、重要和次要
  4. 04生成就绪结论及可执行修复清单
  5. 05输出 HTML 与 Markdown 报告

适用场景

  1. 01发布前检查产品是否达到目标标准
  2. 02找出阻碍产品上线或销售的问题
  3. 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.md
02-assess-quality.md
03-check-gaps.md
04-generate-verdict.md
readiness-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

作出最终判定:可投产、可发布、可销售或尚未就绪。根据目标就绪级别应用相应门槛。

推进条件: 完成判定并记录后结束。


激活时

  1. 确定产品工作区根目录:{project-root}/.pawbytes/prodig-suites/
  2. 如果 .pawbytes/prodig-suites/active-product.md 存在,则识别当前活跃产品
  3. 如果没有活跃产品且未处于无头模式,请提示用户指定:
    • 产品标识(要评估哪个产品)
    • 目标就绪级别(投产 / 发布 / 销售)
  4. 从阶段 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

参考资料查找协议

  1. 阅读 ./references/readiness-criteria.csv — 按产品类型编排标准的轻量索引
  2. 将产品类型与相关标准行匹配
  3. 在阶段 2 评估期间应用匹配的标准
  4. 仅在需要时从 ./references/frameworks/ 查阅完整标准

输出约定

每次执行都会提供:

  • 操作类型: 就绪度评估
  • 判定: 可投入生产 / 可发布 / 可销售 / 尚未就绪
  • 保存的文件:
    • readiness-report.html — 结构化评估
    • readiness-report.md — 纯文本版本
    • gap-analysis.md — 差距分析
    • fix-list.md —(尚未就绪时)可执行的修复项
  • 建议: 根据判定给出后续步骤
  • 文件保存至: .pawbytes/prodig-suites/products/{product-slug}/

无头模式

使用 --headless 或 -H 调用时:

  1. 尝试从 .pawbytes/prodig-suites/active-product.md 读取当前产品
  2. 如果未找到,则扫描最近修改的产品工作区
  3. 除非通过参数另行指定,否则将目标就绪级别设为 publish-ready
  4. 无需提示,执行所有阶段
  5. 在报告中记录任何假设
  6. 退出状态码:
    • 0:已就绪(判定符合目标)
    • 1:尚未就绪(存在差距)
    • 2:错误(缺少输入)

质量关卡

阶段关卡条件
加载套件已找到产品套件,并识别产品类型
评估质量已对所有质量维度评分
检查差距已记录所有差距及其严重程度
生成判定已给出判定及其理由

不可妥协事项

此工作流必须采用明确的质量标准,而非敷衍批准:

  1. 不走过场 — 每项判定都必须有证据支撑
  2. 差距透明 — 记录所有阻碍问题,不得隐瞒
  3. 诚实评估 — 延迟发布也好过推出有缺陷的产品
  4. 明确告知用户 — 修复清单必须具体且可执行
  5. 标准至关重要 — 应用既定标准,不得降低要求

升级处理路径

信号路由至原因
发现质量问题paw-ps-agent-product-builder与专家协调修复
标准不明确paw-ps-strategist澄清质量要求
需要检查多个产品paw-ps-agent-product-builder协调批量处理

评论

支持 Markdown