team-skills 1.1.0 → 1.1.2

package/.claude/commands/team-setup.md

@@ -1,183 +1,65 @@
 ---
-description: 将当前仓库的 skills 和 commands 安装到指定目录（默认 ~/.agents/skills），含 _team-rules/ 共享规则
+description: 安装 team-skills 的 Skills、斜杠命令和 Hooks 到全局目录
 argument-hint: [target-dir]
 ---
 
-# /team-setup — Skills 安装命令
+# /team-setup — Skills 全局安装
 
 ## 功能
 
-将本仓库的所有内容软链接到目标目录，使 Claude Code 和 Cursor 都能发现并使用，且后续通过 `/team-pull` 即可同步更新。
+将 team-skills 的所有组件以 symlink 方式安装到全局目录，使 Claude Code 和 Cursor 都能发现并使用。
 
-安装内容：
+## 安装内容
 
-- `skills/*` → `{target-dir}/`（Agent Skills，含 using-team-skills meta-skill）
-- `skills/_team-rules/*` → `{target-dir}/_team-rules/`（共享规则文件，被所有 Skill 引用）
-- `.claude/commands/*` → `{target-dir}/{name}/SKILL.md`（Commands 也作为 Skill 安装，Cursor 可发现）
-- `.claude/commands/*` → `~/.claude/commands/`（兼容 Claude Code 斜杠命令）
-- `hooks/hooks.json` → Cursor/Claude Code hooks 目录（可选，用于 session-start 注入）
+| 组件 | 目标位置 | 说明 |
+|------|----------|------|
+| Agent Skills | `~/.agents/skills/{name}` | Cursor 自动发现 |
+| Skill 斜杠命令 | `~/.claude/commands/{name}.md` | Claude Code `/team-{name}` |
+| 共享规则 | `~/.agents/skills/_team-rules/` | 被所有 Skill 引用 |
+| CLI 辅助命令 | 两端均安装 | team-setup/uninstall/pull/push |
+| Hooks（可选） | `~/.cursor/hooks/` | session-start 自动加载 |
 
-## 参数
-
-- `$1`（可选）：目标目录，默认为 `~/.agents/skills`
-
-## 执行步骤
-
-### 1. 确定目标目录
-
-```bash
-set -euo pipefail
-TARGET="${1:-$HOME/.agents/skills}"
-REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "$(cd "$(dirname "$0")/../.." && pwd)")"
-mkdir -p "$TARGET"
-echo "目标目录: $TARGET"
-echo "仓库根目录: $REPO_ROOT"
-```
-
-### 2. 安装 Agent Skills
-
-对本仓库 `skills/` 下的每个子目录（排除 `_team-rules` 和 `CLAUDE.md`），在目标目录下创建同名软链接。
+## 使用方式
 
 ```bash
-for dir in "$REPO_ROOT/skills"/*/; do
-  name="$(basename "$dir")"
-  # 跳过 _team-rules（单独处理）
-  [ "$name" = "_team-rules" ] && continue
-  ln -sfn "$dir" "$TARGET/$name"
-  echo "  ✅ Skill: $name → $TARGET/$name"
-done
-```
+# 基本安装
+team-skills setup
 
-### 3. 安装共享规则（_team-rules）
+# 含可选的 team-score 评分 Skill
+team-skills setup --with-score
 
-```bash
-mkdir -p "$TARGET/_team-rules"
-for f in "$REPO_ROOT/skills/_team-rules"/*; do
-  [ -f "$f" ] || continue
-  ln -sf "$f" "$TARGET/_team-rules/$(basename "$f")"
-  echo "  ✅ Rule: $(basename "$f")"
-done
-```
+# 覆盖已有安装
+team-skills setup --force
 
-### 4. 安装 Commands（作为 Skill，供 Cursor 发现）
+# 跳过 Hooks
+team-skills setup --no-hooks
 
-对本仓库 `.claude/commands/` 下的每个 `.md` 文件，在目标目录下创建 `{name}/SKILL.md` 软链接。
+# 预览不执行
+team-skills setup --dry-run
 
-```bash
-for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
-  [ -f "$cmd" ] || continue
-  name="$(basename "$cmd" .md)"
-  # 跳过已作为 Skill 安装的同名目录，避免写入跟随 symlink
-  if [ -L "$TARGET/$name" ]; then
-    echo "  ⚠️  Command Skill $name 跳过：已存在同名 Skill 目录"
-    continue
-  fi
-  mkdir -p "$TARGET/$name"
-  ln -sf "$cmd" "$TARGET/$name/SKILL.md"
-  echo "  ✅ Command Skill: $name → $TARGET/$name/SKILL.md"
-done
+# 指定目标目录（默认 ~/.agents/skills）
+team-skills setup /path/to/target
 ```
 
