Skip to content

Commit 3fa2065

Browse files
committed
fix governance active-root wording
1 parent 84553df commit 3fa2065

16 files changed

Lines changed: 184 additions & 34 deletions

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,7 @@ devcodex/
261261

262262
控制面与长流程新增三类支撑型 Skill:`execution-contract` 约束 scope / allowedPaths / requiredArtifacts / validationRoute / rollbackPlan,`test-router` 统一选择验证路线,`release-verification` 在正式 tag / publish 前执行 R0~R7 发布验证链。
263263

264-
> ℹ️ 维护者状态文件(本仓库开发过程中累积的 violations/pending-fixes 记录)保存在 `.devcodex/.maintainer-state/`,**不分发**给用户。
264+
&gt; ℹ️ 维护者状态文件(本仓库开发过程中累积的 violations/pending-fixes 记录)按 active-root 保存,例如 workspace-namespace 下的 `.devcodex/<project>/data/`,**不分发**给用户。
265265

266266
## 客户端支持矩阵(Client Support Matrix)
267267

‎changelogs/unreleased.md‎

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

99
## 2026-05-28
1010

11+
- 修复规范治理台账闭环:统一 `violations` / `pending-fixes` 字段模型,新增修复方案、修复时间、验证状态、验证证据与关闭时间,明确 DevCodex 规范自身问题按 active-root 写入 `.devcodex/devcodex-v1/data/`,并补强 RecordRouter 对用户纠偏、误关闭、误落点和复审逃逸问题的分流规则与 validate 探针。
1112
- 修复 Hook Stop/PreCompact 可见回复验证:支持 content parts、messages、choices 与 transcript variants,并将 closure 判断升级为 `verified-present` / `verified-missing` / `unverified` 三态。
1213
- 修复 Copilot 多项目 workspace 根每轮 warning:已识别唯一项目后短 TTL 内沿用 sticky `activeProject` 与项目 `mode`,workspace-namespace 提示改为真实 `.devcodex/workspace/profile/` 路径,并避免把 payload `role: "user"`、prompt `user-visible`、URL 片段或前缀项目路径等通用/相邻词误判为同名项目。
1314
- 补充 dev/fix 用户可见意图扩展摘要规则,在控制面、宿主差异、路由修正、风险升高或跨会话 resume 时输出 3~5 行摘要。

‎data/README.md‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,15 @@ data/
1818
**变更前(v1.5.x)**:`data/` 直接包含维护者自身的违规/过程记录;`npm pack` 会把 `violations.md` 等**连同真实项目名与历史数据**发给所有用户。
1919

2020
**变更后(v1.6.0)**:
21-
- 维护者状态迁移到仓库根 `.devcodex/.maintainer-state/`(不分发)
21+
- 维护者状态不再放在源码包 `data/` 根目录中,避免随 npm 包分发
2222
- `data/templates/` 仅保留空模板 + schema + 1 条 EXAMPLE
2323
- `package.json "files"` 白名单改为 `data/templates/`,精确控制分发
2424

25+
**当前规则(workspace-namespace)**:
26+
- 维护者实际记录按 active-root 写入,例如单项目 `.devcodex/<project>/data/*.md`
27+
- 全工作区治理记录写入 `.devcodex/workspace/data/*.md`
28+
- 旧 `.devcodex/.maintainer-state/` 只作为历史迁移口径,不作为当前写入目标
29+
2530
## init 行为
2631

2732
`devcodex init` / `devcodex init --claude` 将 `data/templates/*.md` 复制到目标项目的运行时数据目录:
@@ -42,7 +47,8 @@ data/
4247
而在**源仓**里:
4348

4449
- `data/templates/*.md`:仅提供空模板与允许的 EXAMPLE 行
45-
- `.devcodex/.maintainer-state/`:维护者自己的实际记录,不参与 npm 分发
50+
- `.devcodex/<project>/data/*.md`:workspace-namespace 下单项目维护者实际记录,不参与 npm 分发
51+
- `.devcodex/workspace/data/*.md`:workspace-namespace 下全工作区维护者实际记录,不参与 npm 分发
4652

4753
换句话说,规范里写 `data/*.md` 时,表达的是“应该把记录落到运行时台账”,不是说源仓根 `data/` 目录里直接保存真实记录。
4854

