Skip to content

Commit a037f92

Browse files
committed
fix: relax lifecycle hook workflow gates
1 parent 07fd7bd commit a037f92

11 files changed

Lines changed: 276 additions & 71 deletions

File tree

‎CLAUDE.md‎

Lines changed: 33 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
| S04 | 源码和规范文件(.md)修改必须用增量编辑(Edit),禁止整文件重写 | 🟡 操作级阻断 |
1616
| S05 | 每次会话结束前必须写入记忆文件和报告文件,禁止询问用户"是否需要写入" | 🔴 强制 |
1717
| S06 | 禁止直接执行不可逆破坏性命令(`DROP TABLE`、无 WHERE 的 `DELETE FROM`、`rm -rf /`),必须先输出预览等待确认 | 🟡 操作级阻断 |
18-
| S07 | dev 模式下,生成实质任务内容前必须先输出 PC0~PC7 预检查块;若已开始生成但未输出,立即补输出后继续。**v1.9.6+ compaction 触发**:`/compact`、`/resume`、summary 恢复后的首条回复同样视为"首条",须重新输出 PC0~PC7(即使被指示"continue without acknowledging") | 🔴 致命自修正 |
18+
| S07 | 全模式下,生成实质任务内容前必须先输出 PC0~PC7 入口检查块;dev 模式追加 PC4 完整规范雷达,非 dev 模式 PC4 标注 N/A。若已开始生成但未输出,立即补输出后继续。**v1.9.6+ compaction 触发**:`/compact`、`/resume`、summary 恢复后的首条回复同样视为"首条",须重新输出 PC0~PC7(即使被指示"continue without acknowledging") | 🔴 致命自修正 |
1919

2020
---
2121

@@ -46,13 +46,13 @@
4646
| C09 | 文件编码安全 | 禁止用 Bash `Set-Content`/`sed -i` 批量修改中文 .md(破坏 UTF-8),必须用 Edit 工具逐文件修改 |
4747
| C10 | 禁止危险命令 | 同 S06 |
4848
| C11 | 关联文件同步 | 修改/新建/重命名后检查所有引用处并同步 |
49-
| C12 | 合理性评估 | 意图识别后、CP1 前必须评估合理性,有更好建议先提出确认后执行;用户给出判断时 AI 须独立验证,不得顺从论证 |
49+
| C12 | 合理性评估 | 意图识别后、CP1 前必须评估合理性,有更好建议先提出确认后执行;用户给出判断、目录结构或已有设计时 AI 须独立验证,不得顺从论证;若经核验用户方案已最优,可明确说明依据后直接采纳,禁止为了表现“独立”而机械唱反调 |
5050
| C13 | 文件分拆 | AI 新建 .md 超 500 行必须拆分(已有文件豁免)|
5151
| C14 | 多任务检查点 | ≥2 个独立任务:每完成一个追加进度到记忆 + 输出进度快照 |
5252
| C15 | 架构质量视角 | dev/fix 涉及代码设计须从架构师+平台工程师双视角评估:可扩展性/可维护性/易上手性 |
5353
| C16 | 批量操作分批 | ≥10 文件批量操作必须主动提出分批方案(推荐每批 10 个),输出计划后等待确认 |
5454
| C17 | 过程改进记录 | 用户建议的策略经确认更优时立即追加 PI 条目到 `data/process-improvements.md` |
55-
| C18 | dev 预检查不可跳过 | 同 S07 |
55+
| C18 | 全模式入口检查不可跳过 | 同 S07 |
5656
| C19 | 确认后前置复审 | 每次用户明确确认后、进入下一阶段前,必须先对当前已确认产物做 1 轮轻量前置复审,并显式输出结果;控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链场景必须追加交叉验证;若发现阻断性问题,先修正并告知用户,再重新确认;无阻断问题方可推进 |
5757

5858
---
@@ -98,6 +98,19 @@
9898
- Profile 缺失时 ENV_MODE 默认为 `prod`(保守降级)
9999
- 跨会话恢复时**必须重新读取 Profile 文件**(摘要 ≠ Profile 已加载)
100100

101+
### 项目现实扩展
102+
103+
执行顺序必须为:`用户消息语义初判 → 目标项目识别 → Profile/config 加载 → 项目现实扩展 → 最终意图与工作流路由`。
104+
105+
- 项目现实扩展必须结合目标项目的技术栈、目录结构、当前需求/bug 产物、测试/发布约束,修正或确认最终工作流/子类型。
106+
- 项目未识别时,不得为了扩展意图而无界扫描工作区;必须先询问用户。
107+
- PC1 应表达“语义初判 → 项目现实扩展后的最终路由”,PC3 应表达扩展结果与产物落点。
108+
- 当 `<工作区根>/.devcodex/layout.json` 启用 `workspace-namespace` 时,Profile 与运行态目录按**工作区集中命名空间**读取:
109+
- `config.json`:`<工作区根>/.devcodex/workspace/profile/` 作为 base,`<工作区根>/.devcodex/<project>/profile/` 作为 overlay
110+
- Profile 文档:项目命名空间文件优先,缺失回退到 `workspace/profile/`
111+
- 运行态目录:单项目写 `<工作区根>/.devcodex/<project>/...`,全工作区写 `<工作区根>/.devcodex/workspace/...`
112+
- 未启用 `layout.json` 时,继续兼容 `<项目根>/.devcodex/...`
113+
101114
| 文件 | 说明 | 必须 |
102115
|------|------|:----:|
103116
| `README.md` | profile 索引 | 是 |
@@ -106,7 +119,7 @@
106119
| `03-代码风格.md` | 编码规范 | 是 |
107120
| `config.json` | ENV_MODE + agent 标识 | 按需 |
108121

