@devflow-tools/claude-code-plugin 0.12.5 → 0.13.0

package/dist/skills/devflow:nextjs/SKILL.md

@@ -2,13 +2,13 @@
 name: devflow:nextjs
 description: Next.js 专家 — App Router、SSR/SSG/ISR、Server Components、Middleware、部署
 required_mcp_tools:
-  - nextjs_new_page
   - nextjs_diagnose_bug
+  - nextjs_new_page
 ---
 
 <HARD-GATE>
 收到 devflow:nextjs 时，必须先调用以下 MCP 工具之一：
-nextjs_new_page / nextjs_diagnose_bug
+nextjs_diagnose_bug / nextjs_new_page
 </HARD-GATE>
 
 ## MANDATORY FIRST STEP - Skill Registration
@@ -16,12 +16,12 @@ nextjs_new_page / nextjs_diagnose_bug
 > **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
 
 ```bash
-mkdir -p ~/.devflow && echo '{"name":"devflow:nextjs","required_mcp_tools":["nextjs_new_page","nextjs_diagnose_bug"],"description":"devflow:nextjs skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
+mkdir -p ~/.devflow && echo '{"name":"devflow:nextjs","required_mcp_tools":["nextjs_diagnose_bug","nextjs_new_page"],"description":"devflow:nextjs skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
 ```
 
 After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
-- `mcp__devflow__nextjs_new_page`
 - `mcp__devflow__nextjs_diagnose_bug`
+- `mcp__devflow__nextjs_new_page`
 
 **Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
 

package/dist/skills/devflow:react/SKILL.md

@@ -3,16 +3,16 @@ name: devflow:react
 description: React 18 专家能力 — Bug 诊断、组件重构、性能优化、Hooks 审查
 required_mcp_tools:
   - react_diagnose_bug
-  - react_new_feature
   - react_audit_performance
+  - react_new_component
   - react_review_hooks
   - react_refactor_component
-  - react_new_component
+  - react_new_feature
 ---
 
 <HARD-GATE>
 收到 devflow:react 时，必须先调用以下 MCP 工具之一：
-react_diagnose_bug / react_new_feature / react_audit_performance / react_review_hooks / react_refactor_component / react_new_component
+react_diagnose_bug / react_audit_performance / react_new_component / react_review_hooks / react_refactor_component / react_new_feature
 </HARD-GATE>
 
 ## MANDATORY FIRST STEP - Skill Registration
@@ -20,16 +20,16 @@ react_diagnose_bug / react_new_feature / react_audit_performance / react_review_
 > **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
 
 ```bash
-mkdir -p ~/.devflow && echo '{"name":"devflow:react","required_mcp_tools":["react_diagnose_bug","react_new_feature","react_audit_performance","react_review_hooks","react_refactor_component","react_new_component"],"description":"devflow:react skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
+mkdir -p ~/.devflow && echo '{"name":"devflow:react","required_mcp_tools":["react_diagnose_bug","react_audit_performance","react_new_component","react_review_hooks","react_refactor_component","react_new_feature"],"description":"devflow:react skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
 ```
 
 After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
 - `mcp__devflow__react_diagnose_bug`
-- `mcp__devflow__react_new_feature`
 - `mcp__devflow__react_audit_performance`
+- `mcp__devflow__react_new_component`
 - `mcp__devflow__react_review_hooks`
 - `mcp__devflow__react_refactor_component`
-- `mcp__devflow__react_new_component`
+- `mcp__devflow__react_new_feature`
 
 **Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
 

package/dist/skills/devflow:tailwind/SKILL.md

@@ -3,11 +3,12 @@ name: devflow:tailwind
 description: Tailwind 专家 — 响应式设计、主题定制、Purge 检查、Utility 审查
 required_mcp_tools:
   - tailwind_new_component
+  - tailwind_optimize_classes
 ---
 
 <HARD-GATE>
 收到 devflow:tailwind 时，必须先调用以下 MCP 工具之一：
-tailwind_new_component
+tailwind_new_component / tailwind_optimize_classes
 </HARD-GATE>
 
 ## MANDATORY FIRST STEP - Skill Registration
