Skip to content

Commit 7f12f9f

Browse files
committed
release: v1.9.13 - tighten reply closure and doc flow
1 parent 9c2f8d7 commit 7f12f9f

18 files changed

Lines changed: 404 additions & 33 deletions

‎CHANGELOG.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.9.13](./changelogs/v1.9.13.md) | 2026-05-25 | 🔧 **目标文档前置 + 最终回复闭环提醒补强**:为 `dev` / `docs` 主链补入契约驱动型“目标文档前置”与执行后“轻量复审收敛”正式阶段表达,澄清 `dev-docs` 与 `api-verification` 的轻量文档 / 归档验证边界;同时在 `hooks/_runtime/lifecycle.cjs` 为 dev 模式最终回复补入合规状态块与 FC5 产物路径的 `Stop` 兜底提醒,并通过 `test-hooks-runtime.js` 覆盖 artifact section 边界误判样本 | [查看](./changelogs/v1.9.13.md) |
1213
| [v1.9.12](./changelogs/v1.9.12.md) | 2026-05-25 | 🔧 **MCP 发布链补强 + 控制面一致性闭环**:补齐 `mcp/` 发布资产与 MCP smoke test,统一 `bugs/` / `requirements/` 任务链口径,收紧跨任务 CP gate 边界,新增确认后前置轻量复审(C19),统一 `data/*` 运行时台账语义、`sessions.md` 模板和任务级报告优先路径;`instruction-fallback-check.js` 对齐 `.archived` 跳过与排序策略,并新增 `V7b` fallback smoke test | [查看](./changelogs/v1.9.12.md) |
1314
| [v1.9.11](./changelogs/v1.9.11.md) | 2026-05-22 | 🔧 **Auto v1.1 runtime 收口 + 控制面校验补强**:在 auto 白名单门禁落地后,继续收紧 bootstrap 到当前 agent + 今日/昨日 tasks,补齐缺少 `agent` 的 fallback 推断与回归测试;对齐 `profile init` 与 `validate-profile.js` 模板/真相源校验;`validate.js` V10 改为结构化探针并新增 V15 audit-state 状态机校验,同时同步父级 `.github/.claude` runtime 副本 | [查看](./changelogs/v1.9.11.md) |
1415
| [v1.9.10](./changelogs/v1.9.10.md) | 2026-05-21 | 🔧 **模板/工作流漂移修复 + V13 语义门禁**:修复 precheck 模板 PC0~PC7 与 chat 预检查口径、Token 当前全开放说明、报告模板强制头部和 fix 专属章节、chat daily memory、CP3 `N/A` 豁免运行时识别、API/场景测试归档路径;`validate.js` 扩展 V8 prompts 覆盖并新增 V13 模板语义探针;同步仓内与父级 `.github/.claude` 部署体 | [查看](./changelogs/v1.9.10.md) |
@@ -83,8 +84,9 @@
8384

8485
## 相关文档
8586