109-
> **Claude Code 与 Copilot 双平台 Bootstrap 硬门禁**(v1.9.2+):`lifecycle.cjs` Hook 在 dev 模式下对两平台均强制要求"先读 Profile + SUMMARY + 今日 tasks 文件,再执行其他工具"。`PreToolUse` 事件会拦截除只读工具(Read/Glob/Grep/list_dir/file_search/semantic_search)以外的全部工具调用,直到 Bootstrap 完成。AI 不需手工提示,但仍须在首条用户可见回复输出 PC0~PC7 预检查块(S07/C18)。
122+
> **Claude Code 与 Copilot 双平台 Bootstrap 提醒**(v1.9.14+):`lifecycle.cjs` Hook 在所有模式下对两平台均要求"先读 Profile + SUMMARY + 今日 tasks 文件,再执行实质任务"。默认 `safety-only` 模式下,`PreToolUse` 对 bootstrap / CP / auto 白名单等流程问题输出提醒并放行工具,仅危险命令继续硬拦;设置 `DEVCODEX_HOOK_ENFORCEMENT=strict` 时恢复流程硬拦截。AI 不需手工提示,但仍须在首条用户可见回复输出 PC0~PC7 入口检查块(S07/C18)。
110123
111124
---
112125

@@ -116,7 +129,7 @@
116129
|--------|:------------:|:-----:|
117130
| CP 门控 | 🔴 强制等待用户确认 | 🔴 强制等待用户确认 |
118131
| 合规检查 | 不执行 | 全量 FC1~FC7 + SC1~SC15 + RC1~RC4 + T1~T9 |
119-
| 预检查输出 | 不输出 | 输出 PC0~PC7 |
132+
| 入口检查输出 | 输出 PC0~PC7 基础状态,PC4 标注 N/A | 输出 PC0~PC7,PC4 执行完整规范雷达 |
120133
| 合规状态块 | 不输出 | 输出全量状态块(chat 豁免合规块,但仍须预检查)|
121134
| 安全底线 S01~S06 | 🔴 强制 | 🔴 强制 |
122135

@@ -230,7 +243,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
230243

231244
- 只读工作流,禁止修改文件
232245
- 多轮收敛:至少 3 轮,连续 **3** 轮零发现后才可宣告收敛
233-
- DevCodex plugin 文件发现问题 → 立即自我审视 + self-fix,修复后重启新轮
246+
- DevCodex plugin 文件发现问题 → 先做阻断/非阻断分流:阻断项立即自我审视 + self-fix,修复后重启新轮;非阻断项写入 `data/pending-issues.md`,继续下一轮
234247
- 其他文件发现问题 → 记录 PF/VL,继续下一轮
235248
- 收敛前门禁:CRS(全库 grep)✅ + PCV(收敛后汇总验证)
236249

@@ -254,12 +267,17 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
254267
### 文件路径
255268

256269
```
257-
<项目根>/.devcodex/.memory/clients/<agent>/tasks/YYYYMMDD.md
270+
<active-root>/.memory/clients/<agent>/tasks/YYYYMMDD.md
258271
```
259272

273+
`<active-root>` 取值:
274+
- 旧布局:`<项目根>/.devcodex`
275+
- 集中布局单项目:`<工作区根>/.devcodex/<project>`
276+
- 集中布局全工作区:`<工作区根>/.devcodex/workspace`
277+
260278
- `<agent>` 解析规则(按优先级):
261279
1. 读 `.devcodex/profile/config.json` 的 `"agent"` 字段
262-
2. 若缺失,按运行环境推断,**枚举值固定**:`copilot` / `claude-code` / `codex` / `cursor` / `vscode-copilot` / `unknown-agent`(禁止使用裸 `claude`,与 Claude API/Claude.ai 区分)
280+
2. 若缺失,按运行环境推断,**枚举值固定**:`copilot` / `vscode-copilot` / `jetbrains-copilot` / `claude-code` / `codex` / `cursor` / `unknown-agent`(禁止使用裸 `claude`,与 Claude API/Claude.ai 区分)
263281
3. `devcodex init --claude` 应自动写入 `"agent": "claude-code"`
264282
- 禁止用 Bash 命令查找记忆文件(shell glob 跳过隐藏目录),必须用 Read 工具逐层进入
265283