@@ -15,11 +16,12 @@ tailwind_new_component
 > **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
 
 ```bash
-mkdir -p ~/.devflow && echo '{"name":"devflow:tailwind","required_mcp_tools":["tailwind_new_component"],"description":"devflow:tailwind skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
+mkdir -p ~/.devflow && echo '{"name":"devflow:tailwind","required_mcp_tools":["tailwind_new_component","tailwind_optimize_classes"],"description":"devflow:tailwind skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
 ```
 
 After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
 - `mcp__devflow__tailwind_new_component`
+- `mcp__devflow__tailwind_optimize_classes`
 
 **Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
 

package/dist/skills/devflow:ui-layout/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: devflow:ui-layout
+description: UI Layout 专家 — 布局模式、组件组合、响应式架构、设计系统
+required_mcp_tools:
+  - ui_layout_generate
+---
+
+<HARD-GATE>
+收到 devflow:ui-layout 时，必须先调用以下 MCP 工具之一：
+ui_layout_generate
+</HARD-GATE>
+
+## MANDATORY FIRST STEP - Skill Registration
+
+> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
+
+```bash
+mkdir -p ~/.devflow && echo '{"name":"devflow:ui-layout","required_mcp_tools":["ui_layout_generate"],"description":"devflow:ui-layout skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
+```
+
+After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
+- `mcp__devflow__ui_layout_generate`
+
+**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
+
+When the skill execution is complete, clean up:
+```bash
+rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
+```
+
+# 📐 UI-LAYOUT
+
+你是一个 UI Layout 专家。精通 CSS Grid、Flexbox 和响应式设计。使用 Design Token 体系管理样式变量。
+
+## 适用场景
+
+**布局审计：一致性检查 → 响应式问题 → 可访问性评估**
+
+**响应式改造：断点分析 → 移动适配 → Container Queries**
+
+**Design Token 体系建设：提取 → 分层 → 代码化**
+
+## 核心规则
+
+- 优先使用 CSS Grid 做页面布局，Flexbox 做组件内排列
+- 使用容器查询实现组件级响应式
+- 间距遵循 4px 倍数的 Scale 体系
+- 使用语义化 HTML（header/nav/main/aside/footer）
+- 移动优先设计，渐进增强
+- 使用 CSS 变量管理 Design Token
+- 确保触控目标 ≥ 44×44px，对比度 ≥ 4.5:1
+
+## 当前版本
+
+- web-dev-layout: 2024 — https://web.dev/learn/design/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 布局审计：一致性检查 → 响应式问题 → 可访问性评估 | 调用 MCP 工具 `ui-layout_audit:layout` |
+| 响应式改造：断点分析 → 移动适配 → Container Queries | 调用 MCP 工具 `ui-layout_design:responsive` |
+| Design Token 体系建设：提取 → 分层 → 代码化 | 调用 MCP 工具 `ui-layout_setup:design-tokens` |

package/dist/skills/devflow:vue/SKILL.md

@@ -3,13 +3,13 @@ name: devflow:vue
 description: Vue 3 专家 — Bug 诊断、Composition API、响应式调试、组件重构
 required_mcp_tools:
   - vue_diagnose_bug
-  - vue_new_component
   - vue_debug_reactivity
+  - vue_new_component
 ---
 
 <HARD-GATE>
 收到 devflow:vue 时，必须先调用以下 MCP 工具之一：
-vue_diagnose_bug / vue_new_component / vue_debug_reactivity
+vue_diagnose_bug / vue_debug_reactivity / vue_new_component
 </HARD-GATE>
 
 ## MANDATORY FIRST STEP - Skill Registration
@@ -17,13 +17,13 @@ vue_diagnose_bug / vue_new_component / vue_debug_reactivity
 > **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
 
 ```bash
-mkdir -p ~/.devflow && echo '{"name":"devflow:vue","required_mcp_tools":["vue_diagnose_bug","vue_new_component","vue_debug_reactivity"],"description":"devflow:vue skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
+mkdir -p ~/.devflow && echo '{"name":"devflow:vue","required_mcp_tools":["vue_diagnose_bug","vue_debug_reactivity","vue_new_component"],"description":"devflow:vue skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
 ```
 
 After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
 - `mcp__devflow__vue_diagnose_bug`
-- `mcp__devflow__vue_new_component`
 - `mcp__devflow__vue_debug_reactivity`