86-
- [`changelogs/v1.9.12.md`](./changelogs/v1.9.12.md) — 最新版本详细变更文档
87-
- [`changelogs/v1.9.11.md`](./changelogs/v1.9.11.md) — 上一个版本详细变更文档
87+
- [`changelogs/v1.9.13.md`](./changelogs/v1.9.13.md) — 最新版本详细变更文档
88+
- [`changelogs/v1.9.12.md`](./changelogs/v1.9.12.md) — 上一个版本详细变更文档
89+
- [`changelogs/v1.9.11.md`](./changelogs/v1.9.11.md) — 历史版本详细变更文档
8890
- [`changelogs/v1.9.10.md`](./changelogs/v1.9.10.md) — 历史版本详细变更文档
8991
- [`changelogs/v1.9.9.md`](./changelogs/v1.9.9.md) — 历史版本详细变更文档
9092
- [`changelogs/v1.9.8.md`](./changelogs/v1.9.8.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,10 +73,10 @@ npx devcodex init
7373

7474
```
7575
帮我重构 user 模块的权限校验逻辑
76-
→ 自动识别为 dev 工作流 → CP1 需求确认 → CP2 方案确认 → CP3 实施计划 → 执行
76+
→ 自动识别为 dev 工作流 → CP1 需求确认 → CP2 方案确认 → CP3 实施计划 → 执行 → 轻量复审收敛 → 完成
7777
7878
这个接口返回 500 了
79-
→ 自动识别为 fix 工作流 → 根因分析 → 修复方案 → 三步扫描验证
79+
→ 自动识别为 fix 工作流 → 根因分析 → 修复方案 → 执行 → 三步扫描 → 轻量复审收敛 → 完成
8080
8181
深度审查一下这个项目的代码质量
8282
→ 自动识别为 audit 工作流 → 多轮收敛审查 → 输出报告
@@ -95,6 +95,15 @@ npx devcodex init
9595
- CP1:确认需求目标、用户交互、业务流程、验收结果与范围边界
9696
- CP2:确认实现流程、节点职责、公共契约、兼容性策略、边界问题与测试策略
9797
- CP3:确认实施顺序、里程碑、验证方式、风险与回滚
98+
- 执行后正式阶段:轻量复审收敛(确认实现、关键产物与完成结论一致)
99+
100+
当需求属于契约驱动型场景(例如对外 API、前端联调接口、页面/组件契约)时,可在 CP2 前先冻结目标文档,再让技术方案与实施围绕该文档落地。
101+
102+
文档能力边界如下:
103+
104+
- 轻量 API 文档:给调用方看的阅读型接口说明
105+
- 前端接口文档:给前端联调使用的接口说明,额外包含页面/模块/前置条件与字段映射
106+
- `api-verification`:给开发与回归使用的归档级接口验证双产物(`.http + .cjs`)
98107

99108
## 默认执行原则
100109

‎RULES.md‎

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

3-
> GitHub Copilot Agent Plugin · publisher: Rocky · version: 1.9.12
3+
> GitHub Copilot Agent Plugin · publisher: Rocky · version: 1.9.13
44
55
## 默认 Copilot 支持
66

‎changelogs/v1.9.13.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# v1.9.13 — 目标文档前置 + 最终回复闭环提醒补强
2+
3+
> **发布日期**: 2026-05-25
4+
> **类型**: PATCH
5+
> **关联报告**: `.devcodex/requirements/轻量接口文档与前端文档支持/reports/claude-code/20260525/04--实施与验证.md`, `.devcodex/requirements/实施后复审阶段显式化/reports/claude-code/20260525/04--实施与验证.md`, `.devcodex/bugs/用户可见合规输出缺失/reports/claude-code/20260525/03--实施与验证.md`, `.devcodex/bugs/用户可见合规输出缺失/reports/claude-code/20260525/04--边界补强验证.md`
6+
7+
---
8+
9+
## Fixed
10+
11+
- `instructions/10-dev.instructions.md` 把 `dev.default` 主链显式收敛为“执行 → 轻量复审收敛 → 完成”,并新增契约驱动型需求的“目标文档前置”规则。
12+
- `instructions/11-fix.instructions.md` 与 `instructions/17-compliance.instructions.md` 同步把 `fix` 的轻量复审收敛提升为执行后的正式阶段表达,`SC15` / `T7` 改为感知“执行 → 复审收敛 → 完成”完整链路。
13+
- `skills/dev-default/SKILL.md` 把 `N6` 从“方案一致性验证”统一为“轻量复审收敛”,并明确其内部包含关键产物对照、阻断问题复审与完成判定。
14+
- `skills/dev-docs/SKILL.md` 新增契约驱动型目标文档分流,明确 `light-api` / `frontend-api` 两种阅读型文档模式,以及它们与 `api-verification` 的职责边界。
15+
- `skills/api-verification/SKILL.md` 与 `prompts/api-verification.prompt.md` 收紧为“归档级可执行验证双产物”,不再承担读者向的轻量接口文档职责。
16+
- `README.md` 的使用示例和执行原则同步更新为“执行 → 轻量复审收敛 → 完成”,并补入目标文档前置与轻量文档 / 前端文档 / 归档验证的边界说明。
17+
- `hooks/_runtime/lifecycle.cjs` 为 dev 模式最终回复新增两类 `Stop` 兜底提醒:
18+
- 缺少 `🛡️ DEV 模式 | 合规检查` 状态块
19+
- 缺少 FC5 双行产物路径输出
20+
- `hooks/_runtime/lifecycle.cjs` 的 `artifactPaths` 检测进一步收紧为:只有出现在 `📂 本次会话产物` 区块下的链接 + 绝对路径双行,才视为正式产物路径输出。
21+
- `scripts/test-hooks-runtime.js` 新增最终回复闭环回归样本,覆盖:
22+
- 缺少合规块与产物路径时应提醒
23+
- 只有“参考文件”区块时仍应提示 FC5 缺失
24+
- 完整的 artifact section 输出时不应再提醒
25+
26+
## Validation
27+
28+
- `node scripts/test-hooks-runtime.js`
29+
- `node scripts/validate.js`
30+
- `node .\devcodex-v1\index.js update`
31+
- `node .\devcodex-v1\index.js update --claude`
32+
33+
## Impact
34+
35+
- 契约驱动型需求现在可以在 CP2 前先冻结目标文档,减少 API / 前端联调场景中的方案与实现漂移。
36+
- `dev-docs` 与 `api-verification` 的边界从“接口文档语义混用”收敛为“阅读型文档 vs 归档级验证”双轨模型。
37+
- runtime 对最终回复的合规闭环判断更接近真实用户面结构,不再把普通参考链接误判为 FC5 合规产物输出。
38+
39+
## Breaking Changes
40+
41+
无。

‎hooks/_runtime/lifecycle.cjs‎

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -371,7 +371,7 @@ function buildDefaultState(mode) {
371371
activeProject: '',
372372
bootstrap: { profileRead: false, summaryRead: false, tasksRead: false },
373373
bootstrapComplete: m !== 'dev',
374-
visible: { payloadObserved: false, precheck: false, compliance: false },
374+
visible: { payloadObserved: false, precheck: false, compliance: false, artifactPaths: false },
375375
mutated: false, reportTouched: false, memoryTouched: false,
376376
lastEvent: '', lastReason: ''
377377
}
@@ -814,13 +814,30 @@ function hasVisibleReplyPayload(payload) {
814814
return candidates.some(v => typeof v === 'string' && v.trim())
815815
}
816816

817+
function hasArtifactPathOutput(text) {
818+
const lines = String(text || '').split(/\r?\n/)
819+
let inArtifactSection = false
820+
for (let index = 0; index < lines.length - 1; index++) {
821+
const line = lines[index]
822+
if (/^\s*📂\s*本次会话产物[::]?\s*$/.test(line)) {
823+
inArtifactSection = true
824+
continue
825+
}
826+
if (!inArtifactSection) continue
827+
if (!/^\s*-\s*\[[^\]]+\]\([^\)]+\)\s*$/.test(line)) continue
828+
if (/^\s*[A-Za-z]:\\.+/.test(lines[index + 1])) return true
829+
}
830+
return false
831+
}
832+
817833
function updateVisibleReplyState(state, payload, eventName) {
818834
if (eventName !== 'PreCompact' && eventName !== 'Stop') return
819835
if (!hasVisibleReplyPayload(payload)) return
820836
state.visible.payloadObserved = true
821837
const text = collectStrings(payload).join('\n')
822838
if (/预检查(DEV 模式)|PC0 上下文/.test(text)) state.visible.precheck = true
823839
if (/🛡️ DEV 模式 \| 合规检查|FC:\s*FC1/.test(text)) state.visible.compliance = true
840+
if (hasArtifactPathOutput(text)) state.visible.artifactPaths = true
824841
}
825842

826843
function captureFinalPayloadSample(payload, eventName, state) {
@@ -844,6 +861,12 @@ function buildClosureReminder(state, eventName) {
844861
if (eventName === 'Stop' && state.mode === 'dev' && state.visible && !state.visible.precheck) {
845862
items.push('precheck block 未输出(S07/C18:dev 模式首条用户可见回复必须含 PC0~PC7 预检查块)')
846863
}
864+
if (eventName === 'Stop' && state.mode === 'dev' && state.reportTouched && state.visible && !state.visible.compliance) {
865+
items.push('合规检查状态块未输出(17-compliance:dev 模式非 chat 回复末尾必须含 🛡️ DEV 模式 | 合规检查 状态块)')
866+
}
867+
if (eventName === 'Stop' && state.mode === 'dev' && state.reportTouched && state.visible && !state.visible.artifactPaths) {
868+
items.push('产物路径未输出(FC5/T9:回复末尾必须按双行格式输出产物路径)')
869+
}
847870
if (state.mutated && !state.memoryTouched) items.push('记忆文件尚未写入(S05:会话结束前必须写入)')
848871
if (state.mutated && !state.reportTouched) items.push('报告文件尚未写入(chat 工作流豁免)')
849872
if (!items.length) return ''

‎instructions/10-dev.instructions.md‎

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ applyTo: "**"
3737
## CP 门控(C02 约束,严格按序)
3838

3939
```text
40-
CP1(需求确认)→ PR-1 内部自检 → CP2(方案确认)→ plan-review(PR-2~PR-7)→ [impact-review] → CP3(实施计划)→ 执行 → 方案一致性验证
40+
CP1(需求确认)→ PR-1 内部自检 → CP2(方案确认)→ plan-review(PR-2~PR-7)→ [impact-review] → CP3(实施计划)→ 执行 → 轻量复审收敛 → 完成
4141
```
4242

4343
### CP 定义
@@ -66,6 +66,30 @@ CP1(需求确认)→ PR-1 内部自检 → CP2(方案确认)→ plan-rev
6666
8. **CP3 豁免记录**:docs/init/plan-review 子类型被规则明确豁免 CP3 时,须在需求级记忆或报告中记录 `CP3: N/A(<子类型> 子类型豁免)`,供 hook/fallback 区分合法豁免与漏确认。
6767
9. **确认后前置轻量复审**(C19):每次用户明确确认 CP1 / CP2 / CP3 后、进入下一阶段前,必须先对当前已确认产物做 1 轮轻量前置复审;发现阻断性问题则先修正当前产物、告知用户并重新确认,无阻断问题方可推进。
6868

69+
### 目标文档前置(条件触发)
70+
71+
当需求属于“契约驱动型需求”时,CP1 确认后、CP2 技术方案前,必须先冻结目标文档,再让后续方案与实施围绕该文档落地。
72+
73+
**契约驱动型需求触发条件**(满足任一即可):
74+
75+
1. 最终交付成功与否主要由对外 API / 页面交互 / 组件契约决定
76+
2. 文档本身就是前端、外部调用方或协作方的实现锚点
77+
3. 若不先冻结文档,后续实现容易产生明显契约漂移
78+
79+
**目标文档类型**:
80+
81+
| 类型 | 适用场景 | 推荐产物 |
82+
|------|---------|---------|
83+
| 轻量 API 文档 | 普通接口说明、调用方文档 | `light-api` 模式文档 |
84+
| 前端接口文档 | 前端联调、页面/模块接口说明 | `frontend-api` 模式文档 |
85+
86+
**执行规则**:
87+
88+
1. 仅对契约驱动型需求启用,不得推广到所有 dev 任务
89+
2. 目标文档属于 CP2 输入的一部分,不替代 `02-技术方案.md`
90+
3. CP2 技术方案必须显式说明如何以目标文档为最终契约锚点
91+
4. CP3 与执行阶段的任务拆分、验证方式、回滚路径必须能追溯到目标文档
92+
6993
### 跨服务需求处理(CP1 前确认)
7094

7195
当需求涉及多个服务时,须在 CP1 输出前完成以下判断:
@@ -248,8 +272,9 @@ CP1(需求确认)→ PR-1 内部自检 → CP2(方案确认)→ plan-rev
248272
## 子类型专属规则
249273

250274
### default(新功能开发)
251-
- 六阶段执行:N1 需求确认 → N2 技术方案(含 PR-1 自检)→ N3 方案验证 → N4 实施计划 → N5 执行 → N6 方案一致性验证
275+
- 六阶段执行:N1 需求确认 → N2 技术方案(含 PR-1 自检)→ N3 方案验证 → N4 实施计划 → N5 执行 → N6 轻量复审收敛
252276
- `N4` 只负责把已确认方案转成任务拆分、顺序、依赖、验证与回滚;`05-实施进度.md` 仅在满足条件时启用,不作为默认文书
277+
- `N6` 是执行后的正式阶段,内部至少包含:方案一致性验证、关键产物对照、阻断性问题复审与完成判定
253278
- 无特殊豁免,完整走 CP1→CP2→CP3
254279

255280
### refactor(重构)
@@ -288,6 +313,7 @@ CP1(需求确认)→ PR-1 内部自检 → CP2(方案确认)→ plan-rev
288313
### docs(文档开发)
289314
- 豁免 plan-review / impact-review / CP3
290315
- CP2 简化为**文档大纲确认**
316+
- 当文档任务属于契约驱动型需求时,可先冻结目标文档,再做简化版 CP2 文档大纲确认
291317
- 文档质量标准:结构完整 / 示例可执行 / 版本同步 / 链接有效
292318

293319
### plan-review(方案评审)

‎instructions/11-fix.instructions.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ applyTo: "**"
3030
## CP 流程(C02 约束)
3131

3232
```text
33-
CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 → [CP3]
33+
CP1(问题确认)→ CP2(方案确认)→ [impact-review] → [CP3] → 执行 → 三步扫描 → 轻量复审收敛 → 完成
3434
```
3535

3636
- **CP1**:AI 输出问题分析(根因 + 影响范围),用户确认
@@ -72,7 +72,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
7272
- 涉及 HTTP 接口变更 → 生成双产物(.http + .cjs)
7373
- 涉及源码/配置文件变更 → 检查文档同步(CHANGELOG/README 为必查;TASK-INDEX/STATUS 按项目存在或启用时同步)
7474

75-
## 轻量复审收敛(执行后强制)
75+
## 轻量复审收敛(执行后正式阶段)
7676

7777
> 适用于 `fix` 工作流的关键产物稳定性确认。该规则是 **执行后轻量复审层**,不是 audit 的 3 轮零发现重流程。
7878

‎instructions/17-compliance.instructions.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ applyTo: "**"
157157
| SC12 | C14 多任务进度快照验证 | 任务≥2时 🔴 |
158158
| SC13 | C15 架构质量自检 | dev/fix 🔴 |
159159
| SC14 | analyze/audit 工作流中,所有标注 ✅已验证 的运行时结论(测试通过率/性能数字/命令输出)均已在**本轮实际执行**对应命令;SUMMARY.md 或记忆文件中的历史执行数据不得直接用作 ✅已验证,必须降级为 ⚠️待验证 | analyze/audit 🔴 |
160-
| SC15 | dev/fix 关键产物已完成轻量复审收敛:最后一次阻断性修正后,至少再复审 1 轮且无新增阻断性问题;未满足前不得宣告完成 | dev/fix 🔴 |
160+
| SC15 | dev/fix 关键产物已完成轻量复审收敛:该阶段属于执行后的正式完成阶段;最后一次阻断性修正后,至少再复审 1 轮且无新增阻断性问题;未满足前不得宣告完成 | dev/fix 🔴 |
161161

162162
## RC 恢复性检查(非阻塞)
163163

@@ -200,7 +200,7 @@ applyTo: "**"
200200
| T4 | ✅ CP 完整(dev/fix;其他 N/A) |
201201
| T5 | ✅ 合规通过 |
202202
| T6 | ✅ 约束遵守(C01~C15) |
203-
| T7 | ✅ 工作流验证(dev/fix: 适用门禁已执行,其中 fix 的三步扫描与轻量复审收敛已完成;audit/analyze: PCV 已执行)|
203+
| T7 | ✅ 工作流验证(dev/fix: 适用门禁已执行,且“执行 → 复审收敛 → 完成”正式阶段已走完;其中 fix 的三步扫描与轻量复审收敛已完成;audit/analyze: PCV 已执行)|
204204
| T8 | ✅ SUMMARY 已更新 |
205205
| T9 | ✅ 产物路径已输出 |
206206

‎package-lock.json‎

Lines changed: 3 additions & 3 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@vextjs/devcodex",
3-
"version": "1.9.12",
3+
"version": "1.9.13",
44
"description": "DevCodex — AI-powered development workflow rules as a GitHub Copilot Agent Plugin",
55
"main": "index.js",
66
"bin": {

0 commit comments

Comments
 (0)