-### 5. 安装 Commands（兼容 Claude Code 斜杠命令）
+## 选项
 
-```bash
-mkdir -p "$HOME/.claude/commands"
-for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
-  [ -f "$cmd" ] || continue
-  name="$(basename "$cmd")"
-  ln -sf "$cmd" "$HOME/.claude/commands/$name"
-  echo "  ✅ Claude Command: $name → $HOME/.claude/commands/$name"
-done
-```
+| 选项 | 说明 |
+|------|------|
+| `--with-score` | 包含 team-score Skill（默认隐藏） |
+| `--no-hooks` | 跳过 Hooks 安装 |
+| `--force` | 覆盖已有的 symlink 和文件 |
+| `--dry-run` | 只显示操作，不实际执行 |
 
-### 6. 安装 Hooks（可选）
+## 验证
 
-如果目标平台支持 hooks（Cursor / Claude Code），将 `hooks/hooks.json` 和 `hooks/session-start` 安装到对应平台的 hooks 目录。
+安装后会自动验证每个 symlink 是否正确创建。也可手动检查：
 
 ```bash
-install_hooks() {
-  local hook_dir="$1"
-  local platform="$2"
-  mkdir -p "$hook_dir"
-  if [ -f "$REPO_ROOT/hooks/hooks.json" ]; then
-    ln -sf "$REPO_ROOT/hooks/hooks.json" "$hook_dir/hooks.json"
-    echo "  ✅ ${platform} hooks.json"
-  fi
-  if [ -f "$REPO_ROOT/hooks/session-start" ]; then
-    ln -sf "$REPO_ROOT/hooks/session-start" "$hook_dir/session-start"
-    chmod +x "$hook_dir/session-start" 2>/dev/null || true
-    echo "  ✅ ${platform} session-start"
-  fi
-}
-
-# Cursor hooks
-install_hooks "$HOME/.cursor/hooks" "Cursor"
-# Claude Code hooks
-install_hooks "$HOME/.claude/hooks" "Claude Code"
+team-skills list
 ```
 
-## 验证
+## 卸载
 
 ```bash
-echo ""
-echo "=== 验证安装 ==="
-
-# 确认每个 Agent Skill 目录是软链接
-errors=0
-for dir in "$REPO_ROOT/skills"/*/; do
-  name="$(basename "$dir")"
-  [ "$name" = "_team-rules" ] && continue
-  if [ -L "$TARGET/$name" ] && [ -d "$TARGET/$name" ]; then
-    echo "  ✅ $name → $(readlink "$TARGET/$name")"
-  else
-    echo "  ❌ $name 未正确安装"
-    errors=$((errors + 1))
-  fi
-done
-
-# 确认 _team-rules 规则文件
-for f in "$REPO_ROOT/skills/_team-rules"/*; do
-  [ -f "$f" ] || continue
-  name="$(basename "$f")"
-  if [ -L "$TARGET/_team-rules/$name" ]; then
-    echo "  ✅ _team-rules/$name → $(readlink "$TARGET/_team-rules/$name")"
-  else
-    echo "  ❌ _team-rules/$name 未正确安装"
-    errors=$((errors + 1))
-  fi
-done
-
-# 确认 Command Skills
-for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
-  [ -f "$cmd" ] || continue
-  name="$(basename "$cmd" .md)"
-  if [ -L "$TARGET/$name/SKILL.md" ]; then
-    echo "  ✅ Command Skill $name → $(readlink "$TARGET/$name/SKILL.md")"
-  else
-    echo "  ❌ Command Skill $name 未正确安装"
-    errors=$((errors + 1))
-  fi
-done
-
-# 确认 Claude Code 命令
-for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
-  [ -f "$cmd" ] || continue
-  name="$(basename "$cmd")"
-  if [ -L "$HOME/.claude/commands/$name" ]; then
-    echo "  ✅ Claude Command $name → $(readlink "$HOME/.claude/commands/$name")"
-  else
-    echo "  ❌ Claude Command $name 未正确安装"
-    errors=$((errors + 1))
-  fi
-done
-
-if [ "$errors" -eq 0 ]; then
-  echo ""
-  echo "🎉 安装完成！所有组件已正确安装。"
-  echo ""
-  echo "后续可通过 /team-pull 拉取更新。"
-else
-  echo ""
-  echo "⚠️  有 $errors 个组件安装异常，请检查。"
-fi
+team-skills uninstall
 ```

