PRD Assistant v3.1.2 — 检查与修复

PRD Assistant v3.1.2

修复静态扫描遗漏和技能规则之间的冲突。

修复

1. 扫描器识别带序号的可选章节，例如“2.1 验收标准”，避免采用推荐编号后漏检。提示仍是人工审阅项，不自动删除章节。
2. 在读取 PRD 或人工确认文件前拒绝非普通文件，避免 FIFO 等输入导致阻塞。
3. 统一入口、原型指南、示例与审校清单的按需记忆规则，禁止创建文件或仅对话任务不被迫写记忆。
4. 明确用户授权自主拟定提示文案时直接完成，不重复追问；业务规则仍须有依据。
5. 移除按否定句式一律删现状的错误规则，保留有价值的现状、明确沿用行为及范围限制。
6. README 改用稳定发布入口和实际 CI 引用，修正宿主可能不显示版本的说明；维护指南加入精确版本匹配、文件字节核对和草稿附件验收。

验证

• 本地自动化测试：153 项，151 通过、2 项按平台条件跳过。
• 28 项发行资产及清单校验通过；干净解压后逐文件安装一致性校验通过。
• GitHub 发布提交的 Windows／Ubuntu／macOS × Python 3.10／3.13 矩阵须全部成功后发布。
• 新增 2 项行为评测规范，共 33 项；尚未执行独立模型行为评测或真实 GitLab 渲染验证。
• 系统技能通用 quick_validate 因缺少 PyYAML 未运行成功；仓库自带校验无外部依赖且已通过。

PRD Assistant v3.1.1 — 维护版

PRD Assistant v3.1.1

这是一次维护版本，集中修正文档、输入处理和交付约束的一致性。

主要变化

• 统一正式版本清单为 3.1.1，并重新生成发布包与 SHA-256 校验和。
• 将现状截图和附件明确作为改造参考，输出新的 PRD 与原型，不把参考图直接当作交付内容。
• 要求在分析过程中尽早提出会影响范围、业务行为或交付物的待确认问题；只有用户明确要求保留时，才将问题写入 PRD。
• 固化 GitLab 多图使用 HTML 表格、像素宽度和 <br> 图注的排版方式，并更新截图宽度标定说明。
• 明确网站访问必须基于用户授权和当前能力；记忆文件按多轮、附件或交接需要生成，减少一次性需求的无效文件。
• 清理 README 与贡献指南中的历史版本表述，避免把旧版本状态当作当前发布结论。

校验

• 本地技能文件集合、清单哈希和语法校验通过。
• 发布包已从干净文件集合生成，并附带 SHA256SUMS-release.txt。
• GitHub Actions 的矩阵结果以本次发布提交为准。

PRD Assistant v3.1.0 — 需求确认、原型改造与持久记忆

PRD Assistant v3.1.0 — 需求确认、原型改造与持久记忆

本版本改进 PRD 结构、截图使用、问题确认、GitLab 配图和跨上下文交接，保持单 Skill 结构及现有脚本接口。

1. 核心改进

1. 有序结构：PRD 默认使用章节、子节及改动点编号；局部编辑保留既有编号和引用。
2. 现状图驱动改造：聊天图片与附件统一作为现状参考，根据目标需求生成新原型；旧图不冒充改造结果。明确仅需 PRD 时遵守用户范围。
3. 过程中及时确认：相关未知及时提问、回答后同步修正；只有用户明确暂缓的事项才保留在 PRD，默认不生成待确认尾章。
4. GitLab 多图排版：采用 HTML 表格、像素宽度及 <br> 图注；每张图片独立，宽度按源图及实际预览标定，不使用 flex 或合成图兜底。
5. 需求记忆与交接：每个需求维护 记忆.md，保存原始需求、追加变更、当前有效要求、问题决策和下一步；开始或恢复任务先读取。明确只读时不额外写文件。

入口、指南、示例、审校清单和文件清单已同步，新增 9 个行为评测场景，总计 29 个。

2. 验证结果与边界

