Skip to content

Commit f640a9a

Browse files
committed
release: v1.11.9
1 parent 23d57af commit f640a9a

58 files changed

Lines changed: 396 additions & 60 deletions

Some content is hidden

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

‎.gitignore‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@ node_modules/
33
.github/
44
# DevCodex Claude Code adapter output (devcodex init --claude target; do not commit in source repo)
55
.claude/
6+
# DevCodex Codex adapter output (devcodex init --codex target; do not commit in source repo)
7+
.agents/
8+
.codex/
9+
AGENTS.md
10+
CLAUDE.md
611
.vscode/
712
dist/
813
*.log

‎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.11.9](./changelogs/releases/v1.11.9.md) | 2026-06-02 | 🔧 **通用规范吸纳与提示词激励收口**:吸纳自然语言 Auto、Node.js >=18、远端 CI、依赖/兼容拆层、内部共享库评估、包工程层、TS 契约迁移、provider/connector 字段合同、service 防过度防御、README 能力矩阵与 JS/Node 标准 JSDoc,并补齐最小实现/复杂度预算守门 | [查看](./changelogs/releases/v1.11.9.md) |
1213
| [v1.11.8](./changelogs/releases/v1.11.8.md) | 2026-06-02 | 🔧 **technical-design 技术方案模板字段补强**:补齐目标架构、模块边界、接口契约矩阵、数据/状态模型、执行流程锚点与需求验收映射,并同步 `dev-plan-review` 与 `V13` 探针,避免 CP2 技术方案退化为文件清单或散落测试备注 | [查看](./changelogs/releases/v1.11.8.md) |
1314
| [v1.11.7](./changelogs/releases/v1.11.7.md) | 2026-06-01 | 🔧 **官方文档证据前置 + Profile 联动判定补强**:新增 `C20/C21`、`OfficialDocsEvidence` 与 `ProfileImpactCheck` 执行链,同步 dev/fix、plan-review、document-sync、Prompt、README/website 与 `V54` 探针,并补齐 CLI runtime helper 包边界 | [查看](./changelogs/releases/v1.11.7.md) |
1415
| [v1.11.6](./changelogs/releases/v1.11.6.md) | 2026-06-01 | 🔧 **治理台账长尾收口 + 发布/宿主/时间线守门补强**:收口 backlog governance、audit-release、ArtifactLinkSet、Codex PreCompact、S02 受控例外、changelog releases 与 Profile Freshness,并补齐 `V49` active-root 台账关闭时间线探针 | [查看](./changelogs/releases/v1.11.6.md) |
@@ -94,8 +95,9 @@
9495

9596
## 相关文档
9697

