Repository navigation
Releases
Product Dev 0.3.2
Product Dev 插件 0.3.2,随附工程套件 engineering-kit 0.7.1。上一版是 v0.3.1(套件 0.7.0)。
变化
- 外部复审登记收紧(#27):名字以
external:开头的复审者,只接受外部复审脚本external-review.mjs的登记。用review.mjs手动登记(pass、fail、accept,pr和pre-push两种流程)一律拒绝,堵住了手写报告冒充外部复审的路。 - 说法统一(#27):
review.mjs的提示文字改为三类复审者:宿主子代理、外部执行器、宿主没有子代理时用户另开的全新会话。- 入口里的“数据结构”统一为“数据库结构”。
- 补注运行记录里过期的状态。
- 发布记录(#26):补了 0.3.1 的发布记录。
- 版本号(#28)。
完整改动、跨平台 CI 和独立复审登记见各 PR。
已知限制
- 外部复审的运行目录只核对目录里几份文件彼此对得上,手写整套运行目录仍能通过登记;改闸门脚本本身也能绕过。要彻底堵住,需要签名或无法伪造的凭据,目前没有做,文档已写明。
- Codex 外部复审“不给工具”这一点,在工具齐全的 Linux、macOS 上没有实测过。
- DeepSeek Harness 的安装路径没有在本机验证。
资产
资产取自标签工作流的产物,可按 SHA256SUMS.txt 校验。
Product Dev 0.3.1
Product Dev 插件 0.3.1,带工程套件 engineering-kit 0.7.0。上一版是 v0.3.0,带套件 0.6.1。
主要变化
- 外部复审接口(#18、#22):复审可以交给宿主之外、其他厂商的模型来做,内置的执行器是 Codex CLI,接入方法是在项目配置里加
external:codex。外部复审在仓库之外的只读副本里运行,结论行由代码生成,报告绑定输入哈希。 - 复审与流程规则统一(#17、#19、#25):
- 复审者分三类:宿主子代理、外部执行器,以及宿主没有子代理时用户另开的全新会话(R9)。
- 复审模型按任务分档选,不一定用最强档。
- 新增必需检查
modules.gate.requiredChecks。 - 复审报告的格式检查从按字数改为按章节:缺了必需的章节就拒绝登记(
modules.review.reviewSections;reviewMinChars默认改为 0)。 - 方案对比“改动很小可以不派”的例外,再排除跨模块和新接口。
- 没有子代理、没有界面的项目,补上了流程的替代路径。
- 检查与闸门修复(#11、#16、#21、#22):
- 一致性检查不再越过工作树。
- 测试先行检查修了误放行。
- 推送钩子的切词和识别加固。
- 巡检提速。
- 修正了外部复审识别工具调用被拒绝的规则。
- 上游组件(#15):impeccable 的审计文档原来引用了固定版本引擎里没有的
audit-storage命令,已去掉;构建时会核对技能文本里引用的命令,是否都在固定版本的引擎里。 - 文档与评测(#9、#10、#12、#13、#14、#20、#23、#24):
- README 和 INSTALL 增加给 Agent 的安装方法。
- 两份 process.md 去重。
- 重画导图,补上可编辑的源文件。
- 行为用例运行记录与场景修正。
完整改动、跨平台 CI 和独立复审登记见各 PR。
已知限制
- Codex 外部复审的“不给工具”只在 Windows、Codex 0.167.0-alpha 上实测过。在工具齐全的 Linux 和 macOS 上,使用前先验证。
- DeepSeek Harness 的安装路径没有在本机验证,只核对了 npm 包的哈希与包内版本。
资产
资产取自标签工作流的产物,按 SHA256SUMS.txt 校验。
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。
Product Dev 0.2.6
Product Dev 0.2.6
修复 2026-11-10 行为验证发现的六个组件问题,工程套件 engineering-kit 升到 0.5.0。
工程套件(engineering-kit 0.5.0)
- 巡检查阶段内登记:阶段目录里的文件没有登记到该阶段的 README 时,巡检报错。登记只认三种写法:表格第一列的文件名、反引号里的名字、链接目标;子目录里的文件登记相对路径或所在目录名。记录目录不查。
- 闸门输出更清楚:通过时先列测试先行检查和注释检查各查了几个文件,再列测试结果。
- 复审登记能对应到提交:推送前复审的登记写明分支、提交号和文档内容哈希,只改文档的改动也能分清每一轮。推送核对的规则不变。
- 默认复审者名单加入
product-dev:code-reviewer。 - 功能契约模板新增“数据与时间口径”,提示写明时区。
- 死链检查现在也查带标题的链接和尖括号链接。
- 规则 R6 写明“会话的临时目录除外”。
设计流程
设计总控写明了主对话什么时候可以兼任设计角色、角色子代理用什么档位的模型:只有修订一个角色的一份已有产物时才可以兼任,其中要用到专业方法或专门工具的先向用户确认。
升级已安装的项目时
- 巡检可能新报两类错误:阶段目录里没登记的文件,以及带标题或尖括号的死链。巡检不在推送闸门里,不拦推送。
- 项目配置和文档模板归项目所有,升级不覆盖:要用
product-dev:code-reviewer登记复审,需要手动把它加进modules.review.reviewers(同步时会提示);新的契约模板只在新装项目里出现。
安装
安装和使用见 README 与 其他 Agent 安装指南。便携包使用本页的 product-dev-skill.zip,三个包的校验和在 SHA256SUMS.txt。
发行代码提交:3b174389cb3f140015b8f5c7e358f97eb0dadd30(v0.2.6)。改动、跨平台 CI 和独立复审的证据见 #3 与 #4。
本次发布还没有做各宿主的真实安装与升级验证,市场清单也尚未指向 0.2.6;完成后追加到本页。
Product Dev 0.2.5
Product Dev 0.2.5
Product Dev 迁移至 独立仓库。源码、内部组件、文档、构建、测试与发布在这里维护;ac0033/skills 继续提供统一导航和 Claude Code/Codex 市场。
- 保持市场
ac0033-skills、插件product-dev、npm 包dsh-product-dev和原调用入口。 - 修正独立根目录下的构建、许可、源码元数据与资源链接,并保留旧提交 SHA、相关标签与工程套件历史目录兼容。
- 本发行同时提供原生插件、便携技能包、DSH/npm tarball 与 SHA256 校验和。
安装和使用见 README 与 其他 Agent 安装指南。旧仓库的历史 Release、标签和下载链接继续保留。
已有市场安装保持原注册项,刷新市场后更新插件即可。npm/DSH 继续升级同一包名至 dsh-product-dev@0.2.5;便携包使用本页 product-dev-skill.zip。
源码迁移、跨平台 CI 与独立双审证据见 迁移 PR。发布后客户端验证结果会追加到本发行记录。
发布后真实验证
发行代码提交:ffd3343918d8fde67d9a500952b53e9698582ac7(v0.2.5)。后续根 README 的纯文档收尾不改变发行标签和包。
| 路径 | 旧版升级 | 全新安装与加载 |
|---|---|---|
| Claude Code 2.1.322 | 原 ac0033/skills 市场安装 0.2.4,同一注册项更新明确报告 0.2.4 → 0.2.5 | 成功;8 个技能、7 个子代理组件及内部资源可用 |
| Codex CLI 0.167.0-alpha.3.2 | 原市场注册项 upgrade/add 更新为 0.2.5 | 成功;真实 app-server skills/list、plugin/read 加载唯一 product-dev:product-dev 入口及资源 |
| DSH 0.2.2-rc.1 / npm | 独立 profile/安装目录从 0.2.4 升至 0.2.5 | 成功;真实 Cordis/SkillRegistry list/get 及工作流资源通过 |
| 便携包 | 原 0.2.3 下载链接实际下载成功,未改写旧资产 | 新 ZIP 公开重下载、唯一入口、引用和工程脚本 dry-run 通过 |
以上使用隔离配置,没有强制更新活动环境,也没有调用模型生成任务来代替插件加载检查。npm latest 为 0.2.5,公开 tarball integrity 与本发行包一致;本页 3 个包的公开重下载 SHA256 全部匹配 SHA256SUMS.txt。
源码迁移覆盖原 403/403 文件;原 main、相关发布标签与入口前身历史可追溯。完成真实升级验收后,通过 skills#19 清理旧源码;skills#18 保留原市场身份并切换来源。