package/.claude/commands/team-uninstall.md

@@ -1,5 +1,5 @@
 ---
-description: 卸载 team-skills 的所有 symlink（Skills、Commands、Hooks）
+description: 卸载 team-skills 的所有 symlink（Skills、斜杠命令、Hooks）
 argument-hint: [target-dir]
 ---
 
@@ -7,101 +7,47 @@ argument-hint: [target-dir]
 
 ## 功能
 
-移除 `/team-setup` 创建的所有软链接，不影响本仓库源文件。
+移除 `team-skills setup` 创建的所有软链接，不影响源文件。
 
-## 参数
+## 移除内容
 
-- `$1`（可选）：目标目录，默认为 `~/.agents/skills`
+| 组件 | 位置 |
+|------|------|
+| Cursor Skills | `~/.agents/skills/team-*` |
+| Claude Code Skill 斜杠命令 | `~/.claude/commands/team-*.md` |
+| 共享规则 | `~/.agents/skills/_team-rules/` |
+| CLI 辅助命令 | 两端均移除 |
+| Hooks | `~/.cursor/hooks/`、`~/.claude/hooks/` |
 
-## 执行步骤
-
-### 1. 确定目标目录
+## 使用方式
 
 ```bash
-set -euo pipefail
-TARGET="${1:-$HOME/.agents/skills}"
-REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "$(cd "$(dirname "$0")/../.." && pwd)")"
-echo "卸载来源: $REPO_ROOT"
-echo "目标目录: $TARGET"
-removed=0
-```
+# 完整卸载
+team-skills uninstall
 
-### 2. 移除 Agent Skills
+# 保留 Hooks
+team-skills uninstall --no-hooks
 
-```bash
-for dir in "$REPO_ROOT/skills"/*/; do
-  name="$(basename "$dir")"
-  [ "$name" = "_team-rules" ] && continue
-  if [ -L "$TARGET/$name" ]; then
-    rm "$TARGET/$name"
-    echo "  🗑️ Skill: $name"
-    removed=$((removed + 1))
-  fi
-done
-```
+# 保留 CLI 辅助命令
+team-skills uninstall --no-commands
 
-### 3. 移除共享规则
+# 预览不执行
+team-skills uninstall --dry-run
 
-```bash
-for f in "$REPO_ROOT/skills/_team-rules"/*; do
-  [ -f "$f" ] || continue
-  name="$(basename "$f")"
-  if [ -L "$TARGET/_team-rules/$name" ]; then
-    rm "$TARGET/_team-rules/$name"
-    echo "  🗑️ Rule: $name"
-    removed=$((removed + 1))
-  fi
-done
-rmdir "$TARGET/_team-rules" 2>/dev/null || true
+# 指定目标目录
+team-skills uninstall /path/to/target
 ```
 
-### 4. 移除 Command Skills
+## 选项
 
-```bash
-for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
-  [ -f "$cmd" ] || continue
-  name="$(basename "$cmd" .md)"
-  if [ -L "$TARGET/$name/SKILL.md" ]; then
-    rm "$TARGET/$name/SKILL.md"
-    rmdir "$TARGET/$name" 2>/dev/null || true
-    echo "  🗑️ Command Skill: $name"
-    removed=$((removed + 1))
-  fi
-done
-```
+| 选项 | 说明 |
+|------|------|
+| `--no-hooks` | 跳过移除 Hooks |
+| `--no-commands` | 跳过移除 CLI 辅助命令 |
+| `--dry-run` | 只显示操作，不实际执行 |
 
-### 5. 移除 Claude Code 命令
+## 安全机制
 
-```bash
-for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
-  [ -f "$cmd" ] || continue
-  name="$(basename "$cmd")"
-  if [ -L "$HOME/.claude/commands/$name" ]; then
-    rm "$HOME/.claude/commands/$name"
-    echo "  🗑️ Claude Command: $name"
-    removed=$((removed + 1))
-  fi
-done
-```
-
-### 6. 移除 Hooks
-
-```bash
-for hook_dir in "$HOME/.cursor/hooks" "$HOME/.claude/hooks"; do
-  for f in hooks.json session-start; do
-    if [ -L "$hook_dir/$f" ]; then
-      rm "$hook_dir/$f"
-      echo "  🗑️ Hook: $hook_dir/$f"
-      removed=$((removed + 1))
-    fi
-  done
-done
-```
-
-### 7. 汇报
-
-```bash
-echo ""
-echo "✅ 卸载完成，共移除 $removed 个软链接。"
-echo "本仓库源文件未受影响。"
-```
+- 只移除指向 team-skills 源文件的 symlink
+- 指向其他来源的同名 symlink 会跳过（标记为 `foreign`）
+- 非 symlink 文件不会被删除

