Skip to content

Commit 6d18704

Browse files
committed
fix bootstrap gate for shell read commands
1 parent 2f76113 commit 6d18704

4 files changed

Lines changed: 86 additions & 1 deletion

File tree

‎CLAUDE.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@
5353
| C16 | 批量操作分批 | ≥10 文件批量操作必须主动提出分批方案(推荐每批 10 个),输出计划后等待确认 |
5454
| C17 | 过程改进记录 | 用户建议的策略经确认更优时立即追加 PI 条目到 `data/process-improvements.md` |
5555
| C18 | dev 预检查不可跳过 | 同 S07 |
56+
| C19 | 确认后前置复审 | 每次用户明确确认后、进入下一阶段前,必须先对当前已确认产物做 1 轮轻量前置复审,并显式输出结果;控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链场景必须追加交叉验证;若发现阻断性问题,先修正并告知用户,再重新确认;无阻断问题方可推进 |
5657

5758
---
5859

@@ -160,6 +161,12 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
160161
| 追问 | 回答后保持当前 CP 状态 |
161162
| 模糊 | 主动确认("您的意思是...?")|
162163

164+
### 确认后前置轻量复审
165+
166+
- 每次 CP1 / CP2 / CP3 确认后、进入下一阶段前,必须先做 1 轮轻量前置复审,并显式输出结果。
167+
- 当场景涉及控制面规则、多文件联动、真相源同步、模板/示例/校验链联动时,前置复审必须追加交叉验证。
168+
- 若前置复审或交叉验证发现阻断项,必须先修正当前产物并重新确认,不得继续推进。
169+
163170
### Skill 按需读取(仅读对应子类型 Skill)
164171

165172
> Skill 文件位于 `.claude/skills/<name>/SKILL.md`,按需用 Read 工具读取,禁止全量读取。
@@ -197,6 +204,12 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
197204
- **CP2**:输出修复方案 → 等待确认
198205
- **CP3**:≥5 文件变更 或 含高风险操作时必须
199206

207+
### 确认后前置轻量复审
208+
209+
- fix 工作流在 CP1 / CP2 / CP3 确认后、进入下一阶段前,同样必须先做 1 轮轻量前置复审,并显式输出结果。
210+
- 当问题涉及控制面规则、多文件联动、真相源同步、模板/示例/校验链联动时,必须追加交叉验证。
211+
- 若发现阻断项,先修正当前产物并重新确认,再继续推进。
212+
200213
### 修复三步必做(执行后立即扫描,不可省略)
201214

202215
1. **同类全局扫描** — 同一模式错误是否存在于其他位置(grep 全项目)
@@ -308,6 +321,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
308321
| FC4 | 输出语言正确 |
309322
| FC5 | 引用规范文件存在 |
310323
| FC6 | 合规块已输出 |
324+
| FC7 | 用户决策选项必带推荐 + 理由 |
311325

312326
### SC 实质合规(选取适用项检查)
313327

@@ -327,6 +341,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
327341
| SC12 | 批量操作分批方案已确认(C16) |
328342
| SC13 | 过程改进 PI 已追加(C17) |
329343
| SC14 | 文件 UTF-8 编码安全(C09) |
344+
| SC15 | dev/fix 关键产物已完成轻量复审收敛 |
330345

331346
### RC 恢复性检查
332347

@@ -361,6 +376,15 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
361376
- 仅在用户明确追问内部分类/机制时才展开内部术语,且最小化展开
362377
- Commit subject 只描述主变更,不堆叠背景/验证步骤
363378

379+
## 提交与未发布变更边界
380+
381+
- 当本次开发/修复形成一个**已验证的语义变更批次**,且用户**未明确要求** `tag` / `release` / `publish` 时,默认更新 `changelogs/unreleased.md`,不默认进入正式发版流程。
382+
- `commit` 默认不自动执行,也不按“问题个数”切分;应按**语义批次**提交。
383+
- 以下场景适合执行 `commit`:
384+
- 用户明确要求提交当前变更
385+
- 需要独立回滚点
386+
- 当前语义批次边界清晰且已验证闭环
387+
364388
---
365389

366390
## Claude Code 工具适配说明

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,3 +13,4 @@
1313
- **发布与 CHANGELOG 双阶段收口**:建立“未明确发版默认写 `unreleased`、明确发版后再归档正式版本”的统一规则,新增三层日志模型说明并同步到规范、文档同步、发布指南和报告模板。
1414
- **控制面规则与 API 验证模板收口**:统一前置复审显式输出、控制面交叉验证、语义批次 `unreleased/commit` 边界和 `fix.default` 路径锚点;同时把 `api-verification` 的 `.http/.cjs` 模板、Skill 示例和 `validate.js` 探针修到一致,并同步工作区 `AGENTS.md`、`.github`、`.claude` 部署副本。
1515
- **工作区优先配置与 profile 读取链升级**:新增工作区级 VS Code 启动配置(`chat/payment/user/search/resource/push`),并把 runtime 与 MCP profile 读取升级为“项目根优先、工作区兜底、不隐式合并”,同时补齐需求级实施报告、会话产物与记忆索引,便于按语义批次追踪与本地回滚。
16+
- **Bootstrap 门禁兼容 shell_command 只读链路**:修复 `hooks/_runtime/lifecycle.cjs` 在 dev bootstrap 阶段误拦 `shell_command` 的问题;新增只读 shell 判定(允许 `Get-Content/ls/rg` 等读取命令,拒绝 `Set-Content`/重定向/复制移动删除等写操作),并补齐 `scripts/test-hooks-runtime.js` 回归用例,避免再次出现“读取命令被误拦”。