‎data/templates/gap-registry.md‎

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

33
> **文件定位**:模板。`devcodex init` / `devcodex init --claude` 复制为目标项目运行时 `data/gap-registry.md`(Copilot: `.github/data/gap-registry.md`;Claude Code: `.claude/data/gap-registry.md`)。
44
> **使用**:审查中遇到无对应维度的问题,或 R2+ 自我审视发现 M1~M4 盲点时登记。
5-
> **维护者记录**:`.devcodex/.maintainer-state/gap-registry.md`。
5+
> **维护者记录**:不在本包内分发;启用 `workspace-namespace` 时写入对应 active-root,例如 `<工作区根>/.devcodex/<project>/data/gap-registry.md`。
66
77
---
88

‎data/templates/pending-fixes.md‎

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> **文件定位**:模板。`devcodex init` / `devcodex init --claude` 复制为目标项目运行时 `data/pending-fixes.md`(Copilot: `.github/data/pending-fixes.md`;Claude Code: `.claude/data/pending-fixes.md`)。
44
> **使用**:PC4 三轴检测出 PF 标记后,AI 追加到此表;修复完成后标注 ✅。
5-
> **维护者自身的 PF**:不在本包内分发;在仓库 `.devcodex/.maintainer-state/pending-fixes.md` 管理。
5+
> **维护者自身的 PF**:不在本包内分发;启用 `workspace-namespace` 时写入对应 active-root,例如 `<工作区根>/.devcodex/<project>/data/pending-fixes.md`。
66
77
---
88

@@ -11,20 +11,28 @@
1111
| 字段 | 说明 |
1212
|------|------|
1313
| 编号 | `PF-NNN` |
14+
| 登记时间 | 精确到分钟,格式 `YYYY-MM-DD HH:mm` |
15+
| 规范化意图 | `record.spec-defect` |
16+
| 置信度 | 高 / 中 / 低 |
1417
| G 码 | `G1~G11`(见 `18-spec-radar`)|
1518
| Axis | `A` / `B` / `C` / `A+B` 等多轴组合 |
16-
| 简述 | 一句话描述规范缺陷 |
17-
| 关联 VL | 若为 G5 重复违规,填对应 VL 编号 |
18-
| 规范化意图 | `record.spec-defect` |
1919
| 触发来源 | PC4 / audit / ECR / 用户建议 / validate |
20-
| 缺陷类型 | 缺失 / 冲突 / 滞后 / 外部假设失效 / 完成边界缺失 |
21-
| SCV 要求 | 是否需要 SCV,填 `是` / `否` |
22-
| 状态 | 🔄 / ✅ |
20+
| 缺陷类型 | 缺失 / 冲突 / 滞后 / 外部假设失效 / 完成边界缺失 / 字段不足 / 路径漂移 / 检测盲区 |
21+
| 简述 | 一句话描述规范缺陷 |
22+
| 修复方案 | 计划怎么修 |
23+
| 修复时间 | 完成修复时间,未完成为 `—` |
24+
| 是否已验证 | 是 / 否 / 部分 |
25+
| 验证时间 | 完成验证时间,未完成为 `—` |
26+
| 验证证据 | validate/test/CRS/SCV/ECR 证据 |
27+
| SCV要求 | 是否需要 SCV,填 `是` / `否` |
28+
| 关联 VL/GAP/PI | 若为 G5 重复违规或由违规/盲区升级,填对应编号 |
29+
| 关闭时间 | 关闭时间,未关闭为 `—` |
30+
| 状态 | 🔄 / ✅ / ⚠️ |
2331

2432
---
2533

2634
## 登记表
2735