• 发布提交：e4d990a8abf71bc96330893ef6f1cb572b7eadce。
• GitHub Actions validate 已通过：运行记录。
• 本地运行 150 项测试：148 通过、2 跳过。
• 正式附件包已生成，干净解压后的文件与 SHA256 校验通过，零错误、零警告。
• 独立模型行为评测与真实 GitLab 渲染未执行；静态检查不等于模型效果或排版验收。
• 持久记忆依赖及时保存及恢复时读取，不承诺无限上下文。

3. 安装与升级

下载附件 prd-assistant-3.1.0-release.zip 与 SHA256SUMS-release.txt，核对校验和后导入完整 prd-assistant 目录。更新前备份旧版，不混合新旧文件。

包内“本地迭代／尚未发布”描述保留了发布前构建状态；本 Release 对上述固定提交发布 v3.1.0，附件与该提交源码一致。

PRD Assistant v3.0.0 — 公共版质量升级

PRD Assistant v3.0.0 — 公共版质量升级

v3.0.0 保持单 Skill 与“简单需求短写”的产品定位，统一 PRD 起草、授权修改、只审校及按需 HTML 原型工作流。本版本收紧了脚本、安装和截图执行契约，因此按主版本发布。

核心改进

• 保留必要信息与明确要求优先于篇幅，修复否定句、删除动作和限制条件在精简中被误删的问题。
• 统一起草／授权修改／只审校、A/B/C 复杂度、核心未知与材料冲突处理。
• 补充自创 A/B/C 完整输入输出案例及 20 条行为评测规范；评测规范本身不等于模型结果。
• 原型继续按需生成；截图只使用现成、获授权且可隔离的能力，无能力时如实降级。
• 删除关闭浏览器沙箱、全局结束 Edge、默认 profile、npx 能力探测等危险或环境绑定说明。
• 修复 PRD 扫描器的路径授权、代码段、引用式图片、查询参数、BOM、图片复用和人工确认等边界。
• 增加完整发行清单、SHA256 文件校验、显式安装验收和可复现离线打包。
• CI 改为只读权限，并配置 Windows／Ubuntu／macOS 与 Python 3.10／3.13 矩阵。

兼容性变化

• scan_prd.py 默认以单文件父目录或目录目标本身为授权根；共享相对路径需显式 --root。
• --ack 必须位于授权根内，保留理由，只确认 review，不能豁免错误。
• 孤儿图片只检查显式 --assets-dir；不再默认读取所有兄弟文档。
• 安装／发行树必须包含 package-manifest.json 的完整文件并匹配 SHA256；不接受 symlink／junction 安装树。
• 旧版自定义 CI、脚本调用或软链安装需按 README 迁移。自然语言 PRD 使用方式无需迁移。

验证结果

• 本机 Windows 11、Python 3.13.14：150 项单元测试全部通过，0 跳过。
• 干净解压后安装树校验：0 错误、0 警告。
• 两次离线打包产生完全相同的 ZIP 字节。
• 6 条同上下文文本生成冒烟已人工核对；它不是独立留出或原生宿主效果评测。

已知限制

• GitHub Actions 的 Windows／Ubuntu／macOS × Python 3.10／3.13 共 6 个任务已全部通过；本地仍只实际运行 Windows + Python 3.13.14。
• 浏览器截图和不同宿主的技能导入尚未逐一人工验收；核心 PRD 指令不绑定宿主不等于已验证全部宿主。
• scan_prd.py 是明示 Markdown 子集，不是完整 CommonMark／GFM 解析器；复杂扩展语法及 fragment 仍需人工核查。
• 静态校验与文件 SHA256 不能证明模型输出质量、发布者身份或浏览器安全。

安装与升级

优先下载本 Release 附带的 prd-assistant-3.0.0-release.zip 和 SHA256SUMS-release.txt，核对校验和后按 README 导入。更新前备份旧目录；不要混合新旧文件。v1.0.0 与 v2.0.0 tag 保持原指向。