+- `mcp__devflow__vue_new_component`
 
 **Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
 

package/hooks/post-tool-use

@@ -7,10 +7,14 @@ PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$SCRIPT_DIR/..}"
 CLIENT_JS="$PLUGIN_ROOT/dist/hooks/hook-client.js"
 FALLBACK_JS="$PLUGIN_ROOT/dist/hooks/post-tool-use.js"
 
+INPUT="$(cat)"
+
 if [ -f "$CLIENT_JS" ]; then
-  node "$CLIENT_JS" post-tool-use "$(cat)" 2>/dev/null || true
+  node "$CLIENT_JS" post-tool-use "$INPUT" 2>/dev/null || {
+    echo "$INPUT" | node "$FALLBACK_JS" 2>/dev/null || true
+  }
 elif [ -f "$FALLBACK_JS" ]; then
-  node "$FALLBACK_JS" 2>/dev/null || true
+  echo "$INPUT" | node "$FALLBACK_JS" 2>/dev/null || true
 fi
 
 exit 0

package/hooks/session-start

@@ -25,18 +25,6 @@ else
 fi
 
 # Generate session token for MCP Gateway authentication
-SESSION_TOKEN=""
-if command -v devflow &>/dev/null; then
-  SESSION_TOKEN=$(devflow session token --expires 3600 2>/dev/null || echo "")
-elif command -v npx &>/dev/null; then
-  SESSION_TOKEN=$(npx --yes @devflow-tools/cli session token --expires 3600 2>/dev/null || echo "")
-fi
-
-TOKEN_VALUE=""
-if [ -n "$SESSION_TOKEN" ] && echo "$SESSION_TOKEN" | python3 -c "import sys,json; json.load(sys.stdin)" 2>/dev/null; then
-  TOKEN_VALUE=$(echo "$SESSION_TOKEN" | python3 -c "import sys,json; print(json.load(sys.stdin).get('token',''))" 2>/dev/null || echo "")
-fi
-
 # Clean up stale receipt from previous session
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 RECEIPT_DIR="${TMPDIR:-/tmp}/.devflow-receipts"
@@ -116,20 +104,43 @@ else
 fi
 GATEWAY_STATUS="${GATEWAY_STATUS}━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-SUMMARY="${SUMMARY}${GLOBAL_CONSTRAINT}${GATEWAY_STATUS}"
+# ── MCP Tool Usage Protocol (injected into every session) ──
+MCP_PROTOCOL="
+
+## DevFlow MCP 工具使用协议（必须遵守）
+
+当用户使用 /devflow: 开头的技能时（如 /devflow:react、/devflow:vue、/devflow:context 等），你必须按以下流程操作：
+
+### Step 1: 获取上下文（必须先执行）
+调用 mcp__devflow__get_project_context，参数格式：{\"query\": \"用户的问题描述\"}
+这个工具返回项目中的相关文件、符号、风险提示和下一步建议。
+不要跳过这一步。不要用 Explore、Agent、Grep 或 Bash 代替。
+
+### Step 2: 按需调用领域工具
+根据技能类型调用对应的 MCP 工具：
+- React 性能问题 → mcp__devflow__react_audit_performance（无需参数）
+- React Bug → mcp__devflow__react_diagnose_bug
+- React Hooks 审查 → mcp__devflow__react_review_hooks
+- Vue 问题 → mcp__devflow__vue_diagnose_bug
+- NestJS 问题 → mcp__devflow__nest_diagnose_bug
+- 代码搜索 → mcp__devflow__search_symbol
+- 知识查询 → mcp__devflow__get_knowledge
+
+### Step 3: 基于工具返回结果进行分析
+用 Read 确认工具返回的关键文件，然后给出分析结论。
+
+### 铁律
+- 永远不要用 Explore、Agent、Grep 或 Glob 替代 MCP 工具的第一步上下文获取
+- 所有 mcp__devflow__ 工具的 projectRoot 参数都是可选的，无需传
+- 如果 MCP 工具返回错误，重试一次；再失败则回退到直接读文件"
+
+SUMMARY="${SUMMARY}${MCP_PROTOCOL}${GLOBAL_CONSTRAINT}${GATEWAY_STATUS}"
 
 # Escape for JSON
 ESCAPED=$(echo "$SUMMARY" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))")
 
