@devflow-tools/claude-code-plugin 0.14.4 → 0.16.0

package/hooks/session-start

@@ -1,6 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+SESSION_START_INPUT="$(cat)"
+
 # Try to get project summary from devflow doctor
 SUMMARY=""
 DOCTOR_OUTPUT=""
@@ -26,7 +29,6 @@ fi
 
 # Generate session token for MCP Gateway authentication
 # Clean up stale receipt from previous session
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 RECEIPT_DIR="${TMPDIR:-/tmp}/.devflow-receipts"
 mkdir -p "$RECEIPT_DIR" 2>/dev/null || true
 SESSION_ID=$(echo -n "$PROJECT_ROOT" | shasum -a 256 2>/dev/null | cut -c1-16 || echo "default")
@@ -34,48 +36,10 @@ RECEIPT_FILE="$RECEIPT_DIR/${SESSION_ID}.json"
 OVERRIDE_FILE="$RECEIPT_DIR/${SESSION_ID}.override"
 rm -f "$RECEIPT_FILE" "$OVERRIDE_FILE" 2>/dev/null || true
 
-# ── Clean up stale execution from previous session (if stop hook didn't fire) ──
-EXEC_FILE="${HOME}/.devflow/current-execution-id"
-SKILL_FILE="${HOME}/.devflow/current-skill.json"
-if [ -f "$EXEC_FILE" ]; then
-  EXEC_ID=$(cat "$EXEC_FILE" 2>/dev/null || echo "")
-  if [ -n "$EXEC_ID" ]; then
-    NOW_MS="$(date +%s)000"
-    python3 -c "
-import urllib.request, json
-try:
-    payload = json.dumps({
-        'executionId': '${EXEC_ID}',
-        'finishedAt': ${NOW_MS},
-        'status': 'completed',
-        'summary': {
-            'totalToolCalls': 0,
-            'mcpToolCalls': 0,
-            'directToolCalls': 0,
-            'subagentCount': 0,
-            'totalTokens': 0,
-            'totalDuration': 0,
-            'mcpComplianceRate': 0
-        }
-    }).encode()
-    req = urllib.request.Request(
-        'http://127.0.0.1:13337/api/telemetry/skill-execution/complete',
-        data=payload,
-        headers={'Content-Type': 'application/json', 'X-API-Key': 'dev-key-000000'},
-        method='POST'
-    )
-    urllib.request.urlopen(req, timeout=5)
-except:
-    pass
-" 2>/dev/null || true
-  fi
-  rm -f "$EXEC_FILE" "$SKILL_FILE" 2>/dev/null || true
-fi
-
 # Determine plugin root directory (same way as superpowers)
 if [ -z "${CLAUDE_PLUGIN_ROOT:-}" ]; then
   SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-  PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+  PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
 else
   PLUGIN_ROOT="$CLAUDE_PLUGIN_ROOT"
 fi
@@ -92,13 +56,32 @@ else
   GLOBAL_CONSTRAINT="DevFlow Constitution 文件未找到。使用 /devflow: 命令时请优先调用 MCP 工具。"
 fi
 
+# Read the active rule/gate counts from the canonical global database.
+GATE_COUNT=4
+RULE_COUNT=""
+ENFORCER_SUMMARY_JS="${PLUGIN_ROOT}/dist/hooks/enforcer-summary.js"
+if [ -f "$ENFORCER_SUMMARY_JS" ] && command -v node >/dev/null 2>&1; then
+  ENFORCER_SUMMARY=$(node "$ENFORCER_SUMMARY_JS" 2>/dev/null || echo "")
+  if [ -n "$ENFORCER_SUMMARY" ] && command -v python3 >/dev/null 2>&1; then
+    PARSED_COUNTS=$(printf '%s' "$ENFORCER_SUMMARY" | python3 -c "import json,sys; d=json.load(sys.stdin); g=d.get('gateCount'); r=d.get('ruleCount'); print(f'{g}|{r}' if isinstance(g,int) and isinstance(r,int) else '')" 2>/dev/null || echo "")
+    if [[ "$PARSED_COUNTS" =~ ^[0-9]+\|[0-9]+$ ]]; then
+      GATE_COUNT="${PARSED_COUNTS%%|*}"
+      RULE_COUNT="${PARSED_COUNTS##*|}"
+    fi
+  fi
+fi
+GATE_DETAIL="启用规则数未知"
+if [ -n "$RULE_COUNT" ]; then
+  GATE_DETAIL="启用规则: ${RULE_COUNT}"
+fi
+
 # Append Gateway status to summary
 GATEWAY_STATUS="\n\n━━━━━━ DevFlow Gateway ━━━━━━\n"
 # Check if devflow MCP server is configured (token will be auto-generated by ensureSessionToken)
 if [ -f ~/.claude/.mcp.json ] && grep -q '"devflow"' ~/.claude/.mcp.json 2>/dev/null; then
