specline 1.0.0 → 1.1.0

package/templates/.cursor/agents/specline-config-reviewer.md

@@ -0,0 +1,79 @@
+---
+name: specline-config-reviewer
+description: 审查 config/docs 类型的代码变更——shell 脚本的安全性、配置文件的语法和一致性、Markdown 文档的结构完整性。产出 code-review.json，区分 error（必须修复）和 warning（建议改进）。
+---
+
+你是 **specline-config-reviewer**，专门审查 `Type: config` 和 `Type: docs` 任务的产出。
+
+## 角色定位
+
+- 审查 shell 脚本、JSON/YAML 配置文件、Markdown 文档的变更
+- 在 CODE REVIEW 阶段被调用
+- 产出结构化 `code-review.json`，格式与 `specline-code-reviewer` 保持一致
+
+## 审查维度
+
+### Shell 脚本（`.sh`）
+- **语法正确性**：检查 `bash -n` 是否有语法错误
+- **安全性**：
+  - 检查命令注入风险（未转义的用户输入、eval 调用）
+  - 检查未引用的变量（导致路径注入）
+  - 危险的路径操作（`rm -rf /` 等）
+  - 不安全的权限设置（`chmod 777`）
+- **可维护性**：set 选项使用、错误处理是否完整
+
+### 配置文件（`.json`、`.yaml`、`.yml`）
+- **语法有效性**：JSON/YAML 解析是否成功
+- **字段完整性**：必备字段是否存在
+- **一致性**：与现有配置的值是否冲突
+- **安全性**：是否包含硬编码的密钥、令牌
+
+### Markdown 文档（`.md`）
+- **结构完整性**：必需章节是否存在
+- **链接有效性**：相对路径引用是否正确
+- **与 Spec 一致性**：文档描述是否与 spec.md 中的要求匹配
+
+## 工作方式
+
+1. 查看本次变更中 config/docs 任务修改的文件（从 git diff 或文件内容对比）
+2. 对照 tasks.md 的 `Covers` 追溯链，确认每个变更对应的 Requirement 和 Scenario
+3. 逐一审查文件，按审查维度发现的问题归类
+4. 产出 `code-review.json` 到 `specline/changes/<change>/.tmp/code-review.json`
+
+## 输出
+
+```json
+{
+  "findings": [
+    {
+      "severity": "error",
+      "file": "path/to/script.sh",
+      "line": 42,
+      "task_id": "3",
+      "covers": "Requirement: 安全配置",
+      "message": "未引用的变量 $DIR 可能导致路径注入"
+    },
+    {
+      "severity": "warning",
+      "file": "path/to/config.json",
+      "task_id": "4",
+      "covers": "Requirement: Hook 注册",
+      "message": "建议添加字段 'description' 提高可读性"
+    }
+  ]
+}
+```
+
+- `severity`: `"error"`（必须修复）或 `"warning"`（建议改进）
+- `file`: 问题所在文件路径
+- `line`: 问题所在行号（如果适用，否则省略）
+- `task_id`: 关联的任务 ID
+- `covers`: 关联的 Requirement/Scenario 引用
+- `message`: 问题和修复建议
+
+## 约束
+
+1. 只审查 `Type: config` 或 `Type: docs` 任务的文件
+2. 不审查前端或后端代码（留给 specline-code-reviewer）
+3. error 级别的问题在 `specline-pipeline-gate.sh lint` 中会被计数并阻塞流水线
+4. 如果无 config/docs 变更，直接返回空 findings 数组

package/templates/.cursor/agents/specline-frontend-dev.md

@@ -34,7 +34,7 @@ description: 根据 Spec 编写前端代码（UI 组件、页面、样式、交
 
 ## 产出报告
 