-# Output context injection in Claude Code format
-if [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
-  if [ -n "$TOKEN_VALUE" ]; then
-    ESCAPED_TOKEN=$(echo "$TOKEN_VALUE" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))")
-    printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": %s\n  },\n  "env": {\n    "DEVFLOW_SESSION_TOKEN": %s\n  }\n}\n' "$ESCAPED" "$ESCAPED_TOKEN"
-  else
-    printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": %s\n  }\n}\n' "$ESCAPED"
-  fi
-fi
+# Output context injection in Claude Code format (always output, even without CLAUDE_PLUGIN_ROOT)
+printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": %s\n  }\n}\n' "$ESCAPED"
 
 # ── Start hook daemon (background, Unix socket) ──
 DAEMON_JS="${PLUGIN_ROOT}/dist/hooks/hook-daemon.js"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/claude-code-plugin",
-  "version": "0.12.5",
+  "version": "0.13.0",
   "description": "DevFlow — Developer Intelligence Platform for Claude Code",
   "type": "module",
   "scripts": {
@@ -8,7 +8,7 @@
     "deploy": "npx tsx scripts/inject-gates.ts --deploy"
   },
   "devDependencies": {
-    "@devflow-tools/mcp-server": "^0.12.5"
+    "@devflow-tools/mcp-server": "^0.13.0"
   },
   "keywords": [
     "pi-package",
@@ -28,5 +28,5 @@
     "hooks.json",
     "skills"
   ],
-  "gitHead": "e8440cff84139ca0cc1786ee39be3b453974e000"
+  "gitHead": "6e5878a1ab2bba3a21bd42a5f7e236d4f7375d4f"
 }

package/skills/devflow:animation/SKILL.md

@@ -3,6 +3,44 @@ name: devflow:animation
 description: Animation 动画专家 — CSS 动画、Framer Motion、GSAP、Lottie、性能优化
 ---
 
+## 工作流（必须按顺序执行）
+
+### Step 1: 获取精确上下文
+调用 `mcp__devflow__get_project_context` 获取与用户问题相关的代码、记忆和知识库信息。
+这一步确保你拿到的是项目真实状态，而非凭空猜测。
+
+### Step 2: 分析
+基于 Step 1 返回的上下文，分析问题根因或设计方案。
+此时可以自由使用 Read 查看具体文件。
+
+### Step 3: 执行
+根据分析结果修改代码，逐文件编辑。
+
+### Step 4: 验证
+运行类型检查和测试，确保改动正确。
+
+## 可用工具
+
+| 工具 | 何时调用 |
+|------|----------|
+| `mcp__devflow__get_project_context` | 每次任务第一步（必须） |
+| `mcp__devflow__animation_suggest` | 按需调用 |
+
+## 规则
+- 永远从 `mcp__devflow__get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `animation_suggest` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
 # ✨ ANIMATION
 
 你是一个动画专家。精通 CSS Animation、Framer Motion、GSAP。动画必须 60fps 且支持 prefers-reduced-motion。
@@ -29,10 +67,3 @@ description: Animation 动画专家 — CSS 动画、Framer Motion、GSAP、Lott
 
 - animation-docs: 2024 — https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_animations
 
-## 工作流
-
-| 场景 | 触发方式 |
-|------|----------|
-| 动画审计：性能检查 → 可访问性 → 实现质量 | 调用 MCP 工具 `animation_audit:animation` |
-| 新建动画：需求分析 → 选型建议 → 实现 → 性能验证 | 调用 MCP 工具 `animation_new:animation` |
-| 动画 GPU 迁移：扫描 → 替换为 GPU 属性 → 验证 | 调用 MCP 工具 `animation_migrate:gpu-animation` |

package/skills/devflow:context/SKILL.md

@@ -1,36 +1,53 @@
 ---
 name: devflow:context
 description: 检索项目上下文 — 自然语言查询相关代码、符号、依赖关系
-required_mcp_tools:
-  - get_project_context
-  - search_symbol
 ---
-## MANDATORY FIRST STEP - Skill Registration
 
-> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
+## 工作流（必须按顺序执行）
 
-```bash
-mkdir -p ~/.devflow && echo '{"name":"devflow:context","required_mcp_tools":["get_project_context","search_symbol"],"description":"devflow:context skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
-```
+### Step 1: 获取精确上下文
+调用 `mcp__devflow__get_project_context` 获取与用户问题相关的代码、记忆和知识库信息。
+这一步确保你拿到的是项目真实状态，而非凭空猜测。
 
-After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
-- `mcp__devflow__get_project_context`
-- `mcp__devflow__search_symbol`
+### Step 2: 分析
+基于 Step 1 返回的上下文，分析问题根因或设计方案。
+此时可以自由使用 Read 查看具体文件。
 
-**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
+### Step 3: 执行
+根据分析结果修改代码，逐文件编辑。
 
-When the skill execution is complete, clean up:
-```bash
-rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
-```
+### Step 4: 验证
+运行类型检查和测试，确保改动正确。
+
+## 可用工具
+
+| 工具 | 何时调用 |
+|------|----------|
+| `mcp__devflow__get_project_context` | 每次任务第一步（必须） |
+| `mcp__devflow__get_project_context` | 按需调用 |
+| `mcp__devflow__search_symbol` | 按需调用 |
 
+## 规则
+- 永远从 `mcp__devflow__get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
 
 # /devflow:context
 
 ## 执行
 
 1. 如果用户的查询包含中文，先将其中的中文关键词翻译为英文代码术语（空格分隔）
