From ebc132bc2ef025bae9e816df709378782cb65024 Mon Sep 17 00:00:00 2001
From: li <ljf@com>
Date: Mon, 9 Mar 2026 17:06:17 +0800
Subject: [PATCH] docs: add spec template guardrail changes to v1.7.74
 changelog

- USER GUIDANCE RULE in spec-research/plan/impl templates
- TASKS FORMAT RULE in spec-plan/impl templates
- Internal /opsx:* calls marked with failure fallback to /ccg:spec-*
---
 CHANGELOG.md | 4 ++++
 CLAUDE.md    | 1 +
 2 files changed, 5 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1d892aa..edd905f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.7.74] - 2026-03-09
 
+### 🔄 变更
+
+- **spec 模板 guardrail 加固**：`spec-research`/`spec-plan`/`spec-impl` 三个模板新增 USER GUIDANCE RULE，防止 LLM 向用户暴露内部 `/opsx:*` 命令，统一引导至 `/ccg:spec-*`；`spec-plan`/`spec-impl` 额外添加 TASKS FORMAT RULE 防止 checkbox 格式问题
+
 ### 🐛 修复
 
 - **Gemini CLI `.env` 隔离**：修复 Gemini CLI 从项目目录加载 `.env` 导致全局 API Key 被覆盖的问题。codeagent-wrapper 现将 Gemini 的 `cmd.Dir` 设为 `$HOME`，项目目录通过 `--include-directories` 传入
diff --git a/CLAUDE.md b/CLAUDE.md
index 81fc0aa..b24f456 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -11,6 +11,7 @@
 > 完整变更历史请查看 [CHANGELOG.md](./CHANGELOG.md)
 
 ### 2026-03-09 (v1.7.74)
+- 🔄 **spec 模板 guardrail**：`spec-research`/`spec-plan`/`spec-impl` 添加 USER GUIDANCE RULE + TASKS FORMAT RULE，内部 `/opsx:*` 调用标注 internal，失败引导至 `/ccg:spec-*`
 - 🐛 **Gemini CLI `.env` 隔离**：`cmd.Dir=$HOME` + `--include-directories` 避免项目 `.env` 覆盖全局 API Key
 - 🐛 **Codex 测试修正**：环境变量名 `CODEX_BYPASS_SANDBOX` → `CODEX_REQUIRE_APPROVAL`