‎hooks/_runtime/lifecycle.cjs‎

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -429,7 +429,19 @@ function isBootstrapReadTool(payload, state) {
429429
/^read([_-]?file)?$/, /^list[_-]?dir$/, /^file[_-]?search$/,
430430
/^grep([_-]?search)?$/, /^semantic[_-]?search$/, /^glob$/
431431
]
432-
return readPatterns.some(p => p.test(tn)) && (
432+
if (readPatterns.some(p => p.test(tn))) {
433+
return (
434+
touchesPath(payload, ...scopes.profileNeedles) ||
435+
touchesPath(payload, ...scopes.memoryNeedles)
436+
)
437+
}
438+
const shellReadPatterns = [
439+
/^shell[_-]?command$/, /^run[_-]?in[_-]?terminal$/, /^send[_-]?to[_-]?terminal$/,
440+
/^bash$/, /^powershell$/
441+
]
442+
if (!shellReadPatterns.some(p => p.test(tn))) return false
443+
if (!isReadOnlyBootstrapShellCommand(payload)) return false
444+
return (
433445
touchesPath(payload, ...scopes.profileNeedles) ||
434446
touchesPath(payload, ...scopes.memoryNeedles)
435447
)
@@ -457,6 +469,25 @@ function updateBootstrapState(state, payload) {
457469
if (state.bootstrapComplete) state.phase = 'active'
458470
}
459471

472+
function isReadOnlyBootstrapShellCommand(payload) {
473+
const command = getCommandText(payload)
474+
if (!command || !command.trim()) return false
475+
const cmd = command.toLowerCase()
476+
// Bootstrap should only allow a single, simple read-only command.
477+
if (/[;&|`]/.test(command) || /\$\(|\b(?:&&|\|\|)\b/.test(command)) return false
478+
// Block obvious write/mutation behaviors up front.
479+
if (
480+
/>{1,2}/.test(command) ||
481+
/\b(set-content|add-content|out-file|tee|copy-item|move-item|remove-item|new-item|rename-item)\b/i.test(command) ||
482+
/\b(sc|ac|ni|ri|mi)\b/i.test(command) ||
483+
/\b(cp|mv|rm|del|erase|touch|mkdir|rmdir|git\s+add|git\s+commit|npm\s+install)\b/i.test(command)
484+
) {
485+
return false
486+
}
487+
// Allow common read-only introspection commands.
488+
return /\b(get-content|cat|type|get-childitem|ls|dir|rg|findstr|select-string|head|tail|more|echo)\b/.test(cmd)
489+
}
490+
460491
function buildBootstrapMessage() {
461492
return [
462493
'DevCodex hook-enforced bootstrap is active for this user message.',

‎scripts/test-hooks-runtime.js‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,35 @@ function main() {
106106
assert.strictEqual(blockedBeforeBootstrap.hookSpecificOutput.permissionDecision, 'deny')
107107
assert.match(blockedBeforeBootstrap.hookSpecificOutput.permissionDecisionReason || '', /bootstrap/i)
108108

109+
const shellReadAllowedDuringBootstrap = run({
110+
hookEventName: 'PreToolUse',
111+
tool_name: 'shell_command',
112+
tool_input: {
113+
command: 'Get-Content .devcodex/profile/config.json'
114+
}
115+
})
116+
assert.strictEqual(shellReadAllowedDuringBootstrap.continue, true)
117+
118+
const shellWriteBlockedDuringBootstrap = run({
119+
hookEventName: 'PreToolUse',
120+
tool_name: 'shell_command',
121+
tool_input: {
122+
command: 'Set-Content .devcodex/profile/config.json "{}"'
123+
}
124+
})
125+
assert.strictEqual(shellWriteBlockedDuringBootstrap.hookSpecificOutput.permissionDecision, 'deny')
126+
assert.match(shellWriteBlockedDuringBootstrap.hookSpecificOutput.permissionDecisionReason || '', /bootstrap/i)
127+
128+
const shellAliasWriteBlockedDuringBootstrap = run({
129+
hookEventName: 'PreToolUse',
130+
tool_name: 'shell_command',
131+
tool_input: {
132+
command: 'Get-Content .devcodex/profile/config.json; sc .devcodex/profile/config.json "{}"'
133+
}
134+
})
135+
assert.strictEqual(shellAliasWriteBlockedDuringBootstrap.hookSpecificOutput.permissionDecision, 'deny')
136+
assert.match(shellAliasWriteBlockedDuringBootstrap.hookSpecificOutput.permissionDecisionReason || '', /bootstrap/i)
137+
109138
run({
110139
hookEventName: 'PreToolUse',
111140
tool_name: 'read_file',

0 commit comments

Comments
 (0)