97-
- [`changelogs/releases/v1.11.8.md`](./changelogs/releases/v1.11.8.md) — 最新版本详细变更文档
98-
- [`changelogs/releases/v1.11.7.md`](./changelogs/releases/v1.11.7.md) — 上一版本详细变更文档
98+
- [`changelogs/releases/v1.11.9.md`](./changelogs/releases/v1.11.9.md) — 最新版本详细变更文档
99+
- [`changelogs/releases/v1.11.8.md`](./changelogs/releases/v1.11.8.md) — 上一版本详细变更文档
100+
- [`changelogs/releases/v1.11.7.md`](./changelogs/releases/v1.11.7.md) — 历史版本详细变更文档
99101
- [`changelogs/releases/v1.11.6.md`](./changelogs/releases/v1.11.6.md) — 上一个版本详细变更文档
100102
- [`changelogs/releases/v1.11.5.md`](./changelogs/releases/v1.11.5.md) — 历史版本详细变更文档
101103
- [`changelogs/releases/v1.11.4.md`](./changelogs/releases/v1.11.4.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
3333
## 功能特性
3434

3535
- **8 种工作流**: `dev` / `fix` / `audit` / `analyze` / `self-fix` / `resume` / `plan` / `chat`
36-
- **2 种模式**: 确认模式(@DevCodex)/ 全自动模式(@DevCodex Auto,Auto v1.1 仅对显式 `@devcodex-auto` + 白名单路径提供硬保证)
36+
- **2 种模式**: 确认模式(@DevCodex)/ 全自动模式(@DevCodex Auto,Auto v1.1 对显式 `@devcodex-auto` 或明确自然语言 auto 授权 + 白名单路径提供硬保证)
3737
- **合规管线**: FC(形式合规)→ SC(实质合规)→ RC(恢复性检查)→ T(任务完成验证)
3838
- **持久记忆**: 每 Agent、每日的会话记录,结构化字段
3939
- **自动报告**: 每次会话自动写入报告,从不询问 — 直接执行
@@ -48,6 +48,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4848
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
4949
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5050
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
51+
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
5152
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
5253
- **Profile 本地私有配置**: `config.local.json` 支持长期连接、env 引用和 `extensions.<namespace>` 受控扩展位;文件应加入 `.gitignore`,且不能覆盖 `mode` / `agent`;核心秘密只允许 `*Env` / `secretRef`
5354
- **变更日志分层**: 未发布实现变更写 `changelogs/unreleased.md`,已发布详情统一归档到 `changelogs/releases/vX.Y.Z.md`,目录说明见 `changelogs/README.md`
@@ -439,7 +440,7 @@ DevCodex 的 `plugin.json` 声明 `tier: "free"`,所有 Skill 均标注 `tier:
439440
- **可选**:通过 `.github/agents/` 使用 `@devcodex` / `@devcodex-auto` 自定义 Agent 入口
440441
- **Codex**:通过 `AGENTS.md` 自动注入总则,通过 `.agents/skills/` 按需读取技能;不单独维护 `codex/AGENTS.md`
441442

442-
Auto v1.1 当前只在支持 Hook 的宿主里,对显式 `@devcodex-auto` 入口下的白名单路径提供 runtime 级硬保证;JetBrains 等 `instruction-fallback` 宿主仅同步规则语义,不承诺完全等价的自动放行。Auto 任务若命中控制面、多批次或预计修改 ≥10 文件,仍须先形成 ExecutionContract 并持续更新实施进度。
443+
Auto v1.1 当前只在支持 Hook 的宿主里,对显式 `@devcodex-auto` 或明确自然语言 auto 授权(如“进入 auto 模式执行”)下的白名单路径提供 runtime 级硬保证;模糊提及、询问 auto 规则或普通“继续”不算授权。JetBrains 等 `instruction-fallback` 宿主仅同步规则语义,不承诺完全等价的自动放行。Auto 任务若命中控制面、多批次或预计修改 ≥10 文件,仍须先形成 ExecutionContract 并持续更新实施进度。
443444

444445
## 许可证
445446

‎RULES.md‎

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

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

‎agents/devcodex-auto.agent.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: DevCodex Auto
3-
description: AI 开发规范助手(全自动模式 v1.1)— 仅在显式 @devcodex-auto + 白名单路径下自动推进,安全底线仍强制执行。所有规则由 instructions/ 自动注入。
3+
description: AI 开发规范助手(全自动模式 v1.1)— 显式 @devcodex-auto 或明确自然语言 auto 授权 + 白名单路径下自动推进,安全底线仍强制执行。所有规则由 instructions/ 自动注入。
44
tools:
55
- edit
66
- execute
@@ -14,7 +14,7 @@ disable-model-invocation: true
1414

1515
`DevCodex Auto` 不是“所有任务都自动推进”,而是 **Auto v1.1 最小闭环**:
1616

17-
- **唯一正式入口**:显式 `@devcodex-auto`
17+
- **正式入口**:显式 `@devcodex-auto` 或明确自然语言 auto 授权;模糊提及、询问 auto 规则或普通“继续”不算授权
1818
- **hook-enforced 宿主**:仅对白名单路径自动推进;非白名单路径默认回确认模式
1919
- **instruction-fallback 宿主**:如 JetBrains / Cursor,只同步规则语义,不承诺 runtime 级硬放行;支持 Hook 的宿主按白名单执行 runtime 放行
2020
- **白名单范围**:DevCodex 治理文件、`.devcodex/` 产物、README 与 auto 专属回归脚本

‎changelogs/releases/v1.11.9.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# v1.11.9 — 通用规范吸纳与提示词激励收口
2+
3+
> 发布日期:2026-06-02
4+
5+
## Highlights
6+
7+
- 吸纳通用 `process-improvements`:自然语言 Auto 授权、Node.js `>=18` 默认基线、远端 CI 发布门禁、依赖/兼容拆层、内部共享库根因评估、包工程层、TS 契约迁移、provider / connector 字段合同、service 防过度防御、README 性能/能力矩阵写法,以及 JS/Node 必要注释标准 JSDoc。
8+
- 补齐 `technical-design` / `implementation-plan` / `dev-plan-review` / dev/fix 工作流的最小实现与必要注释守门,降低大模型把简单任务写成过度防御、企业级复杂实现的概率。
9+
- 同步 README、website、release-verification、test-router、审计维度与治理探针,并回填相关 PI/PF 台账状态;VextJS 官方层、adapter benchmark、schema 注释对齐等专项建议保持 deferred,不纳入本批通用规范。
10+
11+
## Changed
12+
13+
- `hooks/_runtime/lifecycle-project-target.cjs` 支持明确自然语言 auto 授权,并以 `scripts/test-hooks-runtime.js` 覆盖回放。
14+
- `prompts/technical-design.prompt.md` 与 `prompts/implementation-plan.prompt.md` 增加复杂度预算、抽象准入、防御分支边界、JSDoc 必要注释、依赖拆层、provider / connector 字段合同与包工程层检查。
15+
- `instructions/10-dev.instructions.md`、`instructions/11-fix.instructions.md`、`skills/dev-default`、`skills/fix-default`、`skills/dev-plan-review` 等补齐最小实现、service 职责边界、TS 契约迁移和 JS/Node JSDoc 规则。
16+
- `skills/release-verification`、`skills/test-router`、`audit-release` 与 release guide 增加 R3c 远端 CI 绿色门禁。
17+
- `readme-authoring`、`audit-readme` 与 `project-readme.prompt.md` 增加性能表、语法/能力矩阵和模式优先级的用户视角写法。
18+
- `.gitignore` 增加源仓内 Codex / AGENTS / CLAUDE 部署输出忽略项,避免本地安装面误入提交。
19+
20+
## Release Gate Evidence
21+
22+
- `OfficialDocsEvidence`: N/A。本轮未新增或升级第三方依赖、框架、SDK、平台 API 或外部模块;变更限定为仓内规范源、模板、Skill、Hook runtime、文档与治理校验探针。
23+
- `ProfileImpactCheck`: 命中发布版本与规范分发面变化;已同步 package/plugin/instructions/RULES 版本字段,并通过父工作区 `devcodex update` 同步部署副本。
24+
- `R3c remote CI`: N/A。源仓当前未提交 `.github/workflows` 远端 CI 定义,本轮以本地全链测试、包边界校验和部署副本同步作为发布前证据。
25+
26+
## Validation
27+
28+
- `node scripts/validate.js`
29+
- `node scripts/test-spec-governance.js`
30+
- `node scripts/test-hooks-runtime.js`
31+
- `npm test`
32+
- `node devcodex-v1/index.js update`(父工作区部署副本同步,V8 已收敛)
33+
34+
## Included Changes
35+
36+
- 2026-06-02 `通用规范吸纳`:吸纳通用 process-improvements,并回填 `PI-023 / PF-022` 与跨项目 PI 状态。
37+
- 2026-06-02 `提示词激励`:补齐最小实现、复杂度预算、防过度抽象、防过度防御和必要注释守门。

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,4 +14,4 @@
1414

1515
## 2026-06-02
1616

17-
- 暂无。
17+
- 暂无未发布变更。

‎hooks/_runtime/lifecycle-project-target.cjs‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -223,9 +223,20 @@ function buildLifecycleProjectTargetUtils({
223223
return false
224224
}
225225

226+
function hasAutoAuthorizationPrompt(prompt) {
227+
if (/@devcodex-auto\b/i.test(prompt)) return true
228+
const normalized = String(prompt || '').replace(/\s+/g, ' ').trim()
229+
const naturalLanguageAutoPatterns = [
230+
/(?:进入|启用|开启|使用|切换到)\s*(?:auto|自动|全自动)\s*(?:模式|执行|推进|处理)?/i,
231+
/(?:auto|自动|全自动)\s*(?:模式)?\s*(?:开始|继续|执行|推进|处理|修复|实施)/i,
232+
/(?:run|continue|proceed)\s+(?:in\s+)?auto\s+mode/i
233+
]
234+
return naturalLanguageAutoPatterns.some(pattern => pattern.test(normalized))
235+
}
236+
226237
function detectExecutionMode(payload) {
227238
const prompt = extractUserPrompt(payload)
228-
return /@devcodex-auto\b/i.test(prompt) ? EXECUTION_MODE.AUTO : EXECUTION_MODE.CONFIRM
239+
return hasAutoAuthorizationPrompt(prompt) ? EXECUTION_MODE.AUTO : EXECUTION_MODE.CONFIRM
229240
}
230241

231242
function buildMultiProjectBlockMessage() {
@@ -262,6 +273,7 @@ function buildLifecycleProjectTargetUtils({
262273
applyPromptTarget,
263274
buildMultiProjectWarningKey,
264275
shouldSuppressMultiProjectWarning,
276+
hasAutoAuthorizationPrompt,
265277
detectExecutionMode,
266278
buildMultiProjectBlockMessage
267279
}

‎instructions.md‎

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -218,6 +218,8 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
218218
- 若官方文档不可用,按顺序降级到官方源码 / 官方仓库说明、项目内已确认文档、社区资料;降级原因和风险必须写入方案与报告。
219219
- 本地纯实现问题、仓库内现有能力可闭环验证且不新增/升级外部依赖的任务,可标 `OfficialDocsEvidence: N/A`,但必须写明 N/A 理由。
220220
- `dev-plan-review` 的 PR-2 必须检查该证据;触发场景缺失 `OfficialDocsEvidence` 时视为阻断,回 CP2 修订。
221+
- 依赖升级、框架升级、SDK 替换或平台 API 兼容性分析必须拆分 `业务源码平滑性` 与 `依赖层落地条件`;用户关心“只升级依赖即可”时,追加 `纯依赖层零附加动作` 结论,不得把工程前提误报成业务源码阻断。
222+
- 根因位于内部共享库、中间件、SDK 或 adapter 抽象层时,CP2 前必须评估“修共享库 + 消费项目升级”是否优于单项目临时补丁。
221223

222224
### ProfileImpactCheck(Profile 联动判定)
223225

@@ -300,6 +302,18 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
300302
301303
**高风险操作**:DDL 变更 / `.env`/`package.json`/CI 配置变更 / 文件删除 / 直接影响生产环境
302304

305+
### 代码实现复杂度与通用工程守门
306+
307+
- CP2 技术方案必须给出最小实现与注释策略;实施默认采用满足验收项的最小实现,优先局部补丁和既有本地模式。
308+
- 禁止为“企业级”“可扩展”预设新增无真实消费者的 service / factory / adapter / manager、策略注册表、通用配置或预留扩展点。
309+
- 必要注释必须覆盖非显然业务规则、状态转换、不变量、兼容约束、安全边界、外部契约映射和反直觉权衡;JavaScript / Node.js 中命中必要注释的导出函数、核心业务函数、类、复杂对象契约、参数/返回/异常说明必须使用标准 JSDoc。
310+
- Node.js 项目的 `engines.node`、CI matrix、Profile 与 README 运行时说明默认不得低于 `>=18`;支持更低版本时必须在 CP2 写明业务理由、风险和独立验证证据。
311+
- 包 / 库 / adapter / CLI 方案除代码实现层外,还必须检查 public API、public types、internal 工具、shared tests、benchmark、docs、scripts、dist/coverage 边界、package metadata 与未发布变更日志。
312+
- TypeScript 重构或迁移按公开契约与消费面逐步完善类型,不机械复制旧版本缺陷;跨模块业务契约、公开类型与配置类型优先集中到 types 契约层。
313+
- 三方 provider、connector、SDK 接入类 CP2 必须先区分业务功能接口与底层 provider adapter;面向前端或业务调用方时优先冻结业务功能契约,provider/model/operation 作为内部实现或配置维度。随后冻结字段级合同:provider metadata、内部 payload、上游 request 映射、标准化 result、错误 detail;首个 provider 只能验证统一 operation contract,不能反向定义公共命名和层次。
314+
- 简单业务 service 默认只做业务编排、外部能力调用和必要上游错误映射;不得重复 route validate、model/schema、数据导入或框架已承担的校验、归一化、配置兜底和二次治理。
315+
- README / 使用文档涉及性能表、语法/能力矩阵或模式优先级时,先给用户选择结论,再解释字段;同时写清支持形式、不支持形式和优先级示例。
316+
303317
### CP 响应处理
304318

305319
| 用户响应 | 处理 |
@@ -367,6 +381,13 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
367381
2. **数据联动扫描** — 上下游数据流是否受影响
368382
3. **零残留复核** — 确认无残留引用
369383

384+
### 修复执行补充守门
385+
386+
- 依赖升级、兼容修复或批量适配类问题先记录问题清单与归因,再统一确认修复范围;用户明确授权即时修复或 auto 执行时可边发现边处理,但仍要回写问题清单和证据。
387+
- 根因位于内部共享库、中间件、SDK 或 adapter 抽象层时,优先评估“修共享库 + 消费项目升级”;若只做单项目补丁,修复方案必须说明共享库不改的理由。
388+
- JavaScript / Node.js 修复中命中必要注释的导出函数、核心业务函数、类、复杂对象契约、参数/返回/异常说明必须使用标准 JSDoc。
389+
- 简单业务 service 修复不得重复 route validate、model/schema、数据导入或框架已承担的校验、归一化和配置兜底。
390+
370391
---
371392

372393
## 分析工作流(analyze)
@@ -566,7 +587,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
566587

567588
## 全自动模式豁免
568589

569-
当用户选择全自动执行时:CP1/CP2/CP3 确认自动通过;S01/S02 核心秘密禁止项/S03~S07/C01/C10/C18 不可豁免。S02 受控私有例外只能按上文模型执行,不属于绕过安全底线。
590+
当用户选择 `@devcodex-auto` 或明确自然语言 auto 授权(如“进入 auto 模式执行”)时:CP1/CP2/CP3 确认自动通过;模糊提及、询问 auto 规则或普通“继续”不等价于 auto 授权;S01/S02 核心秘密禁止项/S03~S07/C01/C10/C18 不可豁免。S02 受控私有例外只能按上文模型执行,不属于绕过安全底线。
570591

571592
---
572593

‎instructions/00-safety.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 安全底线与输出语言规则,定义 S01~S07、违规处理与不可豁免边界
44
priority: P2
5-
version: 1.11.8
5+
version: 1.11.9
66
---
77
# 安全底线规范(S01~S07)
88

0 commit comments

Comments
 (0)