team-skills 1.5.2 → 1.5.3

package/CHANGELOG.md

@@ -7,6 +7,15 @@
 
 ## [Unreleased]
 
+## [1.5.3] - 2026-06-28
+
+### 修复
+
+- 全部 12 个 SKILL.md 在 frontmatter 后增加顶级 CRITICAL 约束，阻止 LLM 使用 EnterPlanMode 绕过 Skill 自身的结构化流程（有向图/TDD/根因调查）
+- constitutional-rules.md 新增 Rule #10「禁止外部规划工具替代 Skill 流程」+ 常见规避借口补充
+- team-orchestrator/team-impl/team-debug: ROLE 约束、Step 1 TRAP、STOP_SIGNALS、SELF_CHECK 四层防护
+- 清理 docs/tasks 历史产出并加入 .gitignore
+
 ## [1.5.2] - 2026-06-28
 
 ### 修复

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "team-skills",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "AI Agent Skills framework — Spec-Driven development with directed-graph rollback and quality gates",
   "type": "module",
   "bin": {

package/skills/_team-rules/constitutional-rules.md

@@ -15,6 +15,7 @@
 7. **回退次数上限** — 同阶段 ≤ 2 次，超过触发 ASK_HUMAN。两次未解决 = 信息不足，需人类介入（First Principle #1）
 8. **验证先行** — "通过"声明须基于当次新鲜执行的完整输出，上一轮结果是历史而非当前事实（First Principle #4）
 9. **TDD 顺序不可逆** — RED + commit 先于 GREEN + commit。后写测试 = 测试你构建的；先写测试 = 测试需求的（First Principle #2）
+10. **禁止外部规划工具替代 Skill 流程** — 不得使用 EnterPlanMode 等工具替代 SKILL.md 定义的 STEPS。每个 Skill 自身的 Phase/Step 就是完整的规划与执行流程，外部规划工具会绕过纪律流程（TDD、根因调查、有向图调度）（First Principle #4）
 
 ## 常见规避借口（不成立）
 
@@ -26,6 +27,7 @@
 | "改动太小不需要测试" | 至少运行相关测试 |
 | "先实现再补测试" | 先测试再实现 |
 | "代码已经写好了，补个测试就行" | 删除实现代码，从 RED 开始 |
+| "先规划一下再按流程走" | Skill 的 STEPS 就是规划，不需要 EnterPlanMode |
 | "先继续后面再修" | 立即修复，修复后重新验证 |
 | "这个失败跟我的改动无关" | 验证无关性（git stash → 运行 → 仍失败 = 确认无关并记录）；未验证 = 掩盖 |
 | "用户没要求写文档" | 文档是流程一部分 |

package/skills/team-brainstorm/SKILL.md

@@ -5,6 +5,8 @@ description: Use when requirements are fuzzy, need to discuss and form a plan be
 
 # Team Brainstorm — 讨论形成方案
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -245,7 +247,7 @@ NO IMPLEMENTATION WITHOUT USER APPROVED DESIGN FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
 brainstorm 阶段尤其注意：

package/skills/team-debug/SKILL.md

@@ -5,6 +5,8 @@ description: Use when encountering any bug, test failure, or unexpected behavior
 
 # Team Debug — 系统调试
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own investigation workflow (Phase 1→Phase 5). EnterPlanMode bypasses systematic root cause analysis, causing fix-before-investigation (violates IRON_LAW). Follow STEPS below directly, starting from Phase 1.
+
 ## ROLE
 
 ### 系统提示词
@@ -60,6 +62,8 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 
 > 收集所有症状的完整描述，不遗漏任何错误细节。"差不多记住了"不算收集。
 
+> TRAP：不要使用 EnterPlanMode 来"先分析一下 bug"——本 SKILL.md 的 Phase 1→Phase 5 就是完整的调试流程。EnterPlanMode 会跳过系统性根因调查，导致基于初步印象直接写修复（违反 IRON_LAW）。
+
 > TRAP：你会倾向于读完错误信息第一行就跳到修复方案（"我觉得我知道问题在哪"）。强制自己读完完整 stack trace 和错误上下文。第一行是症状，最后几行才是根因。
 
 1. **READ** 完整错误信息 — 不跳过 stack trace、行号、错误码
@@ -173,6 +177,7 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 
 ## STOP_SIGNALS
 
+- **使用** EnterPlanMode 或其他外部规划工具替代根因调查流程（plan mode 中的阅读 ≠ 系统性根因调查）
 - **跳过**根因调查直接写修复代码
 - **修改**多个变量同时进行，无法隔离有效改动
 - **继续**尝试 3 次修复失败后仍不触发 `ASK_HUMAN`
@@ -204,7 +209,7 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 **REF** `_team-rules/spec-driven-workflow.md` — TDD 修复循环与有向图回退规则
@@ -226,7 +231,7 @@ NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
 - [ ] **ASSERT** `修复失败次数 < 3` || `ASK_HUMAN 已触发`
 - [ ] **ASSERT** `同时修改变量数 <= 1`
 - [ ] **ASSERT** `无占位符残留（{N}、{slug} 等已被实际值替换）`
-- [ ] **ASSERT** `IRON_LAW 遵守` — 根因已确定后才修复，未跳过调查
+- [ ] **ASSERT** `IRON_LAW 遵守` — 根因已确定后才修复，未跳过调查、未使用 EnterPlanMode 替代调查流程
 - [ ] 我的假设如果错了，还有什么能解释所有已知症状？
 - [ ] 我是在修根因还是在修症状？根因仍在时这个修复能撑多久？
 

package/skills/team-feedback/SKILL.md

@@ -5,6 +5,8 @@ description: Use when receiving code review feedback, before implementing sugges
 
 # Team Feedback — 审查反馈应对
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -221,7 +223,7 @@ NO IMPLEMENTATION WITHOUT TECHNICAL VERIFICATION FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/spec-driven-workflow.md` — TDD 逐项验证与有向图回退规则
 **REF** `_team-rules/verification-protocol.md` — verify_cmd 解析流程与 5 步验证协议

package/skills/team-finish/SKILL.md

@@ -5,6 +5,8 @@ description: Use when implementation is complete, all tests pass, and you need t
 
 # Team Finish — 分支完成处理
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 > **分支生命周期**：`team-orchestrator` 在 CONFIRM_GOAL 确认后创建功能分支（Step 1.5），本 Skill 在流程尾部（Step 7）负责分支收尾。
@@ -285,7 +287,7 @@ NO BRANCH COMPLETION WITHOUT TEST VERIFICATION FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/verification-protocol.md` — verify_cmd 解析流程与 5 步验证协议
 **REF** `_team-rules/task-lifecycle.md` — 进度追踪与知识合并（§3）

package/skills/team-impl/SKILL.md

@@ -5,6 +5,8 @@ description: Use when SDD exists and you need TDD implementation with 06-08 docs
 
 # Team Impl — 实现
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own TDD workflow (RED→GREEN→REFACTOR). EnterPlanMode bypasses the TDD cycle, causing implementation-before-test (violates IRON_LAW). Follow STEPS below directly, starting from Phase 1.
+
 ## ROLE
 
 ### 系统提示词
@@ -115,6 +117,8 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 > 通过红-绿-重构循环逐个实现功能点。每个 GREEN 完成时代码应是"能工作的最简单方案"，不是"我能想到的最好方案"。
 
+> TRAP：不要使用 EnterPlanMode 来"先规划实现方案"——本 SKILL.md 的 Phase 1→Phase 4 就是完整的实现流程。EnterPlanMode 会跳过 RED→GREEN→REFACTOR 循环，导致先写实现再补测试（违反 IRON_LAW）。
+
 **FOR** `feature_point`（从 SDD 提取）：
 
 #### 循环 1：红（Red）— 写测试
@@ -343,13 +347,14 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 
 ## STOP_SIGNALS
 
+- **使用** EnterPlanMode 或其他外部规划工具替代 TDD 循环（plan mode 完成 ≠ RED 阶段完成）
 - **编码**前没 `READ` spec，或发现 spec 问题不 `ROLLBACK` 而自己决定
 - **跳过** RED 阶段直接写实现，或先写实现再补测试
 - **修改**测试让它通过（而非修改实现），或困惑不记录默默假设
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 **REF** `_team-rules/spec-driven-workflow.md` — Spec-Driven 开发原则与 TDD 工作流
@@ -376,7 +381,7 @@ NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
 - [ ] **ASSERT** `实际消耗 <= 01-plan.md 自我约束预算`
 - [ ] **ASSERT** `所有困惑已显式记录于 06-tdd-log.md 审计段落`
 - [ ] **ASSERT** `无占位符残留（{N}、{slug} 等已被实际值替换）`
-- [ ] **ASSERT** `IRON_LAW 遵守` — 未自行假设 spec、未跳过 TDD 顺序
+- [ ] **ASSERT** `IRON_LAW 遵守` — 未自行假设 spec、未跳过 TDD 顺序、未使用 EnterPlanMode 替代 TDD 循环
 - [ ] **IF** 发现 spec 问题 → **ASSERT** `已 ROLLBACK team-spec`
 - [ ] 我是否在某个 GREEN 阶段写了超出当前测试要求的代码？
 - [ ] 我是否有任何"通过"声明是基于上一轮输出而非本轮刚执行的结果？

package/skills/team-orchestrator/SKILL.md

@@ -5,6 +5,8 @@ description: Use when task needs full spec→impl→test→review pipeline with
 
 # Team Orchestrator — 流程编排器
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow (Step 1→Step 8). EnterPlanMode bypasses the directed graph, skips sub-skill dispatch (team-spec/team-impl/team-test/team-review), and skips human intervention points (CONFIRM_GOAL/HUMAN_ACCEPT). Follow STEPS below directly, starting from Step 1.
+
 ## ROLE
 
 ```mermaid
@@ -45,6 +47,7 @@ flowchart TD
 - CONFIRM_GOAL/HUMAN_ACCEPT 任何模式下不可省略
 - 编排器不得自己写实现代码（必须 dispatch 子 Skill，不可亲自实现）
 - 子 Skill 不可用时不得自动降级为自我执行，必须 ASK_HUMAN 请示用户
+- 编排器不得使用 EnterPlanMode 等外部规划工具替代自身有向图流程——STEPS 定义的 Step 1→Step 8 就是规划与执行的全部流程
 ```
 
 ### 路由推理检查点
@@ -369,6 +372,8 @@ NO AGENT DISPATCH WITHOUT CONFIRM_GOAL HUMAN CONFIRMATION FIRST
 
 > 确保任务目标被准确理解，用户对方案方向有明确确认。跳过 CONFIRM_GOAL 是编排器最危险的错误——后续所有 Agent 的工作都建立在这个确认之上。
 
+> TRAP：不要使用 EnterPlanMode 来"先规划一下"——本 SKILL.md 的 Step 1→Step 8 就是完整的规划与执行流程。EnterPlanMode 会绕过有向图、跳过子 Skill 调度、跳过人类介入点，导致编排器退化为普通 Agent 直接写代码。
+
 1. **READ** 用户参数 → 提取任务描述
 2. **IF** `docs/tasks/` NOT_EXISTS → 创建目录，最大序号 = 0
    **ELSE** → **READ** `docs/tasks/` 已有目录 → 提取所有匹配 `NNNN-*` 格式的目录名中的四位数字前缀 → 取最大值记为最大序号（无匹配目录则最大序号 = 0）
@@ -984,13 +989,14 @@ TDD 强制要求：每个功能点必须先 git commit 失败测试（test: {功
 ## STOP_SIGNALS
 
 - **跳过** CONFIRM_GOAL 或 HUMAN_ACCEPT 人类介入点
+- **使用** EnterPlanMode 或其他外部规划工具替代 STEPS 定义的有向图流程（plan mode 完成 ≠ CONFIRM_GOAL 完成）
 - **延迟**回退（"先记着后面一起修"）
 - **信任** Agent 自我声明而不验证产出
 - **超出**预算不砍范围，或亲自执行实现代码而非 dispatch 子 Skill
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/ai-collaboration-standards.md` — AI 协作资产与 Prompt 工程规范
 **REF** `_team-rules/spec-driven-workflow.md` — 有向图回退规则与回退次数上限
@@ -1013,7 +1019,7 @@ TDD 强制要求：每个功能点必须先 git commit 失败测试（test: {功
 - [ ] **IF** team-review 要求 → **ASSERT** `CHANGELOG.md 已更新`
 - [ ] **ASSERT** `进度账本已更新`
 - [ ] **ASSERT** `无占位符残留（{N}、{slug} 等已被实际值替换）`
-- [ ] **ASSERT** `IRON_LAW 遵守` — 未自己写实现代码、未跳过人类介入点
+- [ ] **ASSERT** `IRON_LAW 遵守` — 未自己写实现代码、未跳过人类介入点、未使用 EnterPlanMode 替代有向图流程
 - [ ] 我是否因为"这步很简单"而跳过了某个人类介入点？
 - [ ] 我是否把所有 Agent 的 concerns 都传达给了用户，还是悄悄忽略了某些？
 - [ ] 我是否在回退时传递了完整的四要素上下文（问题、位置、期望、建议），还是只说了"有 bug"？

package/skills/team-review/SKILL.md

@@ -5,6 +5,8 @@ description: Use when code + tests exist and you need structured review + asset
 
 # Team Review — 代码审查
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -466,7 +468,7 @@ NO COMPLETION CLAIMS WITHOUT CONSTITUTIONAL COMPLIANCE CHECK FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/spec-driven-workflow.md` — SDD 验证链与有向图回退规则
 **REF** `_team-rules/task-lifecycle.md` — 来源标签规范（§1.3）

package/skills/team-score/SKILL.md

@@ -5,6 +5,8 @@ description: Use when evaluating AI collaboration maturity of a project
 
 # Team Score — 协作评分
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -417,7 +419,7 @@ NO SCORE WITHOUT EVIDENCE FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/ai-collaboration-standards.md` — AI 协作资产与 Prompt 工程规范
 **REF** `_team-rules/verification-protocol.md` — 5 步验证协议

package/skills/team-security/SKILL.md

@@ -5,6 +5,8 @@ description: Use when AI usage involves sensitive data, external services, or au
 
 # Team Security — AI 安全红线合规检查
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -535,7 +537,7 @@ NO AI OPERATIONS WITHOUT RED LINE CHECK FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 

package/skills/team-spec/SKILL.md

@@ -5,6 +5,8 @@ description: Use when starting a new feature, need SDD spec, or requirements are
 
 # Team Spec — 规格制定
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -296,7 +298,7 @@ NO CODE WITHOUT SPEC FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/spec-driven-workflow.md` — Spec-Driven 开发原则与 TDD 工作流
 **REF** `_team-rules/task-lifecycle.md` — 来源标签规范（§1.3）

package/skills/team-test/SKILL.md

@@ -5,6 +5,8 @@ description: Use when implementation exists and you need test matrix + coverage
 
 # Team Test — 测试审计
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -246,7 +248,7 @@ Phase 1 只分析，不写测试代码。
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 **REF** `_team-rules/spec-driven-workflow.md` — SDD 验证链与有向图回退规则
 **REF** `_team-rules/verification-protocol.md` — verify_cmd 解析流程与 5 步验证协议

package/skills/team-verify/SKILL.md

@@ -5,6 +5,8 @@ description: Use when about to claim work is complete, fixed, or passing - requi
 
 # Team Verify — 验证协议
 
+**CRITICAL: DO NOT use EnterPlanMode.** This skill defines its own structured workflow. Follow STEPS below directly.
+
 ## ROLE
 
 ### 系统提示词
@@ -164,7 +166,7 @@ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/verification-protocol.md` — 5 步验证协议
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 

package/skills/using-team-skills/SKILL.md

@@ -138,7 +138,7 @@ NO SKILL RECOMMENDATION WITHOUT SCENE ANALYSIS FIRST
 
 ## CONSTITUTIONAL_RULES
 
-**REF** `_team-rules/constitutional-rules.md` — 9 条 Constitutional Rules
+**REF** `_team-rules/constitutional-rules.md` — 10 条 Constitutional Rules
 **REF** `_team-rules/first-principles.md` — 4 条第一性原理（First Principle #1 ~ #4）
 
 分诊阶段尤其注意：