-完成后输出 JSON 到 `.cursor/tmp/task-<task-id>-result.json`：
+完成后输出 JSON 到 `specline/changes/<change>/.tmp/task-<task-id>-result.json`：
 
 ```json
 {

package/templates/.cursor/agents/specline-test-writer.md

@@ -103,7 +103,7 @@ Spec Scenario                         →  Test Function
 
 ## 产出报告
 
-完成后输出 JSON 到 `.cursor/tmp/test-code-result.json`：
+完成后输出 JSON 到 `specline/changes/<change>/.tmp/test-code-result.json`：
 
 ```json
 {

package/templates/.cursor/hooks/specline-agent-guard.sh

@@ -1,15 +1,123 @@
 #!/usr/bin/env bash
-# agent-guard.sh — subagentStart Hook: 校验子Agent类型
-ALLOWED_AGENTS="specline-spec-creator|specline-spec-reviewer|specline-frontend-dev|specline-backend-dev|specline-code-reviewer|specline-test-writer|specline-test-runner"
+# specline-agent-guard.sh — subagentStart Hook（增强版）
+# 白名单校验 + 流水线阶段匹配校验
+#
+# Input (stdin JSON):
+#   { "subagent_type": "...", "subagent_id": "...", "task": "...", ... }
+#
+# Output (stdout JSON):
+#   { "permission": "allow" } 或 { "permission": "deny", "user_message": "..." }
+
+set -euo pipefail
+
 input=$(cat)
 subagent_type=$(echo "$input" | jq -r '.subagent_type // empty')
-if [ -z "$subagent_type" ]; then
+
+# 非 specline agent → 放行（不受 Specline 管控）
+if ! echo "$subagent_type" | grep -qE "^specline-"; then
   echo '{"permission": "allow"}'
   exit 0
 fi
-if echo "$subagent_type" | grep -qE "^($ALLOWED_AGENTS)$"; then
+
+# ===== 1. 白名单校验 =====
+ALLOWED_AGENTS="specline-spec-creator|specline-spec-reviewer|specline-frontend-dev|specline-backend-dev|specline-config-dev|specline-code-reviewer|specline-config-reviewer|specline-test-writer|specline-test-runner"
+
+if ! echo "$subagent_type" | grep -qE "^($ALLOWED_AGENTS)$"; then
+  echo "{\"permission\": \"deny\", \"user_message\": \"子Agent类型 '$subagent_type' 不在 Specline 允许列表中。允许的类型: spec-creator, spec-reviewer, frontend-dev, backend-dev, config-dev, code-reviewer, config-reviewer, test-writer, test-runner\"}"
+  exit 0
+fi
+
+# ===== 2. 流水线阶段匹配校验 =====
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CHANGES_DIR="$PROJECT_ROOT/specline/changes"
+
+# 查找活跃 pipeline
+find_active_pipeline() {
+  if [ ! -d "$CHANGES_DIR" ]; then
+    echo ""
+    return
+  fi
+  for f in "$CHANGES_DIR"/*/.pipeline-state.json; do
+    [ -f "$f" ] || continue
+    if echo "$f" | grep -q "/archive/"; then continue; fi
+    local ph
+    ph=$(jq -r '.current_phase // ""' "$f" 2>/dev/null)
+    if [ "$ph" != "archive" ] && [ "$ph" != "" ]; then
+      echo "$f"
+      return
+    fi
+  done
+  echo ""
+}
+
+STATE_FILE=$(find_active_pipeline)
+
+# 无活跃 pipeline → 放行（不在流水线中的会话可以使用任何 specline agent）
+if [ -z "$STATE_FILE" ]; then
   echo '{"permission": "allow"}'
   exit 0
 fi
-echo "{\"permission\": \"deny\", \"user_message\": \"子Agent类型 '$subagent_type' 不在允许列表中。\"}"
+
+phase=$(jq -r '.current_phase' "$STATE_FILE")
+change=$(jq -r '.change_name' "$STATE_FILE")
+
+# 判断 Agent 类型分类
+is_spec_agent=$(echo "$subagent_type" | grep -qE "specline-spec-creator|specline-spec-reviewer" && echo "true" || echo "false")
+is_coding_agent=$(echo "$subagent_type" | grep -qE "^(specline-frontend-dev|specline-backend-dev|specline-config-dev)$" && echo "true" || echo "false")
+is_review_agent=$(echo "$subagent_type" | grep -qE "^(specline-code-reviewer|specline-config-reviewer)$" && echo "true" || echo "false")
+is_test_agent=$(echo "$subagent_type" | grep -qE "specline-test-writer|specline-test-runner" && echo "true" || echo "false")
+
+case "$phase" in
+  spec)
+    if [ "$is_coding_agent" = "true" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 SPEC 阶段不能启动编码 Agent: $subagent_type。变更: $change。请先完成 SPEC → CODING 阶段切换。\"}"
+      exit 0
+    fi
+    if [ "$is_test_agent" = "true" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 SPEC 阶段不能启动测试 Agent: $subagent_type。变更: $change。\"}"
+      exit 0
+    fi
+    if [ "$is_review_agent" = "true" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 SPEC 阶段不能启动代码审查 Agent: $subagent_type。变更: $change。请使用 specline-spec-reviewer。\"}"
+      exit 0
+    fi
+    # spec-creator, spec-reviewer → 放行
+    ;;
+
+  coding)
+    if [ "$is_spec_agent" = "true" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 CODING 阶段不能启动 Spec Agent: $subagent_type。变更: $change。如需修改 Spec，请手动编辑文件。\"}"
+      exit 0
+    fi
+    # 编码/测试/审查 agent → 放行
+    ;;
+
+  code_review)
+    if [ "$is_spec_agent" = "true" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 CODE REVIEW 阶段不能启动 Spec Agent: $subagent_type。变更: $change。\"}"
+      exit 0
+    fi
+    if [ "$is_test_agent" = "true" ] && [ "$subagent_type" != "specline-test-writer" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 CODE REVIEW 阶段不能启动测试运行 Agent。变更: $change。Test 在下一阶段。\"}"
+      exit 0
+    fi
+    ;;
+
+  test)
+    if [ "$is_spec_agent" = "true" ]; then
+      echo "{\"permission\": \"deny\", \"user_message\": \"🚫 TEST 阶段不能启动 Spec Agent: $subagent_type。变更: $change。\"}"
+      exit 0
+    fi
+    # 编码/测试/审查 agent → 放行（测试阶段可能需要编码修复）
+    ;;
+
+  archive)
+    echo "{\"permission\": \"deny\", \"user_message\": \"🚫 变更 $change 已归档，不能启动任何子 Agent。\"}"
+    exit 0
+    ;;
+esac
+
+# 阶段匹配 + 白名单都通过
+echo '{"permission": "allow"}'
 exit 0

package/templates/.cursor/hooks/specline-phase-guard.sh

@@ -0,0 +1,202 @@
+#!/usr/bin/env bash
+# specline-phase-guard.sh — preToolUse Hook
+# 操作前按流水线阶段校验并拦截违规行为
+#
+# Input (stdin JSON):
+#   { "tool_name": "Write"|"Task"|"Shell"|"Delete"|..., "tool_input": {...}, ... }
+#
+# Output (stdout JSON):
+#   { "permission": "allow" }  或  { "permission": "deny", "user_message": "...", "agent_message": "..." }
+
+set -euo pipefail
+
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+tool_input=$(echo "$input" | jq -r '.tool_input // "{}"')
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CHANGES_DIR="$PROJECT_ROOT/specline/changes"
+
+# ===== 辅助函数 =====
+
+# 查找第一个活跃 pipeline（排除 archive/）
+find_active_pipeline() {
+  if [ ! -d "$CHANGES_DIR" ]; then
+    echo ""
+    return
+  fi
+  for f in "$CHANGES_DIR"/*/.pipeline-state.json; do
+    [ -f "$f" ] || continue
+    if echo "$f" | grep -q "/archive/"; then continue; fi
+    local ph
+    ph=$(jq -r '.current_phase // ""' "$f" 2>/dev/null)
+    if [ "$ph" != "archive" ] && [ "$ph" != "" ]; then
+      echo "$f"
+      return
+    fi
+  done
+  echo ""
+}
+
+deny() {
+  local user_msg="$1"
+  local agent_msg="$2"
+  # JSON 转义
+  user_msg=$(echo "$user_msg" | jq -Rs '.')
+  agent_msg=$(echo "$agent_msg" | jq -Rs '.')
+  cat << EOF
+{
+  "permission": "deny",
+  "user_message": ${user_msg},
+  "agent_message": ${agent_msg}
+}
+EOF
+}
+
+allow() {
+  echo '{"permission": "allow"}'
+}
+
+# ===== 主逻辑 =====
+
+STATE_FILE=$(find_active_pipeline)
+
+# 无活跃 pipeline → 透明放行
+if [ -z "$STATE_FILE" ]; then
+  allow
+  exit 0
+fi
+
+phase=$(jq -r '.current_phase' "$STATE_FILE")
+change=$(jq -r '.change_name' "$STATE_FILE")
+tasks_file="$CHANGES_DIR/$change/tasks.md"
+
+# ---- Write / StrReplace / EditNotebook ----
+case "$tool_name" in
+  Write|StrReplace|EditNotebook)
+    # SPEC 阶段：禁止编辑非 specline 的源代码文件
+    if [ "$phase" = "spec" ]; then
+      file_path=$(echo "$tool_input" | jq -r '.path // .file_path // empty')
+
+      if [ -n "$file_path" ]; then
+        # 允许 specline 规划文件
+        if echo "$file_path" | grep -q "specline/"; then
+          allow
+          exit 0
+        fi
+
+        # 允许 hook/config 文件（流水线基础设施）
+        if echo "$file_path" | grep -qE "(\.cursor/|hooks\.json|package\.json)"; then
+          allow
+          exit 0
+        fi
+
+        # 代码文件 → 拦截
+        if echo "$file_path" | grep -qE '\.(ts|tsx|js|jsx|py|go|rs|java|rb|php|css|html|vue|svelte)$'; then
+          deny \
+            "🚫 SPEC 阶段不能编辑代码文件: $(basename "$file_path")" \
+            "当前处于 SPEC 阶段（变更：$change）。不能直接编辑应用代码文件。只有在进入 CODING 阶段后才能修改代码。如需修改规划文件，只能编辑 specline/changes/ 下的内容。"
+          exit 0
+        fi
+      fi
+    fi
+
+    # ARCHIVE 阶段：禁止任何编辑
+    if [ "$phase" = "archive" ]; then
+      deny \
+        "🚫 变更 $change 已归档，不能修改文件" \
+        "变更 $change 已归档。不能修改任何文件。如需继续工作，请创建新的变更。"
+      exit 0
+    fi
+
+    # CODING/CODE_REVIEW/TEST 阶段：放行
+    # (子 Agent 需要编辑代码文件，Orchestrator 的行为靠 SKILL + sessionStart 上下文约束)
+    allow
+    ;;
+
+  # ---- Task (子Agent) ----
+  Task)
+    subagent_type=$(echo "$tool_input" | jq -r '.subagent_type // empty')
+
+    # 不是 specline agent → 放行
+    if ! echo "$subagent_type" | grep -qE "^specline-"; then
+      allow
+      exit 0
+    fi
+
+    is_coding_agent=$(echo "$subagent_type" | grep -qE "^(specline-frontend-dev|specline-backend-dev|specline-config-dev)$" && echo "true" || echo "false")
+    is_spec_agent=$(echo "$subagent_type" | grep -qE "^(specline-spec-creator|specline-spec-reviewer)$" && echo "true" || echo "false")
+    is_test_agent=$(echo "$subagent_type" | grep -qE "^(specline-test-writer|specline-test-runner)$" && echo "true" || echo "false")
+    is_review_agent=$(echo "$subagent_type" | grep -qE "^(specline-code-reviewer|specline-config-reviewer)$" && echo "true" || echo "false")
+
+    case "$phase" in
+      spec)
+        if [ "$is_coding_agent" = "true" ]; then
+          deny \
+            "🚫 SPEC 阶段不能启动编码 Agent ($subagent_type)" \
+            "当前在 SPEC 阶段（变更：$change）。编码 Agent（$subagent_type）只能在 CODING 阶段启动。如需编码，请先完成 Spec Gate 和人工确认。"
+          exit 0
+        fi
+        if [ "$is_test_agent" = "true" ]; then
+          deny \
+            "🚫 SPEC 阶段不能启动测试 Agent ($subagent_type)" \
+            "当前在 SPEC 阶段（变更：$change）。测试 Agent 只能在 CODING 或 TEST 阶段启动。"
+          exit 0
+        fi
+        # spec-creator / spec-reviewer → 放行
+        ;;
+
+      coding)
+        if [ "$is_spec_agent" = "true" ]; then
+          deny \
+            "🚫 CODING 阶段不能启动 Spec Agent ($subagent_type)" \
+            "当前在 CODING 阶段（变更：$change）。Spec Agent 只能在 SPEC 阶段启动。如需修改 Spec 文档，请手动编辑 specline/changes/ 下的文件后恢复流水线。"
+          exit 0
+        fi
+        # 编码/测试/审查 agent → 放行
+        ;;
+
+      code_review)
+        if [ "$is_spec_agent" = "true" ]; then
+          deny \
+            "🚫 CODE REVIEW 阶段不能启动 Spec Agent ($subagent_type)" \
+            "当前在 CODE REVIEW 阶段（变更：$change）。Spec Agent 只能在 SPEC 阶段启动。"
+          exit 0
+        fi
+        ;;
+
+      test)
+        if [ "$is_spec_agent" = "true" ]; then
+          deny \
+            "🚫 TEST 阶段不能启动 Spec Agent ($subagent_type)" \
+            "当前在 TEST 阶段（变更：$change）。Spec Agent 只能在 SPEC 阶段启动。"
+          exit 0
+        fi
+        ;;
+    esac
+
+    allow
+    ;;
+
+  # ---- Delete ----
+  Delete)
+    # SPEC 阶段禁止删除代码文件
+    if [ "$phase" = "spec" ]; then
+      file_path=$(echo "$tool_input" | jq -r '.path // empty')
+      if [ -n "$file_path" ] && ! echo "$file_path" | grep -q "specline/"; then
+        deny \
+          "🚫 SPEC 阶段不能删除代码文件" \
+          "当前在 SPEC 阶段，不能删除应用代码文件。"
+        exit 0
+      fi
+    fi
+    allow
+    ;;
+
+  *)
+    allow
+    ;;
+esac
+
+exit 0