28-
| 编号 | G码 | Axis | 简述 | 关联 VL | 规范化意图 | 触发来源 | 缺陷类型 | SCV要求 | 状态 |
29-
|------|:---:|:----:|------|:-------:|--------------|----------|----------|:------:|:----:|
30-
| PF-000 | G1 | A | EXAMPLE — 删除本行 | — | record.spec-defect | PC4 | 缺失 | 否 | 🔄 |
36+
| 编号 | 登记时间 | 规范化意图 | 置信度 | G码 | Axis | 触发来源 | 缺陷类型 | 简述 | 修复方案 | 修复时间 | 是否已验证 | 验证时间 | 验证证据 | SCV要求 | 关联 VL/GAP/PI | 关闭时间 | 状态 |
37+
|------|----------|--------------|--------|:---:|:----:|----------|----------|------|----------|----------|:----------:|----------|----------|:------:|---------------|----------|:----:|
38+
| PF-000 | YYYY-MM-DD HH:mm | record.spec-defect | 高 | G1 | A | PC4 | 缺失 | EXAMPLE — 删除本行 | 示例修复方案 | — | 否 | — | — | 否 | — | — | 🔄 |

‎data/templates/pending-issues.md‎

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

33
> **文件定位**:模板。`devcodex init` / `devcodex init --claude` 复制为目标项目运行时 `data/pending-issues.md`(Copilot: `.github/data/pending-issues.md`;Claude Code: `.claude/data/pending-issues.md`)。
44
> **使用**:记录已确认、但**不阻断当前任务**的治理改进项,按批次进入后续需求或 bug 修复流程。
5-
> **维护者记录**:`.devcodex/.maintainer-state/pending-issues.md`。
5+
> **维护者记录**:不在本包内分发;启用 `workspace-namespace` 时写入对应 active-root,例如 `<工作区根>/.devcodex/<project>/data/pending-issues.md`。
66
77
---
88

‎data/templates/process-improvements.md‎

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

33
> **文件定位**:模板。`devcodex init` / `devcodex init --claude` 复制为目标项目运行时 `data/process-improvements.md`(Copilot: `.github/data/process-improvements.md`;Claude Code: `.claude/data/process-improvements.md`)。
44
> **使用**:C17 触发时追加 PI 条目。
5-
> **维护者记录**:`.devcodex/.maintainer-state/process-improvements.md`。
5+
> **维护者记录**:不在本包内分发;启用 `workspace-namespace` 时写入对应 active-root,例如 `<工作区根>/.devcodex/<project>/data/process-improvements.md`。
66
77
---
88

‎data/templates/violations.md‎

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> **文件定位**:模板。`devcodex init` / `devcodex init --claude` 会将本文件复制到目标项目运行时 `data/violations.md`(Copilot: `.github/data/violations.md`;Claude Code: `.claude/data/violations.md`)。
44
> **使用**:在**用户项目内**,由 AI 按 `17-compliance` 规则追加 VL-001 起的违规记录。
5-
> **维护者自身的违规记录**:不在本包内分发;维护者在仓库 `.devcodex/.maintainer-state/violations.md` 管理。
5+
> **维护者自身的违规记录**:不在本包内分发;启用 `workspace-namespace` 时写入对应 active-root,例如 `<工作区根>/.devcodex/<project>/data/violations.md`。
66
77
---
88

@@ -11,19 +11,26 @@
1111
| 字段 | 说明 | 必填 |
1212
|------|------|:----:|
1313
| 编号 | `VL-NNN`(三位数,从 001 起)| 是 |
14-
| 日期 | ISO 日期 `YYYY-MM-DD` | 是 |
14+
| 规范化意图 | 固定为 `record.violation` | 是 |
15+
| 置信度 | 高 / 中 / 低(低置信度不得写入)| 是 |
16+
| 登记时间 | 精确到分钟,格式 `YYYY-MM-DD HH:mm` | 是 |
1517
| 规范 | 违反的规范编号(如 `S03` / `C11` / `FC4`)| 是 |
1618
| 现象 | 一句话描述违规现象 | 是 |
1719
| 根因 | 规范缺陷 / AI 判断失误 / 用户显式越权 | 是 |
18-
| 规范化意图 | 固定为 `record.violation` | 是 |
19-
| 置信度 | 高 / 中 / 低(低置信度不得写入)| 是 |
20+
| 是否已修复 | 是 / 否 / 部分 | 是 |
21+
| 修复方案 | 对应修复批次或处置策略 | 是 |
22+
| 修复时间 | 完成修复时间,未完成为 `—` | 是 |
23+
| 是否已验证 | 是 / 否 / 部分 | 是 |
24+
| 验证时间 | 完成验证时间,未完成为 `—` | 是 |
25+
| 验证证据 | 命令、报告、SCV/ECR 或 CRS 证据 | 是 |
2026
| 升级关联 | 关联 PF/GAP/ISSUE 编号,无则 `—` | 否 |
21-
| 处置 | 🔄 处理中 / ✅ 已关闭 | 是 |
27+
| 关闭时间 | 关闭时间,未关闭为 `—` | 是 |
28+
| 状态 | 🔄 / ✅ / ⚠️ | 是 |
2229