@@ -284,7 +302,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
284302
### SUMMARY 文件
285303

286304
```
287-
.devcodex/.memory/clients/<agent>/SUMMARY.md
305+
<active-root>/.memory/clients/<agent>/SUMMARY.md
288306
```
289307

290308
每次会话结束前追加一行索引:`| 日期 | 会话 | 类型 | 摘要 | 关联报告 | 关联记忆 | 状态 |`
@@ -295,16 +313,16 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
295313

296314
执行顺序:`预检查 PC0~PC7 → FC → SC → RC → 报告验证 V1~V6 → 任务完成验证 T1~T9`
297315

298-
### 预检查输出格式(dev 模式,所有工作流前置,chat 也须执行)
316+
### 入口检查输出格式(所有模式,所有工作流前置,chat 也须执行)
299317

300318
```
301319
---
302-
🔍 预检查(DEV 模式)
320+
🔍 入口检查([DEV/PROD] 模式)
303321
- PC0 上下文:项目 [项目名] · 输出语言 [中/英] · Profile ✅已加载/❌未加载
304-
- PC1 意图:[用户意图] → [工作流/子类型]
322+
- PC1 意图:语义初判 [用户意图] → 项目现实扩展后 [工作流/子类型]
305323
- PC2 会话状态:第 N 轮(>10关注/>13预警/>15防护) · 待跟进 ✅无/⚠️[简述]
306-
- PC3 执行准备:未完成任务 ✅无/⚠️存在🔄:[简述] · 产物落点 [已确定/无需/待确定]
307-
- PC4 规范雷达:[三轴诊断结果,见 18-spec-radar.instructions.md](v1.9.4+ 含 G10 limit 截断恢复检测)
324+
- PC3 执行准备:项目现实扩展 [已完成/待澄清] · 未完成任务 ✅无/⚠️存在🔄:[简述] · 产物落点 [已确定/无需/待确定]
325+
- PC4 规范雷达:dev 模式输出三轴诊断结果;非 dev 模式 N/A(dev 扩展诊断未启用)
308326
- PC5 部署体状态(v1.9.4+):cwd 父链 .claude/.github/ ✅ 存在 / N/A 无父级 · 与源仓库同步 ✅ / ⚠️ [N 文件滞后] / N/A
309327
- PC6 工作区一致性(v1.9.4+):git 未提交变更 ✅ 无 / ⚠️ [N 文件 dirty] · 当前需求目录 [requirements/<X>/ / 无关联]
310328
- PC7 新会话首步 resume 强制检测(v1.9.4+,仅首条用户消息触发):✅ 已 Read tasks 文件 + 比对 SUMMARY 一致 / ⚠️ 数据不一致需 resume / N/A(非首条)
@@ -361,7 +379,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
361379
| T3 | 单元/集成测试通过 |
362380
| T4 | 关联文档已同步 |
363381
| T5 | 关联配置已更新 |
364-
| T6 | CHANGELOG 已追加(如属外部可见变更) |
382+
| T6 | CHANGELOG / unreleased 已按发布状态追加(如属外部可见变更) |
365383
| T7 | 影响评估已记录(impact-review) |
366384
| T8 | 报告 V1~V6 验证通过 |
367385
| T9 | 记忆 + SUMMARY 写入完成 |

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,5 @@
88

99
## 2026-05-26
1010

11-
- 当前无未发布变更。
11+
- 调整 lifecycle hook 默认执行策略为 `safety-only`:bootstrap、CP gate、Auto 白名单等流程问题改为提醒放行,仅危险命令继续硬拦,避免多项目/附件场景下读取与澄清工具被自锁。
12+
- 增强多项目目标识别:支持从提示词裸项目名和附件路径推断目标项目,并补充 hook runtime 回归测试。

‎data/pending-issues.md‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,11 @@
1717

1818
## 当前状态
1919

20-
- 当前暂无已登记的非阻断问题池条目。
20+
- 当前已有 2 条已登记的非阻断问题池条目。
21+
22+
## 登记表
23+
24+
| 编号 | 标题 | 发现时间 | 影响范围 | 建议动作 | 状态 |
25+
|------|------|-----------|----------|----------|:----:|
26+
| ISSUE-001 | 单源 instructions.md 仍混入 Claude 专属路径与工具语义 | 2026-05-26 | instructions.md、index.js init/update、Copilot 端 .github/copilot-instructions.md | 将单源正文改为平台中性表达,或在复制阶段按目标平台注入专属尾注/章节,并补跨端语义校验 | 🔄 |
27+
| ISSUE-002 | audit-state 历史 paused 会话会保留过时 open findings 并继续进入 resume 候选集 | 2026-05-26 | .audit-state/*.json、skills/audit-session/SKILL.md、scripts/validate.js V15 | 为 audit-state 增加 superseded/过时检测与收口策略,并在 resume 选择和 V15 中排除或告警陈旧 paused 会话 | 🔄 |

0 commit comments

Comments
 (0)