-2. 调用 `get_project_context` MCP 工具：
+2. 调用 `mcp__devflow__get_project_context` MCP 工具：
 
 ```
 query = 用户的原始查询内容（包含中文）
@@ -38,6 +55,8 @@ expandedTerms = 你翻译的英文关键词（如 "code review audit module"）
 mode = "fast"  (首次调用；如需更深入结果，再改用 "deep")
 ```
 
+也可以使用 `mcp__devflow__search_symbol` 按符号名搜索代码。
+
 示例：
 - 用户查询 "代码审核模块的流程" → expandedTerms = "code review audit module workflow pipeline process"
 - 用户查询 "用户登录认证逻辑" → expandedTerms = "user login authentication auth logic service handler"

package/skills/devflow:css/SKILL.md

@@ -3,6 +3,44 @@ name: devflow:css
 description: CSS 专家 — 布局调试、响应式审查、BEM 规范、性能优化
 ---
 
+## 工作流（必须按顺序执行）
+
+### Step 1: 获取精确上下文
+调用 `mcp__devflow__get_project_context` 获取与用户问题相关的代码、记忆和知识库信息。
+这一步确保你拿到的是项目真实状态，而非凭空猜测。
+
+### Step 2: 分析
+基于 Step 1 返回的上下文，分析问题根因或设计方案。
+此时可以自由使用 Read 查看具体文件。
+
+### Step 3: 执行
+根据分析结果修改代码，逐文件编辑。
+
+### Step 4: 验证
+运行类型检查和测试，确保改动正确。
+
+## 可用工具
+
+| 工具 | 何时调用 |
+|------|----------|
+| `mcp__devflow__get_project_context` | 每次任务第一步（必须） |
+| `mcp__devflow__css_audit_selectors` | 按需调用 |
+
+## 规则
+- 永远从 `mcp__devflow__get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `css_audit_selectors` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
 # 🎨 CSS
 
 你是一个 CSS 专家。使用现代布局方案（Flexbox/Grid），遵循 BEM 命名，移动优先响应式设计。遇到问题先查 MDN 文档。
@@ -29,10 +67,3 @@ description: CSS 专家 — 布局调试、响应式审查、BEM 规范、性能
 
 - mdn-css: 2024 — https://developer.mozilla.org/en-US/docs/Web/CSS
 
-## 工作流
-
-| 场景 | 触发方式 |
-|------|----------|
-| 布局调试：检查元素定位 → 弹性/网格属性 → 修复 | 调用 MCP 工具 `css_debug:layout` |
-| 响应式审查：断点检查 → 媒体查询 → 流体方案 | 调用 MCP 工具 `css_audit:responsive` |
-| BEM 命名审查：扫描类名 → 规范检查 → 修复建议 | 调用 MCP 工具 `css_review:bem` |

package/skills/devflow:docker/SKILL.md

@@ -3,6 +3,44 @@ name: devflow:docker
 description: Docker 专家 — 镜像优化、Compose 编排、安全扫描、多阶段构建
 ---
 
+## 工作流（必须按顺序执行）
+
+### Step 1: 获取精确上下文
+调用 `mcp__devflow__get_project_context` 获取与用户问题相关的代码、记忆和知识库信息。
+这一步确保你拿到的是项目真实状态，而非凭空猜测。
+
+### Step 2: 分析
+基于 Step 1 返回的上下文，分析问题根因或设计方案。
+此时可以自由使用 Read 查看具体文件。
+
+### Step 3: 执行
+根据分析结果修改代码，逐文件编辑。
+
+### Step 4: 验证
+运行类型检查和测试，确保改动正确。
+
+## 可用工具
+
+| 工具 | 何时调用 |
+|------|----------|
+| `mcp__devflow__get_project_context` | 每次任务第一步（必须） |
+| `mcp__devflow__docker_dockerize_project` | 按需调用 |
+
+## 规则
+- 永远从 `mcp__devflow__get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `docker_dockerize_project` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
 # 🐳 DOCKER
 
 你是一个 Docker 专家。使用多阶段构建优化镜像，遵循安全和性能最佳实践。遇到问题先查官方文档。
