@devflow-tools/claude-code-plugin 0.12.1 → 0.12.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/command-registry.json +0 -170
- package/dist/hooks/hook-daemon.js +7 -3
- package/package.json +3 -3
- package/skills/devflow:start/SKILL.md +17 -24
- package/dist/skills/devflow:docker/SKILL.md +0 -67
- package/dist/skills/devflow:electron/SKILL.md +0 -67
- package/dist/skills/devflow:graphql/SKILL.md +0 -68
- package/dist/skills/devflow:nest/SKILL.md +0 -68
- package/dist/skills/devflow:nextjs/SKILL.md +0 -65
- package/dist/skills/devflow:performance/SKILL.md +0 -67
- package/dist/skills/devflow:react/SKILL.md +0 -85
- package/dist/skills/devflow:tailwind/SKILL.md +0 -63
- package/dist/skills/devflow:taro/SKILL.md +0 -66
- package/dist/skills/devflow:vue/SKILL.md +0 -74
|
@@ -60,176 +60,6 @@
|
|
|
60
60
|
"run_workflow"
|
|
61
61
|
],
|
|
62
62
|
"blockedNative": []
|
|
63
|
-
},
|
|
64
|
-
"devflow:react": {
|
|
65
|
-
"mcpTools": [
|
|
66
|
-
"react_diagnose_bug",
|
|
67
|
-
"react_new_feature",
|
|
68
|
-
"react_audit_performance",
|
|
69
|
-
"react_review_hooks",
|
|
70
|
-
"react_refactor_component",
|
|
71
|
-
"react_new_component"
|
|
72
|
-
],
|
|
73
|
-
"blockedNative": [
|
|
74
|
-
"grep",
|
|
75
|
-
"find",
|
|
76
|
-
"rg",
|
|
77
|
-
"ag",
|
|
78
|
-
"Grep",
|
|
79
|
-
"Glob",
|
|
80
|
-
"Explore",
|
|
81
|
-
"WebSearch",
|
|
82
|
-
"WebFetch"
|
|
83
|
-
]
|
|
84
|
-
},
|
|
85
|
-
"devflow:vue": {
|
|
86
|
-
"mcpTools": [
|
|
87
|
-
"vue_diagnose_bug",
|
|
88
|
-
"vue_new_component",
|
|
89
|
-
"vue_debug_reactivity"
|
|
90
|
-
],
|
|
91
|
-
"blockedNative": [
|
|
92
|
-
"grep",
|
|
93
|
-
"find",
|
|
94
|
-
"rg",
|
|
95
|
-
"ag",
|
|
96
|
-
"Grep",
|
|
97
|
-
"Glob",
|
|
98
|
-
"Explore",
|
|
99
|
-
"WebSearch",
|
|
100
|
-
"WebFetch"
|
|
101
|
-
]
|
|
102
|
-
},
|
|
103
|
-
"devflow:tailwind": {
|
|
104
|
-
"mcpTools": [
|
|
105
|
-
"tailwind_new_component"
|
|
106
|
-
],
|
|
107
|
-
"blockedNative": [
|
|
108
|
-
"grep",
|
|
109
|
-
"find",
|
|
110
|
-
"rg",
|
|
111
|
-
"ag",
|
|
112
|
-
"Grep",
|
|
113
|
-
"Glob",
|
|
114
|
-
"Explore",
|
|
115
|
-
"WebSearch",
|
|
116
|
-
"WebFetch"
|
|
117
|
-
]
|
|
118
|
-
},
|
|
119
|
-
"devflow:taro": {
|
|
120
|
-
"mcpTools": [
|
|
121
|
-
"taro_new_page"
|
|
122
|
-
],
|
|
123
|
-
"blockedNative": [
|
|
124
|
-
"grep",
|
|
125
|
-
"find",
|
|
126
|
-
"rg",
|
|
127
|
-
"ag",
|
|
128
|
-
"Grep",
|
|
129
|
-
"Glob",
|
|
130
|
-
"Explore",
|
|
131
|
-
"WebSearch",
|
|
132
|
-
"WebFetch"
|
|
133
|
-
]
|
|
134
|
-
},
|
|
135
|
-
"devflow:nest": {
|
|
136
|
-
"mcpTools": [
|
|
137
|
-
"nest_new_module",
|
|
138
|
-
"nest_diagnose_bug"
|
|
139
|
-
],
|
|
140
|
-
"blockedNative": [
|
|
141
|
-
"grep",
|
|
142
|
-
"find",
|
|
143
|
-
"rg",
|
|
144
|
-
"ag",
|
|
145
|
-
"Grep",
|
|
146
|
-
"Glob",
|
|
147
|
-
"Explore",
|
|
148
|
-
"WebSearch",
|
|
149
|
-
"WebFetch"
|
|
150
|
-
]
|
|
151
|
-
},
|
|
152
|
-
"devflow:graphql": {
|
|
153
|
-
"mcpTools": [
|
|
154
|
-
"graphql_new_graphql_type",
|
|
155
|
-
"graphql_diagnose_bug"
|
|
156
|
-
],
|
|
157
|
-
"blockedNative": [
|
|
158
|
-
"grep",
|
|
159
|
-
"find",
|
|
160
|
-
"rg",
|
|
161
|
-
"ag",
|
|
162
|
-
"Grep",
|
|
163
|
-
"Glob",
|
|
164
|
-
"Explore",
|
|
165
|
-
"WebSearch",
|
|
166
|
-
"WebFetch"
|
|
167
|
-
]
|
|
168
|
-
},
|
|
169
|
-
"devflow:docker": {
|
|
170
|
-
"mcpTools": [
|
|
171
|
-
"docker_dockerize_project"
|
|
172
|
-
],
|
|
173
|
-
"blockedNative": [
|
|
174
|
-
"grep",
|
|
175
|
-
"find",
|
|
176
|
-
"rg",
|
|
177
|
-
"ag",
|
|
178
|
-
"Grep",
|
|
179
|
-
"Glob",
|
|
180
|
-
"Explore",
|
|
181
|
-
"WebSearch",
|
|
182
|
-
"WebFetch"
|
|
183
|
-
]
|
|
184
|
-
},
|
|
185
|
-
"devflow:performance": {
|
|
186
|
-
"mcpTools": [
|
|
187
|
-
"performance_audit_performance"
|
|
188
|
-
],
|
|
189
|
-
"blockedNative": [
|
|
190
|
-
"grep",
|
|
191
|
-
"find",
|
|
192
|
-
"rg",
|
|
193
|
-
"ag",
|
|
194
|
-
"Grep",
|
|
195
|
-
"Glob",
|
|
196
|
-
"Explore",
|
|
197
|
-
"WebSearch",
|
|
198
|
-
"WebFetch"
|
|
199
|
-
]
|
|
200
|
-
},
|
|
201
|
-
"devflow:nextjs": {
|
|
202
|
-
"mcpTools": [
|
|
203
|
-
"nextjs_new_page",
|
|
204
|
-
"nextjs_diagnose_bug"
|
|
205
|
-
],
|
|
206
|
-
"blockedNative": [
|
|
207
|
-
"grep",
|
|
208
|
-
"find",
|
|
209
|
-
"rg",
|
|
210
|
-
"ag",
|
|
211
|
-
"Grep",
|
|
212
|
-
"Glob",
|
|
213
|
-
"Explore",
|
|
214
|
-
"WebSearch",
|
|
215
|
-
"WebFetch"
|
|
216
|
-
]
|
|
217
|
-
},
|
|
218
|
-
"devflow:electron": {
|
|
219
|
-
"mcpTools": [
|
|
220
|
-
"electron_diagnose_bug"
|
|
221
|
-
],
|
|
222
|
-
"blockedNative": [
|
|
223
|
-
"grep",
|
|
224
|
-
"find",
|
|
225
|
-
"rg",
|
|
226
|
-
"ag",
|
|
227
|
-
"Grep",
|
|
228
|
-
"Glob",
|
|
229
|
-
"Explore",
|
|
230
|
-
"WebSearch",
|
|
231
|
-
"WebFetch"
|
|
232
|
-
]
|
|
233
63
|
}
|
|
234
64
|
}
|
|
235
65
|
}
|
|
@@ -1,4 +1,8 @@
|
|
|
1
|
-
import {createServer}from'net';import {join}from'path';import {homedir}from'os';import {existsSync,unlinkSync,readdirSync,readFileSync,mkdirSync,writeFileSync}from'fs';import {createHash}from'crypto';import {request}from'http';var
|
|
2
|
-
`)
|
|
1
|
+
import {createServer}from'net';import {join}from'path';import {homedir}from'os';import {existsSync,unlinkSync,readdirSync,readFileSync,mkdirSync,writeFileSync}from'fs';import {createHash}from'crypto';import {request}from'http';import {spawn}from'child_process';var O=1e4,nt=3e4,rt=300*1e3;function v(a,t,e){return new Promise(s=>{try{let n=new URL(a),r=request({hostname:n.hostname,port:n.port||80,path:n.pathname+n.search,method:"POST",headers:{"Content-Type":"application/json","X-API-Key":e,"Content-Length":Buffer.byteLength(t)},timeout:5e3},o=>{let i=[];o.on("data",c=>i.push(c)),o.on("end",()=>{let c=Buffer.concat(i).toString();s(o.statusCode!=null&&o.statusCode>=200&&o.statusCode<300?c:null);});});r.on("error",()=>s(null)),r.on("timeout",()=>{r.destroy(),s(null);}),r.write(t),r.end();}catch{s(null);}})}var S=class{constructor(t){this.retryScheduled=false;this.retryAttempts=0;this.apiUrl=t?.apiUrl??process.env.DEVFLOW_API_URL??"http://127.0.0.1:13337",this.apiKey=t?.apiKey??process.env.DEVFLOW_API_KEY??"dev-key-000000",this.cacheDir=t?.cacheDir??join(homedir(),".devflow","telemetry-cache");}async sendEvent(t){let e=this.truncateInput(t.input),s={...t,input:e},n=`${this.apiUrl}/api/telemetry/tool-call`,r=await v(n,JSON.stringify(s),this.apiKey);if(r)try{let o=JSON.parse(r),i=o.data?.eventId??o.eventId??null;if(i)return i}catch{}return this.cacheEvent({type:"tool_call",payload:s}),null}async sendExecutionStart(t,e,s,n){let r={executionId:t,sessionId:e,skillName:s,startedAt:n},o=`${this.apiUrl}/api/telemetry/skill-execution/start`;await v(o,JSON.stringify(r),this.apiKey)||this.cacheEvent({type:"execution_start",payload:r});}async sendSessionStart(t,e,s){let n={id:t,projectRoot:e,startedAt:s,label:e.split("/").pop()??"unknown"},r=`${this.apiUrl}/api/telemetry/sessions`;return await v(r,JSON.stringify(n),this.apiKey)!==null}async flushCache(){if(!existsSync(this.cacheDir))return;let t=readdirSync(this.cacheDir).filter(e=>e.endsWith(".json"));for(let e of t)try{let s=join(this.cacheDir,e),n=readFileSync(s,"utf8"),r=JSON.parse(n),o=r.type==="execution_start"?"/api/telemetry/skill-execution/start":"/api/telemetry/tool-call",i=`${this.apiUrl}${o}`;await v(i,JSON.stringify(r.payload),this.apiKey)&&unlinkSync(s);}catch{}}cacheEvent(t){try{existsSync(this.cacheDir)||mkdirSync(this.cacheDir,{recursive:!0});let e=join(this.cacheDir,`${Date.now()}_${Math.random().toString(36).slice(2,11)}.json`);writeFileSync(e,JSON.stringify(t,null,2)),this.scheduleRetry();}catch{}}scheduleRetry(){if(this.retryScheduled)return;this.retryScheduled=true;let t=Math.min(nt*Math.pow(2,this.retryAttempts),rt);setTimeout(()=>{this.retryScheduled=false,this.flushCache().then(()=>{this.retryAttempts=0;}).catch(()=>{this.retryAttempts++;});},t).unref();}truncateInput(t){let e=JSON.stringify(t);return e.length<=O?t:{_truncated:true,_original_size:e.length,_preview:e.substring(0,O)+"..."}}};var at=1800*1e3;function ct(){return process.env.DEVFLOW_STATE_DIR??join(homedir(),".devflow")}var w=class{constructor(t){this.stateDir=ct();}detect(){let t=join(this.stateDir,"current-skill.json");if(!existsSync(t))return null;try{let e=readFileSync(t,"utf8"),s=JSON.parse(e);return !s.registeredAt||Date.now()-s.registeredAt>at?(this.endExecution(),null):s}catch{return null}}startExecution(t,e){existsSync(this.stateDir)||mkdirSync(this.stateDir,{recursive:true});let s=this.getCurrentExecutionId();if(s)return s;let n=`exec_${Date.now()}_${Math.random().toString(36).slice(2,11)}`;return writeFileSync(join(this.stateDir,"current-execution-id"),n),writeFileSync(join(this.stateDir,"current-skill.json"),JSON.stringify({name:t,required_mcp_tools:e?.required_mcp_tools??[],registeredAt:Date.now()})),n}getCurrentExecutionId(){let t=join(this.stateDir,"current-execution-id");if(!existsSync(t))return null;try{return readFileSync(t,"utf8").trim()}catch{return null}}endExecution(){let t=join(this.stateDir,"current-skill.json"),e=join(this.stateDir,"current-execution-id");try{existsSync(t)&&unlinkSync(t);}catch{}try{existsSync(e)&&unlinkSync(e);}catch{}}};var D=join(homedir(),".devflow"),b=join(D,"server-refs.json"),ft="http://127.0.0.1:13337/api/health",yt=600*1e3,gt=500;function vt(){existsSync(D)||mkdirSync(D,{recursive:true});}function _(){try{if(existsSync(b))return JSON.parse(readFileSync(b,"utf-8"))}catch{}return {sessions:[],lastActivity:0}}function F(a){vt(),writeFileSync(b,JSON.stringify(a));}var k=class{constructor(t){this.process=null;this.idleTimer=null;this.onShutdown=null;this.projectRoot=t;}setOnShutdown(t){this.onShutdown=t;}addRef(t){let e=_();e.sessions.includes(t)||e.sessions.push(t),e.lastActivity=Date.now(),F(e),this.resetIdleTimer();}removeRef(t){let e=_();e.sessions=e.sessions.filter(s=>s!==t),e.lastActivity=Date.now(),F(e),e.sessions.length===0&&this.resetIdleTimer();}get activeSessions(){return _().sessions.length}async ensureRunning(){return await this.healthCheck()?true:(await this.startServer(),this.waitForReady())}get isRunning(){return this.process!==null&&!this.process.killed}async stop(){this.idleTimer&&clearTimeout(this.idleTimer),this.process&&(this.process.kill("SIGTERM"),await new Promise(t=>{let e=setTimeout(()=>{this.process&&!this.process.killed&&this.process.kill("SIGKILL"),t();},5e3);this.process?this.process.on("exit",()=>{clearTimeout(e),t();}):(clearTimeout(e),t());}),this.process=null);}async startServer(){let t=join(this.projectRoot,"apps","server","dist","main.js"),e=join(this.projectRoot,"node_modules","@devflow-tools","server","dist","main.js"),s=existsSync(t)?t:e;this.process=spawn("node",[s],{cwd:this.projectRoot,env:{...process.env,NODE_ENV:process.env.NODE_ENV||"development"},stdio:["ignore","pipe","pipe"]}),this.process.stdout?.on("data",n=>{}),this.process.stderr?.on("data",n=>{}),this.process.on("exit",n=>{this.process=null,this.onShutdown&&this.onShutdown();}),this.process.on("error",()=>{this.process=null;});}async waitForReady(){let t=Date.now()+3e4;for(;Date.now()<t;){if(await this.healthCheck())return true;await new Promise(e=>setTimeout(e,gt));}return false}healthCheck(){return new Promise(t=>{let e=new URL(ft),s=request({hostname:e.hostname,port:e.port,path:e.pathname,method:"GET",timeout:2e3},n=>{t(n.statusCode===200);});s.on("error",()=>t(false)),s.on("timeout",()=>{s.destroy(),t(false);}),s.end();})}resetIdleTimer(){this.idleTimer&&clearTimeout(this.idleTimer),!(_().sessions.length>0)&&(this.idleTimer=setTimeout(()=>{this.stop();},yt).unref());}};var p=join(homedir(),".devflow","telemetry-buffer.jsonl"),B=500;function wt(){let a=join(homedir(),".devflow");existsSync(a)||mkdirSync(a,{recursive:true});}var E=class{append(t){try{wt();let e=[];existsSync(p)&&(e=readFileSync(p,"utf-8").split(`
|
|
2
|
+
`).filter(s=>s.trim())),e.push(JSON.stringify(t)),e.length>B&&(e=e.slice(e.length-B)),writeFileSync(p,e.join(`
|
|
3
|
+
`)+`
|
|
4
|
+
`);}catch{}}readAll(){try{return existsSync(p)?readFileSync(p,"utf-8").split(`
|
|
5
|
+
`).filter(t=>t.trim()):[]}catch{return []}}clear(){try{existsSync(p)&&writeFileSync(p,"");}catch{}}get size(){return this.readAll().length}};var f=join(homedir(),".devflow","hook-daemon.sock");join(homedir(),".devflow");var Rt=600*1e3,Pt=new Set(["Agent","Bash","Glob","Grep","WebSearch","WebFetch"]);function Dt(a){switch(a){case "Read":case "Glob":return "file_read";case "Write":case "Edit":case "NotebookEdit":return "file_write";case "Bash":return "bash_command";case "Agent":return "subagent";case "Skill":return "skill_invoke";default:return "tool_use"}}function V(a){let t=createHash("sha256").update(a).digest("hex").slice(0,16);return join(process.env.TMPDIR||"/tmp",".devflow-receipts",`${t}.json`)}function bt(a){try{let t=V(a);return existsSync(t)?JSON.parse(readFileSync(t,"utf-8")):{}}catch{return {}}}function W(a,t){try{let e=V(a),s=join(process.env.TMPDIR||"/tmp",".devflow-receipts");existsSync(s)||mkdirSync(s,{recursive:!0}),writeFileSync(e,JSON.stringify(t));}catch{}}var C=class{constructor(t){this.sessionId=null;this.eventMap=[];this.idleTimer=null;this.projectRoot=t,this.projectName=t.split("/").pop()||"unknown",this.telemetry=new S,this.skillManager=new w,this.serverManager=new k(t),this.telemetryBuffer=new E;}async start(){try{existsSync(f)&&unlinkSync(f);}catch{}let t=createServer(e=>{this.resetIdleTimer();let s="";e.on("data",async n=>{s+=n.toString();let r=s.split(`
|
|
6
|
+
`);s=r.pop()||"";for(let o of r)if(o.trim())try{let i=JSON.parse(o),c=await this.handleRequest(i);c!==null&&e.write(JSON.stringify(c)+`
|
|
3
7
|
`);}catch(i){e.write(JSON.stringify({error:i.message})+`
|
|
4
|
-
`);}}),e.on("error",()=>{});});t.on("error",e=>{console.error("[devflow-daemon] Server error:",e.message);}),t.listen(
|
|
8
|
+
`);}}),e.on("error",()=>{});});t.on("error",e=>{console.error("[devflow-daemon] Server error:",e.message);}),t.listen(f,()=>{console.error("[devflow-daemon] Listening on",f);}),this.flushBuffer(),this.resetIdleTimer();}resetIdleTimer(){this.idleTimer&&clearTimeout(this.idleTimer),this.idleTimer=setTimeout(()=>{console.error("[devflow-daemon] Idle timeout, exiting"),this.shutdown();},Rt).unref();}async handleRequest(t){switch(t.type){case "pre-tool-use":return this.handlePreToolUse(t.input);case "post-tool-use":return this.handlePostToolUse(t.input);case "stop":return await this.handleStop(),{status:"ok"};default:return {error:"unknown request type"}}}async handlePreToolUse(t){try{if(!t||t.trim()==="")return {hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"allow"}};let e=JSON.parse(t);if(this.sessionId||(this.sessionId=`session:${this.projectName}:${Date.now().toString(36)}`,this.telemetry.sendSessionStart(this.sessionId,this.projectRoot,Date.now()).catch(()=>{})),e.tool_name==="Skill"){let l=e.tool_input?.skill;if(l&&l.startsWith("devflow:")){let X=this.skillManager.startExecution(l);this.telemetry.sendExecutionStart(X,this.sessionId,l,Date.now()).catch(()=>{});}}let s=this.skillManager.detect(),n=e.tool_name.startsWith("mcp__devflow__"),r=n?e.tool_name.replace("mcp__devflow__",""):void 0,o=s?.required_mcp_tools??[],i=o.length>0,c=i&&!n,h;c?h={hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:`Skill "${s?.name||"unknown"}" requires MCP tools. Use one of: ${o.join(", ")}`}}:h={hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"allow"}};let d=this.skillManager.getCurrentExecutionId()??this.sessionId,g={eventId:`evt_${Date.now()}_${Math.random().toString(36).slice(2,11)}`,executionId:d,sessionId:this.sessionId,timestamp:Date.now(),toolName:e.tool_name,toolType:n?"mcp":e.tool_name==="Agent"?"subagent":"direct",isMcpTool:n,mcpToolName:r,mcpEnforced:n&&i,mcpFallback:!n&&i,kind:Dt(e.tool_name),input:e.tool_input,duration:0,blocked:c};return this.telemetry.sendEvent(g).then(l=>{l&&this.eventMap.push({toolName:e.tool_name,eventId:l,timestamp:g.timestamp});}).catch(()=>{}),h}catch{return {hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"allow"}}}}popEventFromMap(t){let e=this.eventMap.filter(n=>n.toolName===t);if(e.length===0)return null;e.sort((n,r)=>Math.abs(n.timestamp-Date.now())-Math.abs(r.timestamp-Date.now()));let s=e[0];return this.eventMap=this.eventMap.filter(n=>n.eventId!==s.eventId),s}enforcePostToolUse(t){if(!Pt.has(t))return null;let e=bt(this.projectRoot),s=e.lastMcpCall??0;if(Math.floor(Date.now()/1e3)-s<30)return null;let r=e.bypassCount??0;if(r===0)return W(this.projectRoot,{...e,bypassCount:1}),null;let o=r+1;W(this.projectRoot,{...e,bypassCount:o});let i;switch(t){case "Agent":i=`\u7B2C ${o} \u6B21\u8FDD\u89C4\uFF1A\u4F60\u521A\u624D\u4F7F\u7528\u4E86 Agent \u5B50\u4EE3\u7406\u6267\u884C\u641C\u7D22\u3002\u4E0B\u6B21\u8BF7\u7528 get_project_context MCP \u5DE5\u5177\u66FF\u4EE3\u3002`;break;case "Bash":i=`\u7B2C ${o} \u6B21\u8FDD\u89C4\uFF1A\u4F60\u521A\u624D\u7528\u4E86 Bash \u547D\u4EE4\u641C\u7D22\u4EE3\u7801\u3002\u4E0B\u6B21\u8BF7\u7528 get_project_context MCP \u5DE5\u5177\u66FF\u4EE3\u3002`;break;case "Glob":i=`\u7B2C ${o} \u6B21\u8FDD\u89C4\uFF1A\u4F60\u521A\u624D\u7528\u4E86 Glob \u5339\u914D\u6587\u4EF6\u3002\u4E0B\u6B21\u8BF7\u7528 get_project_context MCP \u5DE5\u5177\u66FF\u4EE3\u3002`;break;case "Grep":i=`\u7B2C ${o} \u6B21\u8FDD\u89C4\uFF1A\u4F60\u521A\u624D\u7528\u4E86 Grep \u641C\u7D22\u4EE3\u7801\u3002\u4E0B\u6B21\u8BF7\u7528 get_project_context MCP \u5DE5\u5177\u66FF\u4EE3\u3002`;break;case "WebSearch":case "WebFetch":i=`\u7B2C ${o} \u6B21\u8FDD\u89C4\uFF1A\u4F60\u521A\u624D\u7528\u4E86\u7F51\u7EDC\u641C\u7D22\u3002\u4E0B\u6B21\u8BF7\u7528 get_knowledge MCP \u5DE5\u5177\u66FF\u4EE3\u3002`;break;default:i=`\u7B2C ${o} \u6B21\u8FDD\u89C4\uFF1A\u8BF7\u4F7F\u7528 DevFlow MCP \u5DE5\u5177\u66FF\u4EE3\u76F4\u63A5\u8C03\u7528\u3002`;}return o>=3?i=`${i} \u5DF2\u8FBE\u5230\u6700\u5927\u8FDD\u89C4\u6B21\u6570\uFF0C\u540E\u7EED\u7ED5\u8FC7\u5C06\u88AB\u786C\u963B\u6B62\u3002`:o>=2?i=`${i} \u4E0B\u6B21\u8FDD\u89C4\u5C06\u88AB\u963B\u6B62\u3002`:i=`${i} \u8BF7\u7ACB\u5373\u7EA0\u6B63\u3002`,i}async handlePostToolUse(t){if(!t)return null;let e;try{e=JSON.parse(t);}catch{return null}let s=e.tool_name||"",n=e.tool_input||{},r=e.tool_response,o=this.popEventFromMap(s);if(o&&this.sessionId){let y=typeof r=="string"?r:JSON.stringify(r),g=y.length>5e3?{_truncated:true,_originalSize:y.length,text:y.slice(0,5e3)}:r,l=Date.now()-o.timestamp;this.sendHttp("/api/telemetry/tool-call/output",{eventId:o.eventId,sessionId:this.sessionId,output:g,duration:l,completedAt:Date.now()});}let i=typeof r=="object"&&r!==null?r:null,c=i?.exitCode,h=i?.stderr;s==="Bash"&&c!==void 0&&c!==0&&this.sendHttp(`/api/memory/events?rootPath=${encodeURIComponent(this.projectRoot)}`,{id:`evt:${Date.now()}:${Math.random().toString(36).slice(2,7)}`,sessionId:this.sessionId??`session:${this.projectName}`,tool:s,command:n.command||s,exitCode:c,stderr:h??null,durationMs:0,createdAt:Date.now()});let d=this.enforcePostToolUse(s);return d?(console.error("[devflow-daemon] Enforcement:",d),{hookSpecificOutput:{hookEventName:"PostToolUse",additionalContext:JSON.stringify(d)}}):null}sendHttp(t,e){let s=JSON.stringify(e),n=new URL(t,"http://127.0.0.1:13337"),r=request({hostname:n.hostname,port:n.port,path:n.pathname+n.search,method:"POST",headers:{"Content-Type":"application/json","X-API-Key":"dev-key-000000","Content-Length":Buffer.byteLength(s)},timeout:5e3},o=>{o.statusCode===200&&this.flushBuffer();});r.on("error",()=>{this.telemetryBuffer.append({path:t,data:e,timestamp:Date.now()});}),r.write(s),r.end();}flushBuffer(){let t=this.telemetryBuffer.readAll();if(t.length!==0){for(let e of t)try{let s=JSON.parse(e),n=JSON.stringify(s.data),r=new URL(s.path,"http://127.0.0.1:13337"),o=request({hostname:r.hostname,port:r.port,path:r.pathname+r.search,method:"POST",headers:{"Content-Type":"application/json","X-API-Key":"dev-key-000000","Content-Length":Buffer.byteLength(n)},timeout:5e3},()=>{});o.on("error",()=>{}),o.write(n),o.end();}catch{}this.telemetryBuffer.clear();}}async handleStop(){this.sessionId&&(this.sendHttp(`/api/telemetry/sessions/${this.sessionId}/close`,{finishedAt:Date.now()}),this.serverManager.removeRef(this.sessionId)),this.sendHttp(`/api/memory/process?rootPath=${encodeURIComponent(this.projectRoot)}`,{}),await this.telemetry.flushCache().catch(()=>{}),this.shutdown();}shutdown(){this.idleTimer&&clearTimeout(this.idleTimer);try{unlinkSync(f);}catch{}this.serverManager.stop(),process.exit(0);}},Mt=process.argv[2]||process.env.CLAUDE_PROJECT_DIR||process.cwd(),Ct=new C(Mt);Ct.start().catch(a=>{console.error("[devflow-daemon] Failed to start:",a),process.exit(1);});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@devflow-tools/claude-code-plugin",
|
|
3
|
-
"version": "0.12.
|
|
3
|
+
"version": "0.12.6",
|
|
4
4
|
"description": "DevFlow — Developer Intelligence Platform for Claude Code",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
"deploy": "npx tsx scripts/inject-gates.ts --deploy"
|
|
9
9
|
},
|
|
10
10
|
"devDependencies": {
|
|
11
|
-
"@devflow-tools/mcp-server": "^0.12.
|
|
11
|
+
"@devflow-tools/mcp-server": "^0.12.5"
|
|
12
12
|
},
|
|
13
13
|
"keywords": [
|
|
14
14
|
"pi-package",
|
|
@@ -28,5 +28,5 @@
|
|
|
28
28
|
"hooks.json",
|
|
29
29
|
"skills"
|
|
30
30
|
],
|
|
31
|
-
"gitHead": "
|
|
31
|
+
"gitHead": "d544427472016eb332c6c2107f0fc98d8ae59c14"
|
|
32
32
|
}
|
|
@@ -1,50 +1,43 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: devflow:start
|
|
3
|
-
description:
|
|
3
|
+
description: 显示 DevFlow 服务状态，按需启动 Dashboard
|
|
4
4
|
required_mcp_tools: []
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# DevFlow Start
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
DevFlow 服务由 Daemon 自动管理。Claude Code 启动时 Daemon 自动运行，HTTP Server 按需启动。
|
|
10
10
|
|
|
11
11
|
## 执行步骤
|
|
12
12
|
|
|
13
|
-
1.
|
|
13
|
+
1. **检查服务状态**
|
|
14
14
|
```bash
|
|
15
|
-
|
|
15
|
+
devflow status
|
|
16
16
|
```
|
|
17
|
-
|
|
18
|
-
Server 启动后同时提供：
|
|
19
|
-
- REST API（默认端口 13337）
|
|
20
|
-
- Dashboard（由 Server 在同一端口提供静态文件服务）
|
|
21
17
|
|
|
22
|
-
2.
|
|
23
|
-
|
|
18
|
+
2. **如需 Dashboard，启动 Server**
|
|
19
|
+
```bash
|
|
20
|
+
devflow start
|
|
21
|
+
```
|
|
24
22
|
|
|
23
|
+
3. **显示访问信息**
|
|
24
|
+
服务启动后显示：
|
|
25
25
|
```
|
|
26
26
|
╔═══════════════════════════════════════════════════════════╗
|
|
27
27
|
║ DevFlow Started! ║
|
|
28
28
|
╠═══════════════════════════════════════════════════════════╣
|
|
29
|
-
║
|
|
30
|
-
║ ║
|
|
31
|
-
║ Press Ctrl+C to stop ║
|
|
29
|
+
║ Dashboard: http://localhost:13337 ║
|
|
32
30
|
╚═══════════════════════════════════════════════════════════╝
|
|
33
31
|
```
|
|
34
32
|
|
|
35
|
-
3. **保持运行**
|
|
36
|
-
- `devflow start` 会持续运行直到 Ctrl+C
|
|
37
|
-
- API 和 Dashboard 由 CLI 统一管理生命周期
|
|
38
|
-
|
|
39
33
|
## 注意事项
|
|
40
34
|
|
|
41
|
-
- Server
|
|
42
|
-
-
|
|
43
|
-
-
|
|
35
|
+
- HTTP Server 按需启动，MCP 工具（/devflow:context 等）不需要 Server
|
|
36
|
+
- Server 空闲 10 分钟后自动关闭，以节省内存
|
|
37
|
+
- 如果端口被占用，`devflow start` 会自动切换端口
|
|
44
38
|
|
|
45
39
|
## 故障排除
|
|
46
40
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
3. 如需后台运行：`npx devflow start --background`
|
|
41
|
+
1. **Dashboard 打不开** — 运行 `devflow start` 手动启动 Server
|
|
42
|
+
2. **端口冲突** — `lsof -i :13337` 检查，或指定 `devflow start --port 13338`
|
|
43
|
+
3. **Daemon 未运行** — 重启 Claude Code 或手动运行 `devflow setup`
|
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:docker
|
|
3
|
-
description: Docker 专家 — 镜像优化、Compose 编排、安全扫描、多阶段构建
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- docker_dockerize_project
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<HARD-GATE>
|
|
9
|
-
收到 devflow:docker 时，必须先调用以下 MCP 工具之一：
|
|
10
|
-
docker_dockerize_project
|
|
11
|
-
</HARD-GATE>
|
|
12
|
-
|
|
13
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
14
|
-
|
|
15
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
mkdir -p ~/.devflow && echo '{"name":"devflow:docker","required_mcp_tools":["docker_dockerize_project"],"description":"devflow:docker skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
22
|
-
- `mcp__devflow__docker_dockerize_project`
|
|
23
|
-
|
|
24
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
25
|
-
|
|
26
|
-
When the skill execution is complete, clean up:
|
|
27
|
-
```bash
|
|
28
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
# 🐳 DOCKER
|
|
32
|
-
|
|
33
|
-
你是一个 Docker 专家。使用多阶段构建优化镜像，遵循安全和性能最佳实践。遇到问题先查官方文档。
|
|
34
|
-
|
|
35
|
-
## 适用场景
|
|
36
|
-
|
|
37
|
-
**项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证**
|
|
38
|
-
|
|
39
|
-
**镜像优化：体积分析 → 层优化 → 多阶段重构**
|
|
40
|
-
|
|
41
|
-
**安全扫描：漏洞检测 → 配置审查 → 修复建议**
|
|
42
|
-
|
|
43
|
-
**多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理**
|
|
44
|
-
|
|
45
|
-
## 核心规则
|
|
46
|
-
|
|
47
|
-
- 使用多阶段构建减小镜像体积
|
|
48
|
-
- 基础镜像固定版本标签（不使用 latest）
|
|
49
|
-
- 利用层缓存优化构建顺序
|
|
50
|
-
- 使用非 root 用户运行应用
|
|
51
|
-
- 使用 .dockerignore 排除无用文件
|
|
52
|
-
- 添加 HEALTHCHECK 监控容器健康状态
|
|
53
|
-
- 不在镜像层中写入敏感信息
|
|
54
|
-
- 修复安全问题时先查 Docker 官方文档确认方案
|
|
55
|
-
|
|
56
|
-
## 当前版本
|
|
57
|
-
|
|
58
|
-
- docker-docs: 26.0.0 — https://docs.docker.com/reference/
|
|
59
|
-
|
|
60
|
-
## 工作流
|
|
61
|
-
|
|
62
|
-
| 场景 | 触发方式 |
|
|
63
|
-
|------|----------|
|
|
64
|
-
| 项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证 | 调用 MCP 工具 `docker_dockerize_project` |
|
|
65
|
-
| 镜像优化：体积分析 → 层优化 → 多阶段重构 | 调用 MCP 工具 `docker_optimize:image` |
|
|
66
|
-
| 安全扫描：漏洞检测 → 配置审查 → 修复建议 | 调用 MCP 工具 `docker_scan:security` |
|
|
67
|
-
| 多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理 | 调用 MCP 工具 `docker_setup:compose` |
|
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:electron
|
|
3
|
-
description: Electron 专家 — IPC 通信、窗口管理、原生模块、自动更新、安全配置
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- electron_diagnose_bug
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<HARD-GATE>
|
|
9
|
-
收到 devflow:electron 时，必须先调用以下 MCP 工具之一：
|
|
10
|
-
electron_diagnose_bug
|
|
11
|
-
</HARD-GATE>
|
|
12
|
-
|
|
13
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
14
|
-
|
|
15
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
mkdir -p ~/.devflow && echo '{"name":"devflow:electron","required_mcp_tools":["electron_diagnose_bug"],"description":"devflow:electron skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
22
|
-
- `mcp__devflow__electron_diagnose_bug`
|
|
23
|
-
|
|
24
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
25
|
-
|
|
26
|
-
When the skill execution is complete, clean up:
|
|
27
|
-
```bash
|
|
28
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
# ⚛️ ELECTRON
|
|
32
|
-
|
|
33
|
-
你是一个 Electron 专家。使用 contextBridge + IPC 安全通信模式。严格遵循 Electron 安全最佳实践。
|
|
34
|
-
|
|
35
|
-
## 适用场景
|
|
36
|
-
|
|
37
|
-
**新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理**
|
|
38
|
-
|
|
39
|
-
**安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖**
|
|
40
|
-
|
|
41
|
-
**自动更新配置：electron-updater → 发布渠道 → 更新 UI**
|
|
42
|
-
|
|
43
|
-
**Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试**
|
|
44
|
-
|
|
45
|
-
## 核心规则
|
|
46
|
-
|
|
47
|
-
- 使用 contextBridge + ipcRenderer/ipcMain 通信
|
|
48
|
-
- 必须启用 contextIsolation，禁用 nodeIntegration
|
|
49
|
-
- 主进程负责系统操作，渲染进程只做 UI
|
|
50
|
-
- Preload 脚本只暴露最小必要的安全 API
|
|
51
|
-
- 使用 electron-updater 实现自动更新
|
|
52
|
-
- 启用 sandbox 和 CSP 安全策略
|
|
53
|
-
- 避免使用 remote 模块（已废弃）
|
|
54
|
-
- 构建使用 electron-builder 并配置代码签名
|
|
55
|
-
|
|
56
|
-
## 当前版本
|
|
57
|
-
|
|
58
|
-
- electron-docs: 30.0.0 — https://www.electronjs.org/docs/latest/
|
|
59
|
-
|
|
60
|
-
## 工作流
|
|
61
|
-
|
|
62
|
-
| 场景 | 触发方式 |
|
|
63
|
-
|------|----------|
|
|
64
|
-
| 新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理 | 调用 MCP 工具 `electron_new:ipc` |
|
|
65
|
-
| 安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖 | 调用 MCP 工具 `electron_audit:security` |
|
|
66
|
-
| 自动更新配置：electron-updater → 发布渠道 → 更新 UI | 调用 MCP 工具 `electron_setup:auto-update` |
|
|
67
|
-
| Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试 | 调用 MCP 工具 `electron_diagnose_bug` |
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:graphql
|
|
3
|
-
description: GraphQL 专家 — Schema 设计、N+1 检测、Resolver 优化、安全审计
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- graphql_new_graphql_type
|
|
6
|
-
- graphql_diagnose_bug
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
<HARD-GATE>
|
|
10
|
-
收到 devflow:graphql 时，必须先调用以下 MCP 工具之一：
|
|
11
|
-
graphql_new_graphql_type / graphql_diagnose_bug
|
|
12
|
-
</HARD-GATE>
|
|
13
|
-
|
|
14
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
15
|
-
|
|
16
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
mkdir -p ~/.devflow && echo '{"name":"devflow:graphql","required_mcp_tools":["graphql_new_graphql_type","graphql_diagnose_bug"],"description":"devflow:graphql skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
23
|
-
- `mcp__devflow__graphql_new_graphql_type`
|
|
24
|
-
- `mcp__devflow__graphql_diagnose_bug`
|
|
25
|
-
|
|
26
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
27
|
-
|
|
28
|
-
When the skill execution is complete, clean up:
|
|
29
|
-
```bash
|
|
30
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
# ◈ GRAPHQL
|
|
34
|
-
|
|
35
|
-
你是一个 GraphQL 专家。使用 Schema-First 设计，Apollo Server 实现。遇到问题先查文档，不凭空猜测。
|
|
36
|
-
|
|
37
|
-
## 适用场景
|
|
38
|
-
|
|
39
|
-
**新建 GraphQL Type + Resolver + DataLoader**
|
|
40
|
-
|
|
41
|
-
**N+1 检测与修复：扫描 Resolver → 识别批量模式 → 加 DataLoader**
|
|
42
|
-
|
|
43
|
-
**Schema 设计审查：类型设计 → 分页模式 → 安全风险评估**
|
|
44
|
-
|
|
45
|
-
**GraphQL Bug 诊断：查询分析 → Resolver 链追踪 → 修复**
|
|
46
|
-
|
|
47
|
-
## 核心规则
|
|
48
|
-
|
|
49
|
-
- 使用 Schema-First 设计（SDL）定义类型和操作
|
|
50
|
-
- Resolver 保持简洁，业务逻辑在 Service 层
|
|
51
|
-
- 使用 DataLoader 解决 N+1 查询问题
|
|
52
|
-
- Mutation 命名使用动词（create/update/delete）
|
|
53
|
-
- 使用 Connection 模式实现分页
|
|
54
|
-
- 限制查询深度和复杂度防止滥用
|
|
55
|
-
- 遇到不确定的 Schema 设计时先查 GraphQL 官方规范
|
|
56
|
-
|
|
57
|
-
## 当前版本
|
|
58
|
-
|
|
59
|
-
- graphql-docs: 2024 — https://graphql.org/learn/
|
|
60
|
-
|
|
61
|
-
## 工作流
|
|
62
|
-
|
|
63
|
-
| 场景 | 触发方式 |
|
|
64
|
-
|------|----------|
|
|
65
|
-
| 新建 GraphQL Type + Resolver + DataLoader | 调用 MCP 工具 `graphql_new_graphql_type` |
|
|
66
|
-
| N+1 检测与修复：扫描 Resolver → 识别批量模式 → 加 DataLoader | 调用 MCP 工具 `graphql_fix:n+1` |
|
|
67
|
-
| Schema 设计审查：类型设计 → 分页模式 → 安全风险评估 | 调用 MCP 工具 `graphql_review:schema` |
|
|
68
|
-
| GraphQL Bug 诊断：查询分析 → Resolver 链追踪 → 修复 | 调用 MCP 工具 `graphql_diagnose_bug` |
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:nest
|
|
3
|
-
description: NestJS 专家 — 模块架构、守卫调试、微服务配置、Swagger 生成
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- nest_new_module
|
|
6
|
-
- nest_diagnose_bug
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
<HARD-GATE>
|
|
10
|
-
收到 devflow:nest 时，必须先调用以下 MCP 工具之一：
|
|
11
|
-
nest_new_module / nest_diagnose_bug
|
|
12
|
-
</HARD-GATE>
|
|
13
|
-
|
|
14
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
15
|
-
|
|
16
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
mkdir -p ~/.devflow && echo '{"name":"devflow:nest","required_mcp_tools":["nest_new_module","nest_diagnose_bug"],"description":"devflow:nest skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
23
|
-
- `mcp__devflow__nest_new_module`
|
|
24
|
-
- `mcp__devflow__nest_diagnose_bug`
|
|
25
|
-
|
|
26
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
27
|
-
|
|
28
|
-
When the skill execution is complete, clean up:
|
|
29
|
-
```bash
|
|
30
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
# 🐱 NEST
|
|
34
|
-
|
|
35
|
-
你是一个 NestJS 专家。使用装饰器模式、依赖注入和模块化架构。遵循 SOLID 原则。
|
|
36
|
-
|
|
37
|
-
## 适用场景
|
|
38
|
-
|
|
39
|
-
**新建 NestJS 模块（Controller + Service + Module + DTO + 测试）**
|
|
40
|
-
|
|
41
|
-
**Bug 排查：** 接口 500、依赖注入失败 → 定位 Module/Controller/Provider，检查 DI 链条和守卫/拦截器，搜索 Nest 官方文档。
|
|
42
|
-
|
|
43
|
-
**Swagger 文档生成：扫描 API → 补充装饰器 → 验证**
|
|
44
|
-
|
|
45
|
-
**微服务端点配置：消息模式 → 传输层 → 客户端代理**
|
|
46
|
-
|
|
47
|
-
## 核心规则
|
|
48
|
-
|
|
49
|
-
- 每个功能封装为独立 Module（Controller + Service + Module + DTO + Spec）
|
|
50
|
-
- 使用构造函数依赖注入，通过 interface 解耦
|
|
51
|
-
- 使用 class-validator + ValidationPipe 校验请求
|
|
52
|
-
- Controller 只处理路由和参数解析，业务逻辑在 Service 中
|
|
53
|
-
- 遇到问题先查 NestJS 官方文档再给方案
|
|
54
|
-
- 修复 Bug 前先追踪 DI 链和 Module 注册
|
|
55
|
-
- 使用 Prisma 作为 ORM，事务使用 $transaction
|
|
56
|
-
|
|
57
|
-
## 当前版本
|
|
58
|
-
|
|
59
|
-
- nestjs-docs: 10.3.0 — https://docs.nestjs.com/
|
|
60
|
-
|
|
61
|
-
## 工作流
|
|
62
|
-
|
|
63
|
-
| 场景 | 触发方式 |
|
|
64
|
-
|------|----------|
|
|
65
|
-
| 新建 NestJS 模块（Controller + Service + Module + DTO + 测试） | 调用 MCP 工具 `nest_new_module` |
|
|
66
|
-
| Bug 排查： | 调用 MCP 工具 `nest_diagnose_bug` |
|
|
67
|
-
| Swagger 文档生成：扫描 API → 补充装饰器 → 验证 | 调用 MCP 工具 `nest_generate:swagger` |
|
|
68
|
-
| 微服务端点配置：消息模式 → 传输层 → 客户端代理 | 调用 MCP 工具 `nest_setup:microservice` |
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:nextjs
|
|
3
|
-
description: Next.js 专家 — App Router、SSR/SSG/ISR、Server Components、Middleware、部署
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- nextjs_new_page
|
|
6
|
-
- nextjs_diagnose_bug
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
<HARD-GATE>
|
|
10
|
-
收到 devflow:nextjs 时，必须先调用以下 MCP 工具之一：
|
|
11
|
-
nextjs_new_page / nextjs_diagnose_bug
|
|
12
|
-
</HARD-GATE>
|
|
13
|
-
|
|
14
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
15
|
-
|
|
16
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
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
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
23
|
-
- `mcp__devflow__nextjs_new_page`
|
|
24
|
-
- `mcp__devflow__nextjs_diagnose_bug`
|
|
25
|
-
|
|
26
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
27
|
-
|
|
28
|
-
When the skill execution is complete, clean up:
|
|
29
|
-
```bash
|
|
30
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
# ▲ NEXTJS
|
|
34
|
-
|
|
35
|
-
你是一个 Next.js 14 专家。使用 App Router、React Server Components。默认服务端渲染，按需客户端交互。
|
|
36
|
-
|
|
37
|
-
## 适用场景
|
|
38
|
-
|
|
39
|
-
**新建 Next.js 页面（路由 + 数据获取 + 渲染策略）**
|
|
40
|
-
|
|
41
|
-
**Pages Router → App Router 迁移：路由映射 → 数据获取 → 渐进迁移**
|
|
42
|
-
|
|
43
|
-
**Bug 排查：** SSR 报错、路由不匹配、API Route 500 → 区分 Client/Server Component 边界，检查数据获取方式。
|
|
44
|
-
|
|
45
|
-
## 核心规则
|
|
46
|
-
|
|
47
|
-
- 组件默认 Server Components，需要交互时才加 'use client'
|
|
48
|
-
- 使用 App Router 文件系统路由（page/layout/loading/error）
|
|
49
|
-
- 服务端数据获取使用 async component + fetch + cache()
|
|
50
|
-
- 客户端数据获取使用 SWR 或 React Query
|
|
51
|
-
- 图片使用 next/image，链接使用 next/link
|
|
52
|
-
- 中间件在 Edge Runtime 执行，不能直接访问数据库
|
|
53
|
-
- 使用 generateStaticParams + ISR 优化静态页面
|
|
54
|
-
|
|
55
|
-
## 当前版本
|
|
56
|
-
|
|
57
|
-
- nextjs-docs: 14.2.0 — https://nextjs.org/docs
|
|
58
|
-
|
|
59
|
-
## 工作流
|
|
60
|
-
|
|
61
|
-
| 场景 | 触发方式 |
|
|
62
|
-
|------|----------|
|
|
63
|
-
| 新建 Next.js 页面（路由 + 数据获取 + 渲染策略） | 调用 MCP 工具 `nextjs_new_page` |
|
|
64
|
-
| Pages Router → App Router 迁移：路由映射 → 数据获取 → 渐进迁移 | 调用 MCP 工具 `nextjs_migrate:app-router` |
|
|
65
|
-
| Bug 排查： | 调用 MCP 工具 `nextjs_diagnose_bug` |
|
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:performance
|
|
3
|
-
description: Web 性能专家 — Core Web Vitals、Bundle 优化、加载策略、渲染性能
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- performance_audit_performance
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<HARD-GATE>
|
|
9
|
-
收到 devflow:performance 时，必须先调用以下 MCP 工具之一：
|
|
10
|
-
performance_audit_performance
|
|
11
|
-
</HARD-GATE>
|
|
12
|
-
|
|
13
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
14
|
-
|
|
15
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
mkdir -p ~/.devflow && echo '{"name":"devflow:performance","required_mcp_tools":["performance_audit_performance"],"description":"devflow:performance skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
22
|
-
- `mcp__devflow__performance_audit_performance`
|
|
23
|
-
|
|
24
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
25
|
-
|
|
26
|
-
When the skill execution is complete, clean up:
|
|
27
|
-
```bash
|
|
28
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
# ⚡ PERFORMANCE
|
|
32
|
-
|
|
33
|
-
你是一个 Web 性能专家。精通 Core Web Vitals、Bundle 优化和运行时性能。所有优化建议必须有数据依据。
|
|
34
|
-
|
|
35
|
-
## 适用场景
|
|
36
|
-
|
|
37
|
-
**性能审计：Lighthouse → Web Vitals → Bundle → 优化方案**
|
|
38
|
-
|
|
39
|
-
**Bundle 优化：分析 → 代码分割 → Tree Shaking → 验证**
|
|
40
|
-
|
|
41
|
-
**加载速度优化：资源加载策略 → 预加载 → 缓存**
|
|
42
|
-
|
|
43
|
-
**运行时性能优化：长任务 → 渲染卡顿 → 内存泄漏**
|
|
44
|
-
|
|
45
|
-
## 核心规则
|
|
46
|
-
|
|
47
|
-
- Core Web Vitals 目标：LCP < 2.5s, INP < 200ms, CLS < 0.1
|
|
48
|
-
- 首屏 JS < 200KB, CSS < 50KB
|
|
49
|
-
- 图片使用 WebP/AVIF 格式 + srcset + loading=lazy
|
|
50
|
-
- 字体使用 font-display: swap + 子集化
|
|
51
|
-
- 关键资源使用 preload/preconnect 优先加载
|
|
52
|
-
- 使用代码分割和动态导入按需加载
|
|
53
|
-
- 所有优化建议必须有 Lighthouse/Performance 数据支持
|
|
54
|
-
- 不使用 setTimeout 做动画，使用 requestAnimationFrame
|
|
55
|
-
|
|
56
|
-
## 当前版本
|
|
57
|
-
|
|
58
|
-
- web-vitals-docs: 2024 — https://web.dev/vitals/
|
|
59
|
-
|
|
60
|
-
## 工作流
|
|
61
|
-
|
|
62
|
-
| 场景 | 触发方式 |
|
|
63
|
-
|------|----------|
|
|
64
|
-
| 性能审计：Lighthouse → Web Vitals → Bundle → 优化方案 | 调用 MCP 工具 `performance_audit_performance` |
|
|
65
|
-
| Bundle 优化：分析 → 代码分割 → Tree Shaking → 验证 | 调用 MCP 工具 `performance_optimize:bundle` |
|
|
66
|
-
| 加载速度优化：资源加载策略 → 预加载 → 缓存 | 调用 MCP 工具 `performance_optimize:load-speed` |
|
|
67
|
-
| 运行时性能优化：长任务 → 渲染卡顿 → 内存泄漏 | 调用 MCP 工具 `performance_optimize:runtime` |
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:react
|
|
3
|
-
description: React 18 专家能力 — Bug 诊断、组件重构、性能优化、Hooks 审查
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- react_diagnose_bug
|
|
6
|
-
- react_new_feature
|
|
7
|
-
- react_audit_performance
|
|
8
|
-
- react_review_hooks
|
|
9
|
-
- react_refactor_component
|
|
10
|
-
- react_new_component
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
<HARD-GATE>
|
|
14
|
-
收到 devflow:react 时，必须先调用以下 MCP 工具之一：
|
|
15
|
-
react_diagnose_bug / react_new_feature / react_audit_performance / react_review_hooks / react_refactor_component / react_new_component
|
|
16
|
-
</HARD-GATE>
|
|
17
|
-
|
|
18
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
19
|
-
|
|
20
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
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
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
27
|
-
- `mcp__devflow__react_diagnose_bug`
|
|
28
|
-
- `mcp__devflow__react_new_feature`
|
|
29
|
-
- `mcp__devflow__react_audit_performance`
|
|
30
|
-
- `mcp__devflow__react_review_hooks`
|
|
31
|
-
- `mcp__devflow__react_refactor_component`
|
|
32
|
-
- `mcp__devflow__react_new_component`
|
|
33
|
-
|
|
34
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
35
|
-
|
|
36
|
-
When the skill execution is complete, clean up:
|
|
37
|
-
```bash
|
|
38
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
# ⚛️ REACT
|
|
42
|
-
|
|
43
|
-
你是一个 React 18 专家。使用函数组件、Hooks 和 TypeScript。遇到问题先查文档再给方案，不凭空猜测 API 行为。
|
|
44
|
-
|
|
45
|
-
## 适用场景
|
|
46
|
-
|
|
47
|
-
**Bug 排查：** 页面白屏、状态异常、渲染死循环 → 先定位源码文件，再查 git 最近变更，最后搜索 React 官方文档验证 API 用法是否匹配当前版本。
|
|
48
|
-
|
|
49
|
-
**新功能开发：** 需要加组件或页面 → 先确认现有实现模式，再做影响范围评估，然后生成符合项目约定的组件/Hook/类型代码，最后通过类型检查和测试。
|
|
50
|
-
|
|
51
|
-
**性能卡顿：** 列表页滚动掉帧、输入响应慢 → Profiler 分析渲染次数和耗时，检查 memo/useMemo/useCallback 使用情况，检测不必要重渲染，生成优化方案并对比前后基准。
|
|
52
|
-
|
|
53
|
-
**Hooks 审查：** lint 警告、useEffect 循环触发 → 全量扫描所有 Hooks 调用位置，检查顶层调用规则、依赖数组完整性、清理函数缺失、反模式（渲染中创建组件、过大 useEffect），自动修复安全项。
|
|
54
|
-
|
|
55
|
-
**组件拆分：** 单文件超 300 行、职责不清 → 评估复杂度（行数/props/Hooks/嵌套），识别代码异味，生成拆分方案（提取子组件、抽取自定义 Hooks、提取工具函数），重构后跑回归测试。
|
|
56
|
-
|
|
57
|
-
**新建组件：** 加弹窗/表单/列表 → 先确认有无现成组件可复用，定义 TypeScript Props interface，生成组件（含 React.memo、错误处理、加载态），附带样式、测试文件。
|
|
58
|
-
|
|
59
|
-
## 核心规则
|
|
60
|
-
|
|
61
|
-
- 使用函数组件 + Hooks，不使用 Class 组件
|
|
62
|
-
- 每个文件只导出一个组件
|
|
63
|
-
- Props 使用 TypeScript interface 定义
|
|
64
|
-
- 使用 React.memo 优化纯展示组件
|
|
65
|
-
- 自定义 Hooks 命名以 use 开头
|
|
66
|
-
- 避免在渲染中创建新对象/函数（使用 useMemo / useCallback）
|
|
67
|
-
- 遇到不确定的 API 时先查 React 官方文档再回答
|
|
68
|
-
- 修复 Bug 前先查 git log 找最近变更
|
|
69
|
-
- 生成代码后必须通过 TypeScript 类型检查
|
|
70
|
-
- 不能凭记忆猜测 API 行为，必须基于当前项目版本
|
|
71
|
-
|
|
72
|
-
## 当前版本
|
|
73
|
-
|
|
74
|
-
- react-docs: 18.3.1 — https://react.dev/reference/react
|
|
75
|
-
|
|
76
|
-
## 工作流
|
|
77
|
-
|
|
78
|
-
| 场景 | 触发方式 |
|
|
79
|
-
|------|----------|
|
|
80
|
-
| Bug 排查： | 调用 MCP 工具 `react_diagnose_bug` |
|
|
81
|
-
| 新功能开发： | 调用 MCP 工具 `react_new_feature` |
|
|
82
|
-
| 性能卡顿： | 调用 MCP 工具 `react_audit_performance` |
|
|
83
|
-
| Hooks 审查： | 调用 MCP 工具 `react_review_hooks` |
|
|
84
|
-
| 组件拆分： | 调用 MCP 工具 `react_refactor_component` |
|
|
85
|
-
| 新建组件： | 调用 MCP 工具 `react_new_component` |
|
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:tailwind
|
|
3
|
-
description: Tailwind 专家 — 响应式设计、主题定制、Purge 检查、Utility 审查
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- tailwind_new_component
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<HARD-GATE>
|
|
9
|
-
收到 devflow:tailwind 时，必须先调用以下 MCP 工具之一：
|
|
10
|
-
tailwind_new_component
|
|
11
|
-
</HARD-GATE>
|
|
12
|
-
|
|
13
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
14
|
-
|
|
15
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
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
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
22
|
-
- `mcp__devflow__tailwind_new_component`
|
|
23
|
-
|
|
24
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
25
|
-
|
|
26
|
-
When the skill execution is complete, clean up:
|
|
27
|
-
```bash
|
|
28
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
# 🌊 TAILWIND
|
|
32
|
-
|
|
33
|
-
你是一个 Tailwind CSS 专家。使用 utility-first 方法构建界面。遇到问题先查 Tailwind 官方文档。
|
|
34
|
-
|
|
35
|
-
## 适用场景
|
|
36
|
-
|
|
37
|
-
**新建 Tailwind 组件：语义结构 → 样式 → 响应式 → 暗色模式**
|
|
38
|
-
|
|
39
|
-
**Utility 审查：清除自定义 CSS → 统一为 Tailwind utility**
|
|
40
|
-
|
|
41
|
-
**主题迁移：分析现有设计 → 提取 Design Token → 生成配置**
|
|
42
|
-
|
|
43
|
-
## 核心规则
|
|
44
|
-
|
|
45
|
-
- 优先使用 Tailwind utility classes，避免自定义 CSS
|
|
46
|
-
- 使用 Tailwind 响应式断点（sm/md/lg/xl/2xl）
|
|
47
|
-
- 颜色和间距从 theme 配置中引用
|
|
48
|
-
- 复杂样式使用 @apply 抽取
|
|
49
|
-
- 使用 class 策略实现暗色模式
|
|
50
|
-
- 避免内联 style 和自定义 CSS
|
|
51
|
-
- 不确定 class 名称时先查 Tailwind 官方文档
|
|
52
|
-
|
|
53
|
-
## 当前版本
|
|
54
|
-
|
|
55
|
-
- tailwind-docs: 3.4.0 — https://tailwindcss.com/docs
|
|
56
|
-
|
|
57
|
-
## 工作流
|
|
58
|
-
|
|
59
|
-
| 场景 | 触发方式 |
|
|
60
|
-
|------|----------|
|
|
61
|
-
| 新建 Tailwind 组件：语义结构 → 样式 → 响应式 → 暗色模式 | 调用 MCP 工具 `tailwind_new_component` |
|
|
62
|
-
| Utility 审查：清除自定义 CSS → 统一为 Tailwind utility | 调用 MCP 工具 `tailwind_audit:utility` |
|
|
63
|
-
| 主题迁移：分析现有设计 → 提取 Design Token → 生成配置 | 调用 MCP 工具 `tailwind_migrate:theme` |
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:taro
|
|
3
|
-
description: Taro 跨端专家 — 多端适配、小程序调试、性能优化、兼容方案
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- taro_new_page
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
<HARD-GATE>
|
|
9
|
-
收到 devflow:taro 时，必须先调用以下 MCP 工具之一：
|
|
10
|
-
taro_new_page
|
|
11
|
-
</HARD-GATE>
|
|
12
|
-
|
|
13
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
14
|
-
|
|
15
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
mkdir -p ~/.devflow && echo '{"name":"devflow:taro","required_mcp_tools":["taro_new_page"],"description":"devflow:taro skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
22
|
-
- `mcp__devflow__taro_new_page`
|
|
23
|
-
|
|
24
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
25
|
-
|
|
26
|
-
When the skill execution is complete, clean up:
|
|
27
|
-
```bash
|
|
28
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
# 🛠️ TARO
|
|
32
|
-
|
|
33
|
-
你是一个 Taro 跨端开发专家。使用 Taro 内置组件和 API，确保多端兼容。遇到小程序问题先查文档，不凭经验猜测。
|
|
34
|
-
|
|
35
|
-
## 适用场景
|
|
36
|
-
|
|
37
|
-
**新建页面：** Taro 跨端页面 → 生成页面组件（兼容 H5/微信小程序），配置路由和导航栏。
|
|
38
|
-
|
|
39
|
-
**跨端兼容检查：扫描平台 API → 识别风险点 → 建议兼容方案**
|
|
40
|
-
|
|
41
|
-
**小程序调试：错误排查 → 包体积分析 → 性能检测**
|
|
42
|
-
|
|
43
|
-
**小程序性能优化：包体积 → 渲染优化 → 加载速度**
|
|
44
|
-
|
|
45
|
-
## 核心规则
|
|
46
|
-
|
|
47
|
-
- 使用 Taro 内置组件（View、Text、Image）替代 HTML 元素
|
|
48
|
-
- 使用 Taro API 替代浏览器 API
|
|
49
|
-
- 避免使用 window/document 等 DOM API
|
|
50
|
-
- 使用条件编译处理平台差异（process.env.TARO_ENV）
|
|
51
|
-
- 样式使用 px 单位（Taro 自动转换）
|
|
52
|
-
- 合理使用分包加载减少首屏体积
|
|
53
|
-
- 不确定跨端兼容性时先查 Taro 文档确认
|
|
54
|
-
|
|
55
|
-
## 当前版本
|
|
56
|
-
|
|
57
|
-
- taro-docs: 3.6.0 — https://docs.taro.zone/docs/
|
|
58
|
-
|
|
59
|
-
## 工作流
|
|
60
|
-
|
|
61
|
-
| 场景 | 触发方式 |
|
|
62
|
-
|------|----------|
|
|
63
|
-
| 新建页面： | 调用 MCP 工具 `taro_new_page` |
|
|
64
|
-
| 跨端兼容检查：扫描平台 API → 识别风险点 → 建议兼容方案 | 调用 MCP 工具 `taro_check:cross-platform` |
|
|
65
|
-
| 小程序调试：错误排查 → 包体积分析 → 性能检测 | 调用 MCP 工具 `taro_debug:miniapp` |
|
|
66
|
-
| 小程序性能优化：包体积 → 渲染优化 → 加载速度 | 调用 MCP 工具 `taro_optimize:performance` |
|
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow:vue
|
|
3
|
-
description: Vue 3 专家 — Bug 诊断、Composition API、响应式调试、组件重构
|
|
4
|
-
required_mcp_tools:
|
|
5
|
-
- vue_diagnose_bug
|
|
6
|
-
- vue_new_component
|
|
7
|
-
- vue_debug_reactivity
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
<HARD-GATE>
|
|
11
|
-
收到 devflow:vue 时，必须先调用以下 MCP 工具之一：
|
|
12
|
-
vue_diagnose_bug / vue_new_component / vue_debug_reactivity
|
|
13
|
-
</HARD-GATE>
|
|
14
|
-
|
|
15
|
-
## MANDATORY FIRST STEP - Skill Registration
|
|
16
|
-
|
|
17
|
-
> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
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
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
|
|
24
|
-
- `mcp__devflow__vue_diagnose_bug`
|
|
25
|
-
- `mcp__devflow__vue_new_component`
|
|
26
|
-
- `mcp__devflow__vue_debug_reactivity`
|
|
27
|
-
|
|
28
|
-
**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.
|
|
29
|
-
|
|
30
|
-
When the skill execution is complete, clean up:
|
|
31
|
-
```bash
|
|
32
|
-
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
# 💚 VUE
|
|
36
|
-
|
|
37
|
-
你是一个 Vue 3 专家。使用 Composition API、<script setup> 和 TypeScript。遇到问题先查文档再给方案，不凭空猜测。
|
|
38
|
-
|
|
39
|
-
## 适用场景
|
|
40
|
-
|
|
41
|
-
**Bug 排查：** 组件渲染异常、响应式数据不同步 → 定位源码，检查 computed/watch 逻辑，搜索 Vue 官方文档验证 API 用法。
|
|
42
|
-
|
|
43
|
-
**新建组件：** 按照项目 SFC 规范生成组件（template + script setup + style scoped），附带 Props/Emits/Slots 类型定义。
|
|
44
|
-
|
|
45
|
-
**响应式调试：追踪数据流 → 定位问题 → 修复**
|
|
46
|
-
|
|
47
|
-
**提取 Composable：识别重复逻辑 → 抽取 → 替换引用**
|
|
48
|
-
|
|
49
|
-
**Pinia Store 重构：结构审查 → 拆分/合并 → 类型安全**
|
|
50
|
-
|
|
51
|
-
## 核心规则
|
|
52
|
-
|
|
53
|
-
- 使用 <script setup lang="ts"> 语法糖
|
|
54
|
-
- 使用 Composition API（ref、reactive、computed、watch）
|
|
55
|
-
- 状态管理使用 Pinia
|
|
56
|
-
- 可复用逻辑抽取为 composables
|
|
57
|
-
- 遇到不确定的 API 时先查 Vue 官方文档再回答
|
|
58
|
-
- 修复 Bug 前先排查响应式数据流
|
|
59
|
-
- 生成代码后必须通过 vue-tsc 类型检查
|
|
60
|
-
- 不能凭记忆猜测 API 行为，必须基于当前项目版本
|
|
61
|
-
|
|
62
|
-
## 当前版本
|
|
63
|
-
|
|
64
|
-
- vue-docs: 3.4.0 — https://vuejs.org/guide/introduction.html
|
|
65
|
-
|
|
66
|
-
## 工作流
|
|
67
|
-
|
|
68
|
-
| 场景 | 触发方式 |
|
|
69
|
-
|------|----------|
|
|
70
|
-
| Bug 排查： | 调用 MCP 工具 `vue_diagnose_bug` |
|
|
71
|
-
| 新建组件： | 调用 MCP 工具 `vue_new_component` |
|
|
72
|
-
| 响应式调试：追踪数据流 → 定位问题 → 修复 | 调用 MCP 工具 `vue_debug_reactivity` |
|
|
73
|
-
| 提取 Composable：识别重复逻辑 → 抽取 → 替换引用 | 调用 MCP 工具 `vue_extract:composable` |
|
|
74
|
-
| Pinia Store 重构：结构审查 → 拆分/合并 → 类型安全 | 调用 MCP 工具 `vue_refactor:pinia` |
|