Repository navigation
Product Dev 0.3.0
Product Dev 0.3.0
在 0.2.6 之上合并三个 PR:先修闸门的可绕过漏洞,再加闸门新机制,最后改流程规则与入口文档。工程套件 engineering-kit 从 0.5.0 升到 0.6.1。PR #6、#7 在合并时曾标记为 0.2.7、0.2.8,这两个版本没有单独发布,内容都包含在本版里。
一、修复了什么(闸门漏洞,#6)
对闸门做独立审查后复现并修复了十处“不该通过的能通过”:
- 分支改
reviewIgnore、modules.gate.base、reviewFlow、reviewers、reviewMinChars、reviewKeyword就能放宽对自己的判定:这些判定策略字段改为只取基准提交上的配置,配置、豁免表和scripts/engineering/**永远在闸门范围内。 - 合入新主干后旧的测试、复审记录仍有效:记录写入基准提交号并一并核对。
git push origin 别的分支绕过 pre-push 钩子:钩子读取实际推送的引用。- “结论:未通过”能登记为 pass:报告须有明确结论并与登记一致,结论按整句匹配。
- 子模块指针不进树哈希;
git mv进非白名单目录绕过新文件位置检查;测试产物导致误报“运行期间代码变化”的提示。
二、新增了什么
闸门机制(#7,套件 0.6.0)
- 按影响范围测试:可选配置
modules.gate.testGroups,gate.mjs --affected只跑命中的分组;条件不满足时自动改跑全量并写明原因。 - 结果复用:代码树、基线、测试配置都与已有通过记录一致时不重跑,
--force强制重跑。 - 复审轮次拦截:一轮=登记一次不通过;满
maxReviewRounds(默认 3)后再登记须带--user-decision。新增review.mjs accept(报告不通过、用户知情并决定不改)。 - 断言检查:改动的测试文件找不到断言痕迹时静态检查不过;用例数减少时给提示。
- 改名一律按“旧路径删除加新路径新增”处理,堵住改名进 docs/ 被当成只改文档的绕过。
流程规则与入口文档(#8,插件 0.3.0、套件 0.6.1)
- 测试设计:功能契约模板新增“预期行为与异常边界”场景表;交付流程新增“测试设计”一步(依据契约、不看实现、独立上下文)。
- 测试四阶段:开发中快测;首次候选全量加一次变异检查;修复后
gate.mjs --affected;最终提交 CI 全量。 - 复审收敛:任务书拆为“首轮”和“修后复核”;新增“一轮与修复循环”规则;轮次在 pr 流程按提交计,pre-push 流程按被审内容计。
- 模型分档(R9):测试设计不低于实施者;首轮代码复审、安全专项和高风险修后复核不弱于作者;一致性审和范围明确的修后复核可用中档。
- 分流新增“小新增”一档;其他文档修订见 #8。
三、升级后的行为变化与注意事项
- 合入或变基到新主干后需重跑闸门(pre-push 流程还要重新复审);0.5.x 留下的旧记录第一次推送前要重跑闸门;含改名的分支代码树哈希变化,也要重跑一次。
- 会由过变不过:改动的测试文件里没有任何断言痕迹。
- 复审报告的结论只认“通过 / 不通过 / 未通过”。复审判定策略字段只认基准提交上的配置,在功能分支里改了要合入主干后才生效。
- 合并入口须在已 fetch 到 PR 最终提交的检出里运行。
- 已安装项目的契约模板和配置归项目所有,同步不会更新:场景表一节只对新装项目生效;要使用
testGroups、maxReviewRounds等需自行配置。 - 用户全局规则里若写着“复审模型不弱于被复审内容的作者”,与新 R9 不一致,项目内以 R9 为准。
- 已安装套件的项目:升级插件后运行套件同步,把项目内的套件副本从 0.5.x 同步到 0.6.1。
已知未完成
- 行为用例 G1–G6 尚未运行:技能正文改动后的真实 agent 行为没有验证。
- 两张流程导图
docs/images/delivery.png、feature.png待重画,目前与新增步骤和分档不一致。 - 断言检查是正则匹配,有误判漏判;按影响范围测试看不出分组之间的间接依赖;新机制尚未在真实项目上使用。
- 市场清单已同步到 0.3.0(skills#21);Claude Code 与 Codex 已在隔离配置下验证全新安装和 0.2.6 升级,DeepSeek Harness 因本机没有
dsh未验证。验收证据见发布记录。 - 三个 PR 的遗留低级问题清单见各自“独立复审登记”评论,已记入后续。
安装
安装和使用见 README 与 其他 Agent 安装指南。便携包使用本页的 product-dev-skill.zip,三个包的校验和在 SHA256SUMS.txt。资产由 v0.3.0 标签触发的 release-artifacts 工作流(Linux)产出。
发行代码提交:f8e2018c596aceb9cd9782dfdc081f9731e2a682(v0.3.0,套件标签 engineering-kit-v0.6.1)。改动、跨平台 CI 和独立复审的证据见 #6、#7、#8。