@@ -32,11 +70,3 @@ description: Docker 专家 — 镜像优化、Compose 编排、安全扫描、
 
 - docker-docs: 26.0.0 — https://docs.docker.com/reference/
 
-## 工作流
-
-| 场景 | 触发方式 |
-|------|----------|
-| 项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证 | 调用 MCP 工具 `docker_dockerize_project` |
-| 镜像优化：体积分析 → 层优化 → 多阶段重构 | 调用 MCP 工具 `docker_optimize:image` |
-| 安全扫描：漏洞检测 → 配置审查 → 修复建议 | 调用 MCP 工具 `docker_scan:security` |
-| 多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理 | 调用 MCP 工具 `docker_setup:compose` |

package/skills/devflow:electron/SKILL.md

@@ -3,6 +3,44 @@ name: devflow:electron
 description: Electron 专家 — IPC 通信、窗口管理、原生模块、自动更新、安全配置
 ---
 
+## 工作流（必须按顺序执行）
+
+### Step 1: 获取精确上下文
+调用 `mcp__devflow__get_project_context` 获取与用户问题相关的代码、记忆和知识库信息。
+这一步确保你拿到的是项目真实状态，而非凭空猜测。
+
+### Step 2: 分析
+基于 Step 1 返回的上下文，分析问题根因或设计方案。
+此时可以自由使用 Read 查看具体文件。
+
+### Step 3: 执行
+根据分析结果修改代码，逐文件编辑。
+
+### Step 4: 验证
+运行类型检查和测试，确保改动正确。
+
+## 可用工具
+
+| 工具 | 何时调用 |
+|------|----------|
+| `mcp__devflow__get_project_context` | 每次任务第一步（必须） |
+| `mcp__devflow__electron_diagnose_bug` | 按需调用 |
+
+## 规则
+- 永远从 `mcp__devflow__get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `get_project_context` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
+## 规则
+- 永远从 `electron_diagnose_bug` 开始——你不知道项目里有什么
+- 上下文返回后，用 Read 确认关键文件
+- 改完代码后跑类型检查
+
 # ⚛️ ELECTRON
 
 你是一个 Electron 专家。使用 contextBridge + IPC 安全通信模式。严格遵循 Electron 安全最佳实践。
@@ -32,11 +70,3 @@ description: Electron 专家 — IPC 通信、窗口管理、原生模块、自
 
 - electron-docs: 30.0.0 — https://www.electronjs.org/docs/latest/
 
-## 工作流
-
-| 场景 | 触发方式 |
-|------|----------|
-| 新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理 | 调用 MCP 工具 `electron_new:ipc` |
-| 安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖 | 调用 MCP 工具 `electron_audit:security` |
-| 自动更新配置：electron-updater → 发布渠道 → 更新 UI | 调用 MCP 工具 `electron_setup:auto-update` |
-| Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试 | 调用 MCP 工具 `electron_diagnose_bug` |