package/templates/.cursor/hooks/specline-pipeline-gate.sh

@@ -88,6 +88,7 @@ gate_new() {
   fi
 
   mkdir -p "$change_dir/specs"
+  mkdir -p "$change_dir/.tmp"
 
   # 写入 .specline.yaml
   cat > "$change_dir/.specline.yaml" << YAML
@@ -363,8 +364,8 @@ gate_lint() {
     fi
   fi
 
-  # code-review.json error 计数
-  local review_file="$PROJECT_ROOT/code-review.json"
+  # code-review.json error 计数（位于 change 的 .tmp/ 目录下）
+  local review_file="$PROJECT_ROOT/specline/changes/$CHANGE/.tmp/code-review.json"
   if [ -f "$review_file" ]; then
     local error_count
     error_count=$(jq '[.findings[] | select(.severity=="error")] | length' "$review_file" 2>/dev/null || echo "0")
@@ -584,6 +585,8 @@ gate_archive() {
     mv "$src_dir" "$dest"
     echo "✅ 已归档到: $dest"
 
+    # 临时文件（.tmp/）随 change 目录一起归档，无需单独清理
+
     # 更新状态文件
     if [ -f "$dest/.pipeline-state.json" ]; then
       local now

package/templates/.cursor/hooks/specline-reminder.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# specline-reminder.sh — postToolUse Hook
+# 关键操作后注入下一步提醒到 Agent 上下文
+#
+# Input (stdin JSON):
+#   { "tool_name": "Task"|"Write"|..., "tool_input": {...}, "tool_output": "...", ... }
+#
+# Output (stdout JSON):
+#   { "additional_context": "<提醒文本>" }  或  {}
+
+set -euo pipefail
+
+input=$(cat)
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+tool_input=$(echo "$input" | jq -r '.tool_input // "{}"')
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CHANGES_DIR="$PROJECT_ROOT/specline/changes"
+
+# ===== 辅助函数 =====
+
+find_active_pipeline() {
+  if [ ! -d "$CHANGES_DIR" ]; then
+    echo ""
+    return
+  fi
+  for f in "$CHANGES_DIR"/*/.pipeline-state.json; do
+    [ -f "$f" ] || continue
+    if echo "$f" | grep -q "/archive/"; then continue; fi
+    local ph
+    ph=$(jq -r '.current_phase // ""' "$f" 2>/dev/null)
+    if [ "$ph" != "archive" ] && [ "$ph" != "" ]; then
+      echo "$f"
+      return
+    fi
+  done
+  echo ""
+}
+
+STATE_FILE=$(find_active_pipeline)
+
+# 无活跃 pipeline → 透明
+if [ -z "$STATE_FILE" ]; then
+  echo '{}'
+  exit 0
+fi
+
+phase=$(jq -r '.current_phase' "$STATE_FILE")
+change=$(jq -r '.change_name' "$STATE_FILE")
+
+# ---- Task (子Agent) 完成后 ----
+if [ "$tool_name" = "Task" ]; then
+  subagent_type=$(echo "$tool_input" | jq -r '.subagent_type // ""')
+
+  if [ "$phase" = "coding" ] && echo "$subagent_type" | grep -qE "^specline-"; then
+    # 检查是否还有同批次未完成的任务
+    pending_in_batch="?"
+    pending_tasks=$(jq -r '[.phases.coding.tasks[]? | select(.status == "pending")] | length' "$STATE_FILE" 2>/dev/null || echo "0")
+
+    reminder="🔔 **[Pipeline] 子 Agent ($subagent_type) 已完成**\n"
+    reminder+="- 变更: $change | 阶段: CODING\n"
+
+    if [ "$pending_tasks" != "0" ] && [ "$pending_tasks" != "?" ]; then
+      reminder+="- 还有 ${pending_tasks} 个任务未完成\n"
+    fi
+
+    reminder+="- ⚠️ 请更新 tasks.md 中对应任务的 checkbox：[ ] → [x]\n"
+    reminder+="- ⚠️ 当前批次全部完成后，运行 Build Gate:\n"
+    reminder+="  \`.cursor/hooks/specline-pipeline-gate.sh build --change \"$change\"\`"
+
+    escaped=$(echo -e "$reminder" | jq -Rs '.')
+    cat << EOF
+{
+  "additional_context": ${escaped}
+}
+EOF
+    exit 0
+  fi
+
+  if [ "$phase" = "test" ] && echo "$subagent_type" | grep -qE "^specline-"; then
+    reminder="🔔 **[Pipeline] 测试修复 Agent ($subagent_type) 已完成**\n"
+    reminder+="- 变更: $change | 阶段: TEST\n"
+    reminder+="- ⚠️ 请重新运行对应的测试 Gate:\n"
+    reminder+="  \`.cursor/hooks/specline-pipeline-gate.sh test-unit --change \"$change\"\`"
+
+    escaped=$(echo -e "$reminder" | jq -Rs '.')
+    cat << EOF
+{
+  "additional_context": ${escaped}
+}
+EOF
+    exit 0
+  fi
+fi
+
+# ---- Write / StrReplace 完成后 ----
+if [ "$tool_name" = "Write" ] || [ "$tool_name" = "StrReplace" ]; then
+  file_path=$(echo "$tool_input" | jq -r '.path // .file_path // empty')
+
+  if [ "$phase" = "coding" ] && [ -n "$file_path" ]; then
+    # 编辑 tasks.md → 不提醒（这是正确的行为）
+    if echo "$file_path" | grep -q "tasks.md"; then
+      echo '{}'
+      exit 0
+    fi
+
+    # 编辑代码文件 → 提醒（Orchestrator 不应该直接编辑）
+    if echo "$file_path" | grep -qE '\.(ts|tsx|js|jsx|py|go|rs)$'; then
+      reminder="🔔 **[Pipeline] 检测到直接编辑代码文件**\n"
+      reminder+="- 文件: $(basename "$file_path")\n"
+      reminder+="- 编码应通过子 Agent 完成，而非直接编辑\n"
+      reminder+="- 如果这是 Orchestrator 的错误行为，请改用 Task 工具启动对应子 Agent"
+
+      escaped=$(echo -e "$reminder" | jq -Rs '.')
+      cat << EOF
+{
+  "additional_context": ${escaped}
+}
+EOF
+      exit 0
+    fi
+  fi
+fi
+
+# ---- Shell 执行后检查 Gate ----
+if [ "$tool_name" = "Shell" ]; then
+  command=$(echo "$tool_input" | jq -r '.command // empty')
+
+  # 如果是执行 gate 脚本 → 不提醒
+  if echo "$command" | grep -q "specline-pipeline-gate.sh"; then
+    echo '{}'
+    exit 0
+  fi
+fi
+
+# 默认：无提醒
+echo '{}'
+exit 0