2330
---
2431

2532
## 登记表
2633

27-
| 编号 | 日期 | 规范 | 现象 | 根因 | 规范化意图 | 置信度 | 升级关联 | 处置 |
28-
|------|------|------|------|------|--------------|--------|----------|:----:|
29-
| VL-000 | YYYY-MM-DD | 示例 | EXAMPLE — 删除本行 | EXAMPLE | record.violation | 高 | — | 🔄 |
34+
| 编号 | 登记时间 | 规范化意图 | 置信度 | 规范 | 现象 | 根因 | 是否已修复 | 修复方案 | 修复时间 | 是否已验证 | 验证时间 | 验证证据 | 升级关联 | 关闭时间 | 状态 |
35+
|------|----------|--------------|--------|------|------|------|:----------:|----------|----------|:----------:|----------|----------|----------|----------|:----:|
36+
| VL-000 | YYYY-MM-DD HH:mm | record.violation | 高 | 示例 | EXAMPLE — 删除本行 | EXAMPLE | 否 | 示例修复方案 | — | 否 | — | — | — | — | 🔄 |

‎instructions.md‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,7 @@
148148

149149
### 记录意图驱动
150150

151-
“记录一下”“这个规范要优化”“以后应该这样做”等表达不得按关键词直接写台账,必须先识别规范化意图:
151+
“记录一下”“这个规范要优化”“以后应该这样做”“你刚才漏了/错了/违反流程了”等表达不得按关键词直接写台账,必须先识别规范化意图:
152152

153153
| 意图 | 目标 |
154154
|------|------|
@@ -162,6 +162,13 @@
162162

163163
每次记录分流必须输出 `规范化意图`、`置信度`、`依据`、`目标台账`。低置信度不得静默写台账。重复 VL 必须判断是否升级 PF/GAP,不能只追加重复违规。
164164

165+
### 台账落点与关闭证据
166+
167+
- `data/*.md` 是运行时逻辑台账路径,实际写入必须按当前 active-root 映射:旧布局写 `<项目根>/.devcodex/data/`,workspace-namespace 单项目写 `<工作区根>/.devcodex/<project>/data/`,全工作区写 `<工作区根>/.devcodex/workspace/data/`。
168+
- DevCodex 规范自身、Hook、Skill、模板、validate 或宿主适配链路问题归属当前 DevCodex 源仓或规范维护项目的 active-root;在 `workspace-namespace` 下应解析为承载 DevCodex 源码或规范资产的项目命名空间,不得因当时正在处理业务项目而写入业务项目台账。
169+
- VL/PF 关闭前必须具备修复方案、修复时间、验证状态、验证时间、验证证据与关闭时间;仅“已登记”不得视为“已验证关闭”。
170+
- 实施完成复审、ECR 或审计复审发现新问题时,必须记录逃逸原因、缺失检查/探针、补救方案,并判断是否升级 VL/PF/GAP。
171+
165172
### AI 与确定性边界
166173

167174
AI 负责语义判断、上下文归因、多意图拆分、模糊表达澄清;安全底线、active-root 路径、CP 状态、台账格式、测试结果和部署同步必须由规则或工具验证。

‎instructions/00-safety.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,4 +55,4 @@ applyTo: "**"
5555
同时在运行时违规台账中追加违规记录:
5656

5757
- **目标项目 / 已部署副本**:`data/violations.md`
58-
- **源仓维护态**:模板位于 `data/templates/violations.md`,维护者实录位于 `.devcodex/.maintainer-state/`
58+
- **源仓维护态**:模板位于 `data/templates/violations.md`;维护者实录按 active-root 写入,例如 workspace-namespace 下的 `.devcodex/<project>/data/violations.md`

0 commit comments

Comments
 (0)