package/CHANGELOG.md

@@ -5,6 +5,67 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 本项目遵循[语义化版本](https://semver.org/lang/zh-CN/spec/v2.0.0.html)。
 
+## [1.1.2] - 2026-06-23
+
+### 变更
+
+- 所有 Skill 的项目规范引用从 `CLAUDE.md` 扩展为 `CLAUDE.md / .cursor/rules/`，支持 Cursor 项目
+- `.claude/commands/team-setup.md` 和 `team-uninstall.md` 重写为 Node.js CLI 文档（原为过时的 bash 脚本）
+- CHANGELOG.md 补齐 1.x 版本记录
+
+### 修复
+
+- hooks.json 仅安装到 Cursor hooks 目录（不再错误安装到 Claude Code）
+- `cleanStaleSkills` 仅清理 `team-*` 前缀目录（保护用户自定义 Skill）
+- `list` 命令 hooks.json 仅显示在 Cursor 下
+- README/CHANGELOG 与代码实现对齐
+
+## [1.1.1] - 2026-06-23
+
+### 新增
+
+- `setup` 为所有 Skill 创建 Claude Code 斜杠命令（`~/.claude/commands/{name}.md`）
+- `init` 支持 Claude Code：将 SKILL.md 复制为斜杠命令
+- `update` 支持 Claude Code 命令更新 + 过时命令清理
+- `uninstall` 移除 Claude Code Skill 斜杠命令
+- `list` 新增 "Claude Code Skill 斜杠命令" 独立展示区
+
+### 修复
+
+- P0: `--force` 处理目录时使用 `rmSync` 替代 `unlinkSync`
+- P0: `update.js` 修复 shell 注入（`readFileSync` 替代 `execSync`）
+- P0: `JSON.parse("1.1.0")` 崩溃修复
+
+### 变更
+
+- `skills/CLAUDE.md` 合并到根目录 `CLAUDE.md` §十三（SKILL.md 开发规范）
+
+## [1.1.0] - 2026-06-22
+
+### 新增
+
+- Node.js CLI 工具（`bin/team-skills.js`），取代原有 bash 脚本
+- 5 个命令：`setup`、`init`、`update`、`uninstall`、`list`
+- `--ide` 选项：强制指定目标 IDE（claude/cursor/both）
+- `--with-score` 选项：可选安装 team-score Skill
+- `--dry-run` 选项：所有命令均支持
+- `detectIDE` 共享模块：自动检测项目 IDE 类型
+- `check-skill-structure.js` CI 检查脚本
+- npm 发布配置（`package.json` 的 `files`、`bin`、`engines`）
+- GitHub Actions release workflow：`v*` tag 自动发布到 npm
+
+### 变更
+
+- `team-score` 默认不安装，需 `--with-score` 显式启用
+- 从其他 Skill 中移除 team-score 硬编码引用
+- CI 简化为 npm scripts 驱动
+
+### 移除
+
+- Makefile（功能迁移到 npm scripts）
+- `src/lib/manifest.js`（不再需要）
+- `rules/` 目录（开发规范已合并到 CLAUDE.md）
+
 ## [0.2.0] - 2026-06-22
 
 ### 新增

package/README.md

@@ -77,6 +77,12 @@ npx team-skills@latest setup
 
 自动将 Skills、斜杠命令和 Hooks 以 symlink 方式安装到全局目录。
 
+启用可选的项目评分功能（`team-score`）：
+
+```bash
+npx team-skills@latest setup --with-score
+```
+
 如需频繁使用 CLI，可全局安装：
 
 ```bash
@@ -90,21 +96,26 @@ team-skills setup
 
 ```bash
 npx team-skills@latest init
+# 含评分功能
+npx team-skills@latest init --with-score
 ```
 
-创建 `.team-skills/` 目录，包含 Skills、Hooks 和命令文件。后续更新：
+自动检测项目中的 `.claude/` 和 `.cursor/` 目录，将对应文件复制到 IDE 能发现的位置。后续更新：
 
 ```bash
 npx team-skills@latest update
 ```
 
+> **提示**：Hooks 仅在全局安装（`setup`）模式下生效，`init` 不安装 hooks。
+
 ### 安装内容
 
 | 内容 | 位置 | 说明 |
 |------|------|------|
-| 12 个 Agent Skills | `~/.agents/skills/` | Cursor 自动发现 |
-| 斜杠命令 | `~/.claude/commands/` | Claude Code `/team-{name}` |
+| 11 个 Agent Skills | `~/.agents/skills/` | Cursor 自动发现 |
+| 11 个 Skill 斜杠命令 | `~/.claude/commands/` | Claude Code `/team-{name}` |
 | 共享规则 | `~/.agents/skills/_team-rules/` | 被所有 Skill 引用 |
+| CLI 辅助命令 | 两端均安装 | team-setup/uninstall/pull/push |
 | Hooks（可选） | `~/.cursor/hooks/` | session-start 自动加载 |
 
 ### 验证
@@ -116,13 +127,13 @@ npx team-skills@latest update
 
 ### CLI 参考
 
-| 命令 | 说明 |
-|------|------|
-| `team-skills setup` | symlink 安装到全局目录 |
-| `team-skills init [dir]` | 复制到项目目录 |
-| `team-skills update [dir]` | 增量更新项目副本 |
-| `team-skills uninstall` | 移除所有 symlink |
-| `team-skills list` | 查看安装状态 |
+| 命令 | 说明 | 关键选项 |
+|------|------|----------|
+| `team-skills setup` | symlink 安装到全局目录 | `--with-score` `--no-hooks` `--force` |
+| `team-skills init [dir]` | 复制到项目 IDE 目录 | `--ide <claude\|cursor\|both>` `--with-score` |
+| `team-skills update [dir]` | 升级包 + 更新项目副本 | `--skip-self` `--ide` `--with-score` |
+| `team-skills uninstall` | 移除所有全局 symlink | `--no-hooks` `--no-commands` |
+| `team-skills list` | 查看全局安装状态 | `--json` |
 
 所有命令支持 `--dry-run`。
 

package/examples/debugging.md

@@ -0,0 +1,63 @@
+# 示例：使用 team-debug 进行调试
+
+本示例展示 `team-debug` 如何系统性地定位根因。
+
+## 问题描述
+
+用户报告："登录接口间歇性返回 500 错误。"
+
+## 第一步：收集证据
+
+```bash
+/team-debug 登录接口间歇性 500 错误
+```
+
+调试 Agent 开始收集：
+
+- 过去一小时的错误日志
+- 请求/响应模式
+- 最近的代码变更
+- 依赖版本
+
+## 第二步：生成假设
+
+```
+H1：数据库连接池耗尽
+H2：会话创建时的竞态条件
+H3：认证中间件内存泄漏
+H4：第三方限流
+```
+
+## 第三步：判别性验证
+
+每个假设通过特定实验验证：
+
+| 假设 | 实验 | 结果 |
+|------|------|------|
+| H1：连接池耗尽 | 检查 max_connections vs 活跃连接数 | ❌ 活跃连接 < 连接池 50% |
+| H2：竞态条件 | 在会话创建前后增加日志 | ✅ 两个并发请求创建了重复会话 |
+| H3：内存泄漏 | 监控认证前后的堆内存 | ❌ 无明显变化 |
+| H4：第三方限流 | 检查第三方 API 响应码 | ❌ 无 429 响应 |
+
+## 第四步：找到根因
+
+**竞态条件**：当两个登录请求同时到达同一个新用户时，两个请求都通过了"用户是否存在"检查，然后都尝试创建会话。第二个请求因为第一个已创建而失败。
+
+## 第五步：修复
+
+```python
+# 修复前（存在竞态条件）
+if not user.has_session():
+    user.create_session()
+
+# 修复后（原子操作）
+user.create_session_if_not_exists()  # 数据库级别的原子操作
+```
+
+## 第六步：验证
+
+```bash
+# 运行模拟并发登录的测试
+pytest tests/test_login_concurrent.py -v
+# ✅ 所有测试通过
+```

package/examples/failure-paths.md

@@ -0,0 +1,124 @@
+# 失败路径示例：回退、H3 介入与 Kill Switch
+
+真实项目不会总走 happy path。本指南展示 Team Skills 在遇到问题时如何处理。
+
+## 场景 1：testAgent 发现 bug → 回退 implAgent
+
+```
+用户: /team-orchestrator 实现金额计算功能
+
+[H1 确认通过]
+[specAgent 产出 01-05 文件]
+[H2 确认通过]
+[implAgent 完成 TDD 开发]
+
+testAgent:
+  发现 bug：边界条件未处理 — 当金额为 0 时，计算返回 NaN 而非 0
+  路由决策：→ implAgent
+
+编排器:
+  回退计数：test→impl = 1（上限 2）
+  传递上下文：
+    - 问题：金额为 0 时返回 NaN
+    - 复现步骤：calculateAmount(0) → NaN
+    - 期望行为：calculateAmount(0) → 0（SDD §七 B3）
+    - 建议方向：添加零值边界检查
+
+implAgent（第二次）:
+  1. RED: 写测试 expect(calculateAmount(0)).toBe(0) → 失败 ✓
+  2. GREEN: 添加零值检查 → 通过 ✓
+  3. REFACTOR: 无需重构
+  git commit -m "fix: handle zero amount edge case"
+
+testAgent（第二次）:
+  全部通过 → reviewAgent
+```
+
+## 场景 2：reviewAgent 发现 spec 遗漏 → 回退 specAgent
+
+```
+reviewAgent:
+  Phase 1.5 Constitutional 合规检查：
+    发现 03-sdd.md 未定义并发场景 — 两个用户同时修改同一记录
+    严重级别：P1（spec 遗漏）
+  路由决策：→ specAgent
+
+编排器:
+  回退计数：review→spec = 1（上限 2）
+  传递上下文：
+    - 问题：并发修改场景未定义
+    - 发现位置：11-review.md §一 正确性审查
+    - 期望补充：03-sdd.md §七 添加并发边界条件
+    - 建议方向：乐观锁 vs 悲观锁
+
+specAgent（第二次）:
+  更新 03-sdd.md：
+    §七 新增 B5：并发修改 — 使用乐观锁，版本号冲突返回 409
+  更新 04-boundary.md：新增并发约束
+
+[重新走 impl → test → review]
+```
+
+## 场景 3：回退超限 → 触发 H3
+
+```
+testAgent 发现 bug → 回退 implAgent（计数 1）
+implAgent 修复后 → testAgent 又发现新 bug → 回退 implAgent（计数 2）
+implAgent 再次修复 → testAgent 又发现 bug
+
+编排器:
+  回退计数 test→impl = 3 → 超过上限（≤ 2）
+  强制触发 H3！
+
+H3 人类介入请求:
+  触发来源：testAgent | 触发原因：回退超限
+  问题描述：test→impl 已回退 3 次，可能存在架构问题
+  已尝试：
+    - 第 1 次：修复零值边界
+    - 第 2 次：修复类型转换
+    - 第 3 次：又发现精度丢失
+  选项：
+    - A: 重新审视 SDD 架构方案（回退 specAgent）
+    - B: 人类直接介入修复
+    - C: Kill Switch — 终止任务
+  推荐：A — 反复出现的计算问题暗示底层数据类型选择有误
+
+用户选择 A → 编排器回退到 specAgent，传递三次失败的完整上下文
+```
+
+## 场景 4：Kill Switch 激活
+
+```
+implAgent Phase 0.5（审计同步）:
+  发现：spec 要求调用第三方支付 API，但该 API 文档标注 deprecated，
+  将于下月下线。方案不可行。
+
+编排器:
+  触发 Kill Switch → H3
+
+H3 人类介入请求:
+  触发来源：implAgent | 触发原因：Kill Switch
+  问题描述：第三方支付 API 已标记 deprecated，下月下线，SDD 方案不可行
+  选项：
+    - A: 回退 specAgent，改用新版 API 重新设计
+    - B: 回退 specAgent，改用其他支付服务商
+    - C: Kill Switch — 终止任务，等 API 迁移完成后再启动
+  推荐：A — 新版 API 已上线且接口兼容性好
+
+用户选择 C → 任务终止
+进度账本记录：0005-payment | KILLED | 原因：第三方 API deprecated
+```
+
+## 场景 5：BLOCKED 状态
+
+```
+specAgent:
+  Phase 1 探索：需要读取数据库 schema，但没有数据库访问权限
+  状态：BLOCKED
+  阻塞原因：无法访问 production DB schema
+  需要：DBA 提供 schema dump 或只读访问
+
+编排器:
+  触发 H3
+  用户提供 schema.sql → specAgent 继续
+```