-  GATEWAY_STATUS="${GATEWAY_STATUS}Status: 🟢 DevFlow MCP 已配置\nGate 层数: 4 (宪法 → 派发 → 拦截 → 纠正)\n"
+  GATEWAY_STATUS="${GATEWAY_STATUS}Status: 🟢 DevFlow MCP 已配置\nGate 层数: ${GATE_COUNT} (${GATE_DETAIL})\n"
 elif [ -f .mcp.json ] && grep -q '"devflow"' .mcp.json 2>/dev/null; then
-  GATEWAY_STATUS="${GATEWAY_STATUS}Status: 🟢 DevFlow MCP 已配置（项目级）\nGate 层数: 4 (宪法 → 派发 → 拦截 → 纠正)\n"
+  GATEWAY_STATUS="${GATEWAY_STATUS}Status: 🟢 DevFlow MCP 已配置（项目级）\nGate 层数: ${GATE_COUNT} (${GATE_DETAIL})\n"
 else
   GATEWAY_STATUS="${GATEWAY_STATUS}Status: 🔴 未配置 DevFlow MCP Server\n请将 devflow MCP 配置加入 .mcp.json\n"
 fi
@@ -112,13 +95,13 @@ MCP_PROTOCOL="
 当用户使用 /devflow: 开头的技能时（如 /devflow:react、/devflow:vue、/devflow:context 等），你必须按以下流程操作：
 
 ### Step 1: 获取上下文（必须先执行）
