Skip to content

Commit 0584a2b

Browse files
committed
release: v1.11.24
1 parent 4a3a621 commit 0584a2b

53 files changed

Lines changed: 1538 additions & 294 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# 变更日志 (CHANGELOG)
22

33
> **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/releases/vX.Y.Z.md` 链接;历史版本见对应详细变更文件
4-
> **最后更新**: 2026-06-23
4+
> **最后更新**: 2026-06-26
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.24](./changelogs/releases/v1.11.24.md) | 2026-06-26 | 🔧 **需求输入模板链路与产品完整需求模板收口**:拆分纯新需求、需求变更、Bug 与产品完整需求入口,新增需求方 / 变更 / Bug / 产品模板,固化“产品需求即验收事实源”、Mermaid+文字步骤图、前端交互覆盖和技术验证派生链路 | [查看](./changelogs/releases/v1.11.24.md) |
1213
| [v1.11.23](./changelogs/releases/v1.11.23.md) | 2026-06-23 | 🔧 **复审文档体验 / 公开用户文档 / 最终汇报吸纳门禁**:归档 V66/V67 探针,固化复审维度增量、用户视角文档、文档消费者扫描、产物链接去重、前端运行时网络探针、公开用户文档维护边界和最终回复 active 范围守门,并修复官网锁文件 DOMPurify 审计项 | [查看](./changelogs/releases/v1.11.23.md) |
1314
| [v1.11.22](./changelogs/releases/v1.11.22.md) | 2026-06-17 | 🔧 **高保真 UI / 提交授权 / 兼容契约吸纳门禁**:新增 V65 探针,固化 Figma/截图还原、真实 preview、状态回归、生产资产预算、运行时 i18n、显式 commit 授权、兼容契约权威和公开文档版本边界等守门 | [查看](./changelogs/releases/v1.11.22.md) |
1415
| [v1.11.21](./changelogs/releases/v1.11.21.md) | 2026-06-17 | 🔧 **审查发现 intake 分流门禁**:新增 `ReviewFindingIntakeGate` / `DesignIntentAndDocsConsistencyGate` 与 V64 探针,要求外部审查报告、AI review finding、audit issue 和代码评审发现先经本地证据、设计取舍、用户决策、文档漂移与测试缺口分流 | [查看](./changelogs/releases/v1.11.21.md) |
@@ -109,8 +110,9 @@
109110

110111
## 相关文档
111112

112-
- [`changelogs/releases/v1.11.23.md`](./changelogs/releases/v1.11.23.md) — 最新版本详细变更文档
113-
- [`changelogs/releases/v1.11.22.md`](./changelogs/releases/v1.11.22.md) — 上一版本详细变更文档
113+
- [`changelogs/releases/v1.11.24.md`](./changelogs/releases/v1.11.24.md) — 最新版本详细变更文档
114+
- [`changelogs/releases/v1.11.23.md`](./changelogs/releases/v1.11.23.md) — 上一版本详细变更文档
115+
- [`changelogs/releases/v1.11.22.md`](./changelogs/releases/v1.11.22.md) — 历史版本详细变更文档
114116
- [`changelogs/releases/v1.11.21.md`](./changelogs/releases/v1.11.21.md) — 历史版本详细变更文档
115117
- [`changelogs/releases/v1.11.18.md`](./changelogs/releases/v1.11.18.md) — 历史版本详细变更文档
116118
- [`changelogs/releases/v1.11.17.md`](./changelogs/releases/v1.11.17.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ npx @vextjs/devcodex init --codex # 仅 Codex adapter
102102
├── instructions/ ← Instructions 约束(15 个,含全部工作流规则)
103103
├── agents/ ← Copilot 自定义 Agent(v1.9.8 起恢复默认分发)
104104
├── skills/ ← Skill 详细检查标准(44 个,按需读取,含 README 专项能力、spec-governance 与 5 个支撑型 Skill)
105-
├── prompts/ ← Prompt 模板(26 个)
105+
├── prompts/ ← Prompt 模板(30 个)
106106
├── hooks/ ← 宿主生命周期 Hook 配置与运行时
107107
│ ├── devcodex.lifecycle.json
108108
│ └── _runtime/
@@ -152,11 +152,12 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
152152

153153
当前仓库的正式需求信源是 `website/docs/versions/v1/<active-version>/requirements/`,版本内的 `index/design/plan/progress/decisions` 都以这里为准。
154154

155-
`prompts/*.prompt.md` 不是当前项目的正式需求入口,而是 CP1 / CP2 / CP3 的默认执行模板:它们负责约束 AI 如何生成需求概述、技术方案、实施计划与实施进度。若项目已经定义自定义 requirement 规范,则项目规范优先,prompt 只提供通用骨架。
155+
`prompts/*.prompt.md` 不是当前项目的正式需求入口,而是 CP1 / CP2 / CP3 的默认执行模板:它们负责约束 AI 如何先区分无产品角色的纯新需求、有产品角色直接提供的完整产品需求、需求变更和 Bug 问题,再生成需求概况、产品需求、需求变更概况、问题概况、需求确认、技术方案、实施计划、实施进度与关键决策。若项目已经定义自定义 requirement 规范,则项目规范优先,prompt 只提供通用骨架。
156156

157157
默认职责边界如下:
158158

159-
- CP1:确认需求目标、用户交互、业务流程、验收结果与范围边界
159+
- CP1:先判定入口类型;无产品角色 / 研发兼产品时,纯新需求把用户/运营/老板/客户/内部使用方的原始诉求独立保留为 `00-需求概况.md`,再由 AI 生成 `01-需求确认.md` 草稿并由产品补充归一化;有产品角色直接提供完整需求时,使用 `01-产品需求.md` / `product-requirement.prompt.md`,该模板正文只给产品填写完整 PRD,AI / 研发缺口 / 冲突检查记录在 CP1 摘要、`02-技术方案.md` 或报告中,不生成或重写产品需求;需求变更使用 `00-需求变更概况.md` / `01-需求变更确认.md` 并回写目标需求真相源;Bug 问题使用 `bugs/<问题>/00-问题概况.md` / `01-问题确认.md` 并进入 fix 工作流
160+
- 需求方模板可读性:`00-需求概况.md` 面向非产品 / 非研发需求方,必须使用口语化问题收集“希望系统做到什么、现在怎么凑合处理、必须遵守的业务口径、希望出现 / 不能接受的例子和材料”;允许填写“没有 / 不知道 / 暂无 / 需要产品帮忙整理”,不得用抽象字段名替代解释
160161
- CP2:确认实现流程、节点职责、公共契约、兼容性策略、边界问题与测试策略
161162
- CP3:确认实施顺序、里程碑、验证方式、风险与回滚
162163
- 执行后正式阶段:ECR 执行闭环复审(确认实现、关键产物、报告、记忆、SUMMARY、diff/commit、测试与完成结论一致)
@@ -179,8 +180,8 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
179180
- **意图扩展摘要**:当扩展后路由变化、命中控制面/宿主差异、风险较高或跨会话恢复时,会在用户面输出 3~5 行摘要,便于确认“为什么这样路由”。
180181
- **Context Rehydration Contract**:压缩恢复、resume 或用户要求按文件真相重建时,会按“当前用户消息 → 已确认产物 → sessions → tasks → SUMMARY → 摘要 → AI 推断”的优先级恢复上下文,摘要不能覆盖文件真相源。
181182
- **ContextHandoffCard**:跨会话、跨 Agent、多批次、summary/compact 前或用户要求传递上下文时,会把 source-of-truth、confirmed decisions、open risks、next action、must-not-overwrite、validation state 与 ArtifactLinkSet 写入报告或 daily tasks;恢复时仍按 Context Rehydration Contract 重新核对文件真相源。
182-
- **SimpleTaskFastPath**:非常明确、预计 ≤2 文件、无公共契约/配置/发布/控制面/台账来源/高风险、无需多轮跟踪的简单 dev/fix 任务,可免建 `01-需求概述.md` / `04-实施计划.md`,改用内联 CP 摘要 + 报告/记忆 `N/A + skipReason`;范围扩大时立即升级回完整产物链。若已有需求/bug 真相源,命中 `ExistingRequirementArtifactOverride`,调整内容必须先回写文件,回复只做摘要。
183-
- **ArtifactDecisionMatrix**:CP1/CP2/CP3/ECR 会按任务规模列出关键产物的 `create` / `update` / `skip` / `N/A` 状态,覆盖需求、技术方案、实施计划、实施进度、目标文档、报告和记忆;判定优先级为已有真相源回写 > 任务触发条件 > SimpleTaskFastPath > 子类型豁免,避免模板“必填”口径压过轻路径或条件触发。
183+
- **SimpleTaskFastPath**:非常明确、预计 ≤2 文件、无公共契约/配置/发布/控制面/台账来源/高风险、无需多轮跟踪的简单 dev/fix 任务,可免建 `00-需求概况.md` / `00-需求变更概况.md` / `00-问题概况.md` / `01-需求确认.md` / `01-产品需求.md` / `01-需求变更确认.md` / `01-问题确认.md` / `04-实施计划.md`,改用内联 CP 摘要 + 报告/记忆 `N/A + skipReason`;范围扩大时立即升级回完整产物链。若已有需求/bug 真相源,命中 `ExistingRequirementArtifactOverride`,调整内容必须先回写文件,回复只做摘要。
184+
- **ArtifactDecisionMatrix**:CP1/CP2/CP3/ECR 会按任务规模列出关键产物的 `create` / `update` / `skip` / `N/A` 状态,覆盖入口类型、需求概况、产品完整需求、需求变更概况、问题概况、需求确认、需求变更确认、问题确认、技术方案、实施计划、实施进度、关键决策、目标文档、报告和记忆;判定优先级为已有真相源回写 > 任务触发条件 > SimpleTaskFastPath > 子类型豁免,避免模板“必填”口径压过轻路径或条件触发。
184185
- **Hook closure 三态**:Stop/PreCompact 可见回复验证区分 `verified-present`、`verified-missing`、`unverified`;无法解析最终 assistant 内容时只提示无法验证,并给出 payload capture 指引,不再断言“未输出”。
185186
- **长流程执行契约**:Auto、控制面、多批次、预计修改 ≥10 文件或发布前置任务会触发 ExecutionContract;测试路线不明显时触发 TestRoute;正式发版前触发 ReleaseAudit 与 ReleaseVerification;控制面消费链联动时建立 Concept Sync Map;宿主契约变化时触发 `host-contract-verification`。
186187
- **执行期 CP3 回退**:若执行过程中实际修改范围扩展到 CP3 门槛(≥5 文件、高风险、控制面联动),必须暂停执行并先补做 CP3,再继续改动。
@@ -304,7 +305,7 @@ devcodex/
304305
├── agents/ # Agent 源文件;Copilot 端默认分发,Claude Code 端不分发
305306
├── instructions/ # 全局 Instructions(15 个,含工作流规则摘要,自动注入)
306307
├── skills/ # Skill 详细检查标准(44 个,按 01-common §按需读取表 路由读取)
307-
├── prompts/ # Prompt 模板(26 个)
308+
├── prompts/ # Prompt 模板(30 个)
308309
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时及 helper 模块
309310
├── codex/ # Codex adapter 源模板(分发到 `.codex/hooks.json`,不是工作区部署副本 `.codex/`)
310311
├── data/ # 运行时数据模板(分发到目标项目的空骨架)

‎RULES.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# DevCodex v1.11.23 — 使用入口
1+
# DevCodex v1.11.24 — 使用入口
22

3-
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.23
3+
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.24
44
55
## 正式主支持客户端
66

‎changelogs/releases/v1.11.24.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# v1.11.24 — 需求输入模板链路与产品完整需求模板收口
2+
3+
> 发布日期:2026-06-26
4+
> 变更类型:规范治理 / 需求模板 / 发布边界
5+
> 风险级别:P1
6+
> 向后兼容:✅ 兼容
7+
8+
## 变更摘要
9+
10+
本版本把“需求方原始输入、产品确认、产品完整 PRD、需求变更、Bug 修复”拆成不同模板入口,避免需求方模板、产品模板与 AI 生成的确认文档混写。产品需求继续作为业务事实源本身,不要求产品另写验收标准、测试用例、数据库字段或接口 Schema;技术验收与验证由技术方案、实施计划和测试方案从已确认事实源派生。
11+
12+
## Added
13+
14+
- 新增 `requirement-overview.prompt.md`,对应纯新需求的 `00-需求概况.md`,面向用户、运营、老板等需求方填写。
15+
- 新增 `requirement-change-overview.prompt.md`,对应 `00-需求变更概况.md`,用于既有需求的变更入口。
16+
- 新增 `bug-overview.prompt.md`,对应 `bugs/<问题>/00-问题概况.md`,用于 Bug / 故障 / 异常入口。
17+
- 新增 `product-requirement.prompt.md`,对应 `01-产品需求.md`,用于公司已有产品角色时由产品直接提供完整 PRD,AI 直接据此进入技术方案。
18+
- 新增产品模板正文纯度探针,阻止把 AI / 研发缺口检查章节放入产品填写模板正文。
19+
20+
## Changed
21+
22+
- 将 `requirement.prompt.md` 收敛为 `01-需求确认.md`:由 AI / 产品根据需求方概况归一化形成,最终需需求方与产品双方确认。
23+
- 将需求方模板字段改为口语化问题,明确允许填写“没有 / 不知道 / 暂无 / 需要产品帮忙整理”。
24+
- 将纯新需求、需求变更、Bug 修复、产品完整 PRD 的入口链路分别写入 README、文档站、CP 清单、output paths、dev/fix/audit/test-router skills。
25+
- 明确产品需求不写验收标准;产品需求本身就是验收事实源,技术实现验收写在 `02-技术方案.md`、`04-实施计划.md` 与测试方案中。
26+
- 强化 Mermaid + 文字步骤图 + 节点解释要求,并把前端页面交互、状态反馈、异常路径、返回/撤销/取消等写入需求链路。
27+
- 同步 runtime CP1 识别、instruction fallback、requirement artifact 检查、validate probes 与 `test-spec-governance`。
28+
- 同步工作区 `.github/`、`.claude/`、`AGENTS.md`、`.agents/` 与 `.codex/` 部署副本。
29+
30+
## Fixed
31+
32+
- 修复产品完整需求模板中混入“AI / 研发缺口检查”章节的问题;缺口、冲突和待补信息改为记录在 CP1 摘要、`02-技术方案.md` 或报告中。
33+
- 修复需求方模板把 Bug 修复、纯新需求和需求变更混在同一概况模板的问题。
34+
- 修复用户不易理解“期望结果 / 当前处理方式 / 已知规则与限制 / 示例 / 反例与附件”等字段的问题。
35+
36+
## 验证
37+
38+
```bash
39+
node scripts/test-spec-governance.js
40+
node scripts/test-requirement-artifacts.js
41+
node scripts/test-instruction-fallback-check.js
42+
git diff --check
43+
node scripts/validate.js
44+
npm test
45+
npm run test:audit
46+
npm pack --pack-destination E:\Worker\.devcodex\devcodex-v1\.tmp\release-v1.11.24
47+
npm publish --dry-run --registry=https://npm.pkg.github.com
48+
```
49+
50+
发布前需完成上述验证,并在正式发布后执行 tag / registry 验收。
51+
52+
## 相关资源
53+
54+
- `prompts/requirement-overview.prompt.md`
55+
- `prompts/requirement-change-overview.prompt.md`
56+
- `prompts/bug-overview.prompt.md`
57+
- `prompts/product-requirement.prompt.md`
58+
- `website/docs/guide/requirements.md`

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
## 当前未发布变更
1010

11-
- 暂无。
11+
_暂无未发布变更。_
1212

1313
## 记录提示
1414

‎hooks/_runtime/lifecycle.cjs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ const TRANSCRIPT_TAIL_LIMIT = 2 * 1024 * 1024
3434
const STICKY_PROJECT_TTL_MS = 30 * 60 * 1000
3535

3636
// ─── CP Gate constants ────────────────────────────────────────────────────────
37-
const CP1_FILE = '01-需求概述.md'
37+
const CP1_FILES = ['01-需求确认.md', '01-产品需求.md', '01-需求概述.md']
3838
const CP2_FILE = '02-技术方案.md'
3939
const CP3_FILE = '04-实施计划.md'
4040
const CP3_RUNTIME_FILE_THRESHOLD = 5
@@ -464,7 +464,7 @@ function directoryContainsFileMatching(dir, matcher, depth = 4) {
464464
function hasTaskArtifact(task, phase) {
465465
const fullPath = task.fullPath
466466
if (phase === 'CP1') {
467-
if (fs.existsSync(path.join(fullPath, CP1_FILE))) return true
467+
if (CP1_FILES.some(name => fs.existsSync(path.join(fullPath, name)))) return true
468468
if (task.kind === 'bugs') {
469469
return directoryContainsFileMatching(
470470
path.join(fullPath, 'reports'),

0 commit comments

Comments
 (0)