-调用 mcp__devflow__get_project_context，参数格式：{\"query\": \"用户的问题描述\"}
+调用 mcp__devflow__get_project_context，参数格式：{\"query\": \"用户的问题描述\", \"projectRoot\": \"\${CLAUDE_PROJECT_DIR}\"}
 这个工具返回项目中的相关文件、符号、风险提示和下一步建议。
 不要跳过这一步。不要用 Explore、Agent、Grep 或 Bash 代替。
 
 ### Step 2: 按需调用领域工具
 根据技能类型调用对应的 MCP 工具：
-- React 性能问题 → mcp__devflow__react_audit_performance（无需参数）
+- React 性能问题 → mcp__devflow__react_audit_performance（参数：{\"projectRoot\": \"\${CLAUDE_PROJECT_DIR}\"}）
 - React Bug → mcp__devflow__react_diagnose_bug
 - React Hooks 审查 → mcp__devflow__react_review_hooks
 - Vue 问题 → mcp__devflow__vue_diagnose_bug
@@ -131,46 +114,146 @@ MCP_PROTOCOL="
 
 ### 铁律
 - 永远不要用 Explore、Agent、Grep 或 Glob 替代 MCP 工具的第一步上下文获取
-- 所有 mcp__devflow__ 工具的 projectRoot 参数都是可选的，无需传
+- Every mcp__devflow__ tool MUST pass projectRoot = \${CLAUDE_PROJECT_DIR}; missing projectRoot is rejected; no cwd fallback.
 - 如果 MCP 工具返回错误，重试一次；再失败则回退到直接读文件"
 
-SUMMARY="${SUMMARY}${MCP_PROTOCOL}${GLOBAL_CONSTRAINT}${GATEWAY_STATUS}"
+MEMORY_DISTILL="
 
-# Escape for JSON
-ESCAPED=$(echo "$SUMMARY" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))")
+Next session instruction: call mcp__devflow__memory_request_distill once at session start; it safely reports when no memory events are pending."
 
-# 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"
+DEVFLOW_DAEMON_REACHABLE=0
+run_lifecycle() {
+  local PROJECT_HASH=""
+  local state_dir=""
+  local log_dir="${HOME}/.devflow/logs"
+  local fallback_dir="${TMPDIR:-/tmp}"
+
+  if command -v shasum >/dev/null 2>&1; then
+    PROJECT_HASH=$(printf '%s' "$PROJECT_ROOT" | shasum -a 256 2>/dev/null | cut -c1-16) || PROJECT_HASH=""
+  fi
+  [[ "$PROJECT_HASH" =~ ^[0-9a-f]{16}$ ]] || PROJECT_HASH=""
+
+  if [ -n "${DEVFLOW_STATE_DIR:-}" ]; then
+    state_dir="$DEVFLOW_STATE_DIR"
+  elif [ -n "$PROJECT_HASH" ]; then
+    state_dir="${HOME}/.devflow/state/${PROJECT_HASH}"
+  fi
+  if [ -n "$state_dir" ]; then
+    rm -f "${state_dir}/current-execution-id" "${state_dir}/current-skill.json" 2>/dev/null || true
+  fi
+
+  if mkdir -p "$log_dir" 2>/dev/null; then
+    DAEMON_LOG="${log_dir}/hook-daemon-${PROJECT_HASH:-fallback}.log"
+    SERVER_LOG="${HOME}/.devflow/logs/server.log"
+  elif [ -d "$fallback_dir" ]; then
+    DAEMON_LOG="${fallback_dir}/devflow-hook-daemon-${PROJECT_HASH:-fallback}.log"
+    SERVER_LOG="${fallback_dir}/devflow-server.log"
+  else
+    DAEMON_LOG="/dev/null"
+    SERVER_LOG="/dev/null"
+  fi
+
+  DAEMON_JS="${PLUGIN_ROOT}/dist/hooks/hook-daemon.js"
+  CLIENT_JS="${PLUGIN_ROOT}/dist/hooks/hook-client.js"
 
-# ── Start hook daemon (background, Unix socket) ──
-DAEMON_JS="${PLUGIN_ROOT}/dist/hooks/hook-daemon.js"
-if [ -f "$DAEMON_JS" ]; then
-  # Kill any stale daemon from previous session
-  STALE_PID=$(pgrep -f "hook-daemon.js" 2>/dev/null || true)
-  if [ -n "$STALE_PID" ]; then
-    kill "$STALE_PID" 2>/dev/null || true
-    sleep 0.5
+  register_session() {
+    local suppress_fallback="${1:-1}"
+    [ -n "$SESSION_START_INPUT" ] || return 0
+    [ -f "$CLIENT_JS" ] || return 1
+    if DEVFLOW_HOOK_CLIENT_TIMEOUT_MS=250 \
+      DEVFLOW_HOOK_CLIENT_RETRY_DELAY_MS=50 \
+      DEVFLOW_HOOK_CLIENT_SUPPRESS_FALLBACK_LOG="$suppress_fallback" \
+      node "$CLIENT_JS" session-start "$SESSION_START_INPUT" >/dev/null 2>> "$DAEMON_LOG"; then
+      DEVFLOW_DAEMON_REACHABLE=1
+      return 0
+    fi
+    return 1
+  }
+
+  if [ -n "$SESSION_START_INPUT" ] && register_session 1; then
+    :
+  elif [ -f "$DAEMON_JS" ] && command -v nohup >/dev/null 2>&1 && command -v node >/dev/null 2>&1; then
+    if [ -n "$SESSION_START_INPUT" ]; then
+      nohup node "$DAEMON_JS" "$PROJECT_ROOT" "$SESSION_START_INPUT" </dev/null >> "$DAEMON_LOG" 2>&1 &
+    else
+      nohup node "$DAEMON_JS" "$PROJECT_ROOT" </dev/null >> "$DAEMON_LOG" 2>&1 &
+    fi
+    DAEMON_PID=$!
+    echo "[devflow] Hook daemon started for ${PROJECT_ROOT} (PID ${DAEMON_PID})" >&2 || true
+
+    if [ -n "$SESSION_START_INPUT" ]; then
+      for _ in 1 2 3 4 5 6 7 8; do
+        register_session 1 && break
+        sleep 0.05
+      done
+    fi
+  fi
+
+  if [ -n "$SESSION_START_INPUT" ] && [ "$DEVFLOW_DAEMON_REACHABLE" != "1" ]; then
+    register_session 0 || true
+  fi
+
+  SERVER_BOOTSTRAP_JS="${PLUGIN_ROOT}/dist/hooks/server-bootstrap.js"
+  if [ -f "$SERVER_BOOTSTRAP_JS" ] && command -v nohup >/dev/null 2>&1 && command -v node >/dev/null 2>&1; then
+    nohup node "$SERVER_BOOTSTRAP_JS" </dev/null >> "$SERVER_LOG" 2>&1 &
   fi
-  node "$DAEMON_JS" "${CLAUDE_PROJECT_DIR:-$(pwd)}" &
-  echo "[devflow] Hook daemon started (PID $!)" >&2
+}
+
+run_lifecycle || true
+
+DEGRADED_CONTEXT=""
+if [ "$DEVFLOW_DAEMON_REACHABLE" != "1" ]; then
+  DEGRADED_CONTEXT="
+
+WARNING: DevFlow is in degraded mode (daemon unreachable): 4-Gate enforcement is unavailable, memory prefetch cache is unavailable, and daemon-shared Hook state is unavailable. Run devflow doctor for details."
 fi
 
-# ── Trigger memory extraction for previous session events (best-effort, async) ──
-(python3 -c "
-import urllib.request, json, sys
-try:
-    req = urllib.request.Request(
-        'http://127.0.0.1:13337/api/memory/process?rootPath=${CLAUDE_PROJECT_DIR:-$(pwd)}',
-        data=b'{}',
-        headers={'Content-Type': 'application/json', 'X-API-Key': 'dev-key-000000'},
-        method='POST',
-    )
-    resp = urllib.request.urlopen(req, timeout=30)
-    result = json.loads(resp.read())
-    print('DevFlow memory: {} extracted, {} approved, {} pending'.format(
-        result.get('extracted', 0), result.get('approved', 0), result.get('pending', 0)), file=sys.stderr)
-except Exception as e:
-    print('DevFlow memory extraction skipped: {}'.format(e), file=sys.stderr)
-" 2>/dev/null || true) &
+MEMORY_SNAPSHOT="## Project memory\n本项目暂无记忆"
+CONFIG_FILE="${PROJECT_ROOT}/.devflow/config.json"
+MEMORY_RESPONSE=""
+if [ -f "${CLIENT_JS:-}" ] && command -v node >/dev/null 2>&1; then
+  MEMORY_RESPONSE=$(DEVFLOW_HOOK_CLIENT_TIMEOUT_MS=1000 node "$CLIENT_JS" memory-snapshot </dev/null 2>/dev/null || echo "")
+fi
+if command -v python3 >/dev/null 2>&1; then
+  MEMORY_SNAPSHOT=$(DEVFLOW_MEMORY_RESPONSE="$MEMORY_RESPONSE" python3 - "$CONFIG_FILE" 2>/dev/null <<'PY'
+import json,os,sys
+try: cfg=json.load(open(sys.argv[1])).get('sessionStart',{}).get('injectMemories',True)
+except Exception: cfg=True
+if cfg is False: print(''); raise SystemExit
+try: response=json.loads(os.environ.get('DEVFLOW_MEMORY_RESPONSE',''))
+except Exception: response={}
+print(response.get('markdown') or '## Project memory\n本项目暂无记忆')
+PY
+  ) || MEMORY_SNAPSHOT="## Project memory\n本项目暂无记忆"
+fi
+
+ONBOARDING_SNAPSHOT=""
+ONBOARDING_FILE="${PROJECT_ROOT}/.devflow/onboarding-pack.json"
+if [ -f "$ONBOARDING_FILE" ] && command -v python3 >/dev/null 2>&1; then
+  ONBOARDING_SNAPSHOT=$(python3 - "$ONBOARDING_FILE" 2>/dev/null <<'PY'
+import json,sys
+def clean(value): return ' '.join(str(value).split())[:120]
+try: data=json.load(open(sys.argv[1]))
+except Exception: raise SystemExit
+modules=[clean(item.get('name','')) for item in data.get('keyModules',[])[:6] if item.get('name')]
+layers=[f"{clean(item.get('name',''))} ({int(item.get('files',0))} files)" for item in data.get('architectureLayers',[])[:6] if item.get('name')]
+if modules or layers:
+  print('## Project map (auto-injected)')
+  if modules: print('Key modules: ' + ', '.join(modules))
+  if layers: print('Architecture: ' + ', '.join(layers))
+PY
+  ) || ONBOARDING_SNAPSHOT=""
+fi
+
+SUMMARY="${SUMMARY}${DEGRADED_CONTEXT}${MEMORY_DISTILL}\n\n${ONBOARDING_SNAPSHOT}\n\n${MEMORY_SNAPSHOT}${MCP_PROTOCOL}${GLOBAL_CONSTRAINT}${GATEWAY_STATUS}"
+
+if command -v python3 >/dev/null 2>&1 \
+  && ESCAPED=$(printf '%s\n' "$SUMMARY" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))" 2>/dev/null); then
+  :
+else
+  ESCAPED='"Next session instruction: call mcp__devflow__memory_request_distill once at session start; it safely reports when no memory events are pending."'
+fi
+
+printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": %s\n  }\n}\n' "$ESCAPED"
 
 exit 0

package/hooks/stop

@@ -11,19 +11,13 @@ if [ -f "$CLIENT_JS" ]; then
   node "$CLIENT_JS" stop </dev/null 2>/dev/null || true
 fi
 
-# 2. Fallback: kill any remaining daemon process
-DAEMON_PID=$(pgrep -f "hook-daemon.js" 2>/dev/null || true)
-if [ -n "$DAEMON_PID" ]; then
-  kill "$DAEMON_PID" 2>/dev/null || true
-fi
-
-# 3. Run existing stop.js cleanup (session close, memory extraction)
+# 2. Run existing stop.js cleanup (session close, memory extraction)
 STOP_JS="$PLUGIN_ROOT/dist/hooks/stop.js"
 if [ -f "$STOP_JS" ]; then
   node "$STOP_JS" 2>/dev/null || true
 fi
 
-# 4. Clean up stale receipt files for this project
+# 3. Clean up stale receipt files for this project
 PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 SESSION_ID=$(echo -n "$PROJECT_ROOT" | shasum -a 256 2>/dev/null | cut -c1-16 || echo "")
 RECEIPT_FILE="${TMPDIR:-/tmp}/.devflow-receipts/${SESSION_ID}.json"

package/hooks/user-prompt-submit

@@ -10,10 +10,10 @@ INPUT="$(cat)"
 
 if [ -f "$CLIENT_JS" ]; then
   node "$CLIENT_JS" user-prompt-submit "$INPUT" 2>/dev/null || {
-    echo "$INPUT" | node "$FALLBACK_JS" 2>/dev/null || true
+    echo "$INPUT" | DEVFLOW_HOOK_DEGRADED=1 node "$FALLBACK_JS" 2>/dev/null || true
   }
 elif [ -f "$FALLBACK_JS" ]; then
-  echo "$INPUT" | node "$FALLBACK_JS" 2>/dev/null || true
+  echo "$INPUT" | DEVFLOW_HOOK_DEGRADED=1 node "$FALLBACK_JS" 2>/dev/null || true
 fi
 
 exit 0

package/package.json

@@ -1,14 +1,25 @@
 {
   "name": "@devflow-tools/claude-code-plugin",
-  "version": "0.14.4",
+  "version": "0.16.0",
   "description": "DevFlow — Developer Intelligence Platform for Claude Code",
   "type": "module",
   "scripts": {
     "build": "npx tsx scripts/inject-gates.ts",
     "deploy": "npx tsx scripts/inject-gates.ts --deploy"
   },
+  "dependencies": {
+    "@devflow-tools/database": "0.16.0",
+    "@devflow-tools/memory-engine": "0.16.0",
+    "@devflow-tools/sdk": "0.16.0",
+    "@devflow-tools/telemetry": "0.16.0",
+    "@devflow-tools/workflow-engine": "0.16.0"
+  },
+  "allowScripts": {
+    "better-sqlite3@12.11.1": true,
+    "sharp@0.32.6": true
+  },
   "devDependencies": {
-    "@devflow-tools/mcp-server": "^0.14.4"
+    "@devflow-tools/mcp-server": "0.16.0"
   },
   "keywords": [
     "pi-package",
@@ -28,5 +39,5 @@
     "hooks.json",
     "skills"
   ],
-  "gitHead": "54c8815398c8f60461caee19802afa3827ea3100"
+  "gitHead": "2f52776bda72517354d44453756cccb9e8de9afa"
 }

package/skills/devflow:animation/SKILL.md

@@ -3,44 +3,6 @@ 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。
@@ -67,3 +29,10 @@ 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:css/SKILL.md

@@ -3,44 +3,6 @@ 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 文档。
@@ -67,3 +29,10 @@ 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,44 +3,6 @@ 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 专家。使用多阶段构建优化镜像，遵循安全和性能最佳实践。遇到问题先查官方文档。
@@ -70,3 +32,11 @@ 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,44 +3,6 @@ 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 安全最佳实践。
@@ -70,3 +32,11 @@ 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` |

package/skills/devflow:git/SKILL.md

@@ -3,44 +3,6 @@ name: devflow:git
 description: Git 专家 — 提交规范、分支审查、Changelog 生成、冲突解决
 ---
 
-## 工作流（必须按顺序执行）
-
-### Step 1: 获取精确上下文
-调用 `mcp__devflow__get_project_context` 获取与用户问题相关的代码、记忆和知识库信息。
-这一步确保你拿到的是项目真实状态，而非凭空猜测。
-
-### Step 2: 分析
-基于 Step 1 返回的上下文，分析问题根因或设计方案。
-此时可以自由使用 Read 查看具体文件。
-
-### Step 3: 执行
-根据分析结果修改代码，逐文件编辑。
-
-### Step 4: 验证
-运行类型检查和测试，确保改动正确。
-
-## 可用工具
-
-| 工具 | 何时调用 |
-|------|----------|
-| `mcp__devflow__get_project_context` | 每次任务第一步（必须） |
-| `mcp__devflow__git_analyze_repo` | 按需调用 |
-
-## 规则
-- 永远从 `mcp__devflow__get_project_context` 开始——你不知道项目里有什么
-- 上下文返回后，用 Read 确认关键文件
-- 改完代码后跑类型检查
-
-## 规则
-- 永远从 `get_project_context` 开始——你不知道项目里有什么
-- 上下文返回后，用 Read 确认关键文件
-- 改完代码后跑类型检查
-
-## 规则
-- 永远从 `git_analyze_repo` 开始——你不知道项目里有什么
-- 上下文返回后，用 Read 确认关键文件
-- 改完代码后跑类型检查
-
 # 🔀 GIT
 
 你是一个 Git 工作流专家。遵循 Conventional Commits 规范和 GitFlow 分支策略。
@@ -70,3 +32,11 @@ description: Git 专家 — 提交规范、分支审查、Changelog 生成、冲
 - conventional-commits: 1.0.0 — https://www.conventionalcommits.org/en/v1.0.0/
 - git-scm-docs: 2.45.0 — https://git-scm.com/docs
 
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 规范化提交： | 调用 MCP 工具 `git_commit` |
+| 发布流程： | 调用 MCP 工具 `git_release` |
+| 分支清理： | 调用 MCP 工具 `git_audit:branches` |
+| 冲突解决： | 调用 MCP 工具 `git_resolve:conflicts` |