1. 项目概述这不是一个“模板库”而是一套可落地的 Claude 代码工程化工作流“claude-code-templates”这个名称听起来像是一堆静态的代码片段合集但实际接触过 Anthropic 生态的开发者很快就会意识到——它根本不是那种 CtrlC/CtrlV 的速查手册。我去年在给一家做金融合规 SaaS 的客户做 AI 工程化咨询时第一次被要求“基于 Claude 构建可审计、可复现、可灰度发布的代码生成流水线”当时翻遍 GitHub 和官方文档发现所有所谓“Claude 模板”都卡在同一个死结上它们只管 prompt 写得漂不漂亮却没人解决“怎么让这段 prompt 在 CI/CD 里稳定跑通”“怎么把生成结果自动注入到已有代码仓库的指定分支”“怎么在不暴露 API Key 的前提下让测试环境也能调用”这些真正在产线卡脖子的问题。后来我们团队花了三个月从零搭起一套基于 CLI npm 包管理 MCP 协议桥接的标准化工作流核心就是把“模板”这个词彻底重定义模板 可参数化配置的执行单元 可版本锁定的依赖声明 可嵌入现有构建链路的命令入口。它不提供“如何写 Python 爬虫”的答案而是提供“如何让爬虫生成任务在 Jenkins 上每小时自动触发、失败自动告警、输出自动归档到 Nexus 仓库”的完整路径。关键词里的CLI是它的操作界面npm是它的分发与依赖治理中枢MCP是它和本地开发工具如 VS Code 插件、Playwright 测试框架、Obsidian 笔记系统打通的神经协议而Anthropic则是它背后那个必须被严格隔离、受控调用的黑盒服务。如果你还在用 curl 手动拼接 API 请求、用文本文件存 prompt、靠人工复制粘贴生成结果——这套体系会直接把你从“AI 玩家”拉回“AI 工程师”的轨道上。它适合三类人需要把 AI 生成能力嵌入现有 DevOps 流水线的运维/基建工程师想让团队新人快速复用高质量代码生成逻辑的 Tech Lead以及正在评估如何让 AI 编程真正进入企业级安全合规边界的架构师。2. 整体设计思路为什么必须绕开“纯 Web UI”陷阱选择 CLI npm MCP 的三角架构2.1 拒绝浏览器端单点故障CLI 是唯一能承载生产级可靠性的入口很多初学者一上来就想找“Claude 代码生成网页版”甚至自己搭个 React 前端调用 Anthropic API。我试过三次每次都在上线后两周内暴雷。问题不在代码而在架构本质浏览器是不可信执行环境。你无法控制用户是否禁用 CORS、是否装了广告拦截插件误杀请求头、是否在公司内网被代理服务器篡改 Host 字段——而这些恰恰是api.anthropic.com这类高敏感域名最脆弱的环节。去年帮某券商做内部工具时他们的安全团队直接否决了所有 Web 端方案理由很硬核“API Key 绝不能出现在前端 JS 里哪怕做了混淆内存 dump 一下就全露馅”。最终我们砍掉整个 Web UI 层把所有逻辑下沉到 CLI。CLI 的优势在于它运行在开发者本机或 CI 服务器上Key 可以通过环境变量或.env文件隔离且.env被 gitignore 严格保护HTTP 请求由 Node.js 的https模块原生发起完全规避浏览器沙箱限制。更重要的是CLI 天然支持管道pipe和重定向redirect比如claude-code --taskgen-api-client --langtypescript | prettier --write -这样的链式调用在 Web UI 里实现成本极高。我们实测过在 Jenkins Pipeline 中执行 CLI 命令的失败率稳定在 0.03% 以下而同等功能的 Webhook 触发失败率高达 7.2%主要卡在 DNS 解析超时和 TLS 握手异常上——这些在 CLI 的https.Agent配置里几行代码就能搞定。2.2 npm 不是“包管理器”而是你的模板版本控制中枢与依赖隔离沙盒看到 “npm install claude-code-templates” 这个命令别只想到“下载一堆文件”。npm 在这里扮演的是三个关键角色语义化版本锁SemVer Lock、依赖树快照Shrinkwrap、跨平台二进制分发通道Bin Link。举个真实案例我们团队为不同业务线维护了 4 套代码生成模板支付对账、风控规则引擎、报表导出、日志分析每套模板都依赖不同版本的anthropic-ai/sdk和zod校验库。如果用 Git Submodule 或手动拷贝一旦某条线升级了 SDK 版本其他线立刻跟着崩——因为全局 node_modules 里只有一份anthropic-ai/sdk。而 npm 的package-lock.json让每套模板拥有独立的依赖快照。当你执行npm install your-org/claude-template-payment1.2.0它会精确还原出该版本编译时的全部依赖树包括anthropic-ai/sdk0.15.2和zod3.22.4哪怕你全局安装的是anthropic-ai/sdk0.18.0。更关键的是npm bin机制每个模板包在package.json里声明bin: {claude-payment: ./dist/cli.js}安装后 npm 自动在node_modules/.bin/下创建软链接。这样claude-payment --help和claude-risk --help就是两个完全隔离的命令互不干扰。我们曾用npm outdated扫描过 23 个模板包发现其中 17 个存在axios版本冲突但因为依赖被 lock 文件锁定实际运行零报错——这种稳定性是任何“直接 clone GitHub 仓库然后 npm install”方式永远做不到的。2.3 MCP 协议让 Claude 模板从“命令行玩具”变成 IDE 原生能力的底层胶水MCPModel Communication Protocol这个词最近在 VS Code 插件市场刷屏但很多人没搞懂它到底解决了什么。简单说MCP 是让本地工具IDE、浏览器、笔记软件像调用本地函数一样调用远程 AI 模型的标准化协议。没有 MCP你用 VS Code 写代码时想让 Claude 帮你补全得先切到终端敲 CLI 命令再把结果复制回来——这违背了“所见即所得”的编辑体验。而 MCP 把整个流程变成了VS Code 插件监听你光标位置 → 构造 MCP 请求含当前文件内容、选中代码、语言类型→ 发送给本地运行的 MCP Server → Server 调用claude-code-templatesCLI 并传入参数 → CLI 返回结构化 JSON → 插件解析并渲染到编辑器里。我们部署的 MCP Server 其实就是一个极简 Express 应用核心代码只有 47 行但它让claude-code-templates瞬间获得了 IDE 原生集成能力。更妙的是MCP 是协议无关的——同一套 CLI 模板既能被 VS Code 插件调用也能被 Playwright 测试脚本当做一个 HTTP 接口来驱动用于自动化生成测试用例还能被 Obsidian 的 Dataview 插件抓取生成结果存入知识库。这种解耦设计让我们在客户提出“要在蓝湖Lanhu设计稿里一键生成 React 组件”需求时只用了半天就完成了 MCP Adapter 开发而不用重写任何模板逻辑。3. 核心细节解析CLI 命令设计、npm 包结构、MCP Server 实现的关键决策点3.1 CLI 命令不是“功能罗列”而是按工程生命周期分层的动词体系很多开源 CLI 工具的命令设计是灾难性的--generate,--validate,--format,--test像一盘散沙。我们的claude-codeCLI 采用CRUDLifecycle 分层法所有命令都对应明确的工程阶段CCreate层claude-code init—— 初始化项目自动创建.claude-config.json含 API Key 加密存储路径、默认模型、超时阈值并根据--template参数从 npm registry 拉取对应模板包到templates/目录。关键细节init会检测 Node.js 版本必须 ≥18.17.0因 Anthropic SDK v0.15 依赖 Node 18 的stream/webAPI若不满足则抛出带修复指引的错误“请运行nvm install 18.17.0 nvm use 18.17.0”。RRead层claude-code list—— 列出本地已安装的所有模板包及其版本、作者、最后更新时间并标注是否启用enabled。这里有个反直觉设计list不查node_modules而是读取~/.claude/templates/index.json这是一个由init和install命令维护的中央注册表。好处是避免node_modules被误删后命令失效且支持跨项目共享模板。UUpdate层claude-code update --all—— 批量更新所有模板包。重点在--dry-run模式它会模拟更新过程输出将要修改的package-lock.json差异、新增/删除的依赖项并高亮显示可能引发 Breaking Change 的 major 版本升级如anthropic-ai/sdk从 v0.15 升到 v0.16。这是防止“更新后 CI 全挂”的最后一道防线。DDelete层claude-code uninstall template-name—— 安全卸载。它不只是rm -rf node_modules/your-org/claude-template-*还会检查该模板是否被其他模板依赖通过解析peerDependencies若存在依赖链则阻止卸载并提示“模板 payment-v2 依赖 risk-engine1.0.0请先升级 payment-v2 或卸载 risk-engine”。Lifecycle 层claude-code run --taskgen-service --inputsrc/api/payment.ts—— 这是最核心的命令。--task参数不是自由字符串而是从模板包的tasks/目录下动态加载的 JSON Schema 定义。例如gen-service对应tasks/gen-service.schema.json它声明了必需参数input文件路径、可选参数outputDir,language、以及输入文件的校验规则如input必须是 TypeScript 文件且包含interface关键字。CLI 在执行前会先校验参数合法性再启动子进程调用模板的bin/cli.js。这种设计让每个模板的调用契约清晰可测杜绝了“传错参数导致静默失败”的坑。3.2 npm 包结构为什么 templates 目录必须是“可执行单元”而非静态资源一个典型的your-org/claude-template-paymentnpm 包结构长这样├── package.json # 声明 bin、dependencies、engines ├── README.md # 模板使用说明、适用场景、已知限制 ├── tasks/ # 任务定义目录JSON Schema │ ├── gen-service.schema.json │ └── validate-rules.schema.json ├── prompts/ # Prompt 模板目录Mustache 语法 │ ├── gen-service.mustache │ └── validate-rules.mustache ├── validators/ # 输入校验器TypeScript │ ├── service-input.validator.ts │ └── rules-input.validator.ts ├── generators/ # 生成器核心逻辑TypeScript │ ├── service.generator.ts │ └── rules.generator.ts ├── dist/ # 编译后产物CLI 入口 │ └── cli.js # 主执行文件封装 Anthropic SDK 调用 └── test/ # 集成测试用 Jest MSW 模拟 Anthropic API └── e2e.test.ts关键设计点在于dist/cli.js不是简单的require(anthropic-ai/sdk)调用而是一个完整的、可独立运行的进程。它内部做了三件事环境隔离通过process.env.ANTHROPIC_API_KEY读取 Key若未设置则从~/.claude/keys.enc解密使用 AES-256-CBC密钥来自系统 keychain请求熔断内置p-limit库限制并发请求数默认 3避免突发流量打崩 Anthropic 限流结果后处理对 Claude 返回的content字段先用prettier格式化根据--language参数自动匹配 parser再用eslint --fix修复基础语法错误最后才输出到 stdout。这种设计让每个模板包都是一个“黑盒可执行单元”。你不需要知道它内部怎么调用 Anthropic只需关心claude-code run --taskgen-service --inputxxx这个契约。我们曾用npx tsc --noEmit --watch监控generators/目录一旦有 TS 类型错误CI 会直接 fail确保模板逻辑永远 type-safe。3.3 MCP Server 实现用 50 行代码打通 VS Code 与 CLI 的任督二脉MCP Server 的核心价值在于“协议转换”而非“功能实现”。我们选择 Express 而非 Fastify 或 NestJS就因为它足够轻量启动时间 12ms且中间件生态成熟。以下是精简后的核心实现已脱敏// server.js const express require(express); const { execSync } require(child_process); const app express(); app.use(express.json({ limit: 10mb })); // MCP 请求可能携带大文件内容 // MCP 标准路由POST /mcp/v1/execute app.post(/mcp/v1/execute, (req, res) { const { method, params } req.body; // 1. 校验 MCP 方法名必须是 claude-code 支持的 task const validMethods [claude.code.run, claude.code.list]; if (!validMethods.includes(method)) { return res.status(400).json({ error: Unsupported method: ${method} }); } try { // 2. 构造 CLI 命令关键所有 params 转为 CLI 参数 let cmd claude-code run; if (params.task) cmd --task${params.task}; if (params.input) cmd --input${params.input}; if (params.outputDir) cmd --output-dir${params.outputDir}; // 3. 执行 CLI注意cwd 设为用户主目录确保 .claude-config.json 可读 const result execSync(cmd, { cwd: process.env.HOME, encoding: utf8, timeout: 60000 // MCP 超时设为 60s比 CLI 默认 30s 更宽松 }); // 4. 将 CLI 输出转为 MCP 标准响应格式 res.json({ result: { content: result.trim(), metadata: { executedAt: new Date().toISOString() } } }); } catch (error) { // 5. 统一错误处理CLI 错误码映射为 MCP 错误 const statusCode error.status 1 ? 400 : 500; res.status(statusCode).json({ error: { code: error.status || 500, message: error.message || Unknown execution error } }); } }); app.listen(3001, () console.log(MCP Server running on http://localhost:3001));这个 Server 的精妙之处在于它不碰 Anthropic API不存任何状态只是 CLI 的“HTTP 封装壳”。VS Code 插件发送的 MCP 请求被精准翻译成 CLI 命令行参数执行结果再原样打包回 MCP 响应。我们实测过在 M1 Mac 上从插件发送请求到编辑器渲染完成端到端延迟稳定在 2.3~3.1 秒含 Claude API RTT远低于 VS Code 原生补全的 5 秒阈值。更重要的是当客户要求“在蓝湖设计稿里点击组件生成代码”时我们只需在蓝湖的 Chrome 扩展里加一段 JS调用fetch(http://localhost:3001/mcp/v1/execute, {...})即可完全复用这套 Server——这就是协议抽象的力量。4. 实操全流程从零搭建可运行的 claude-code-templates 环境含 Windows/macOS/Linux 兼容方案4.1 环境准备绕过 npm 权限陷阱与 Node.js 版本墙的实战指南Windows 用户最常卡在第一步npm : 无法加载文件 D:\Program Files\nodejs\npm.ps1。这不是 npm 问题而是 PowerShell 的执行策略Execution Policy在作祟。网上流传的Set-ExecutionPolicy RemoteSigned -Scope CurrentUser方案有安全隐患允许远程脚本执行。我们的安全方案是永久切换到 CMD 或 Git Bash在 Windows 设置 → 系统 → 高级系统设置 → 环境变量 → 系统变量 →PATHEXT在末尾添加;.CMD;.BAT注意前面的分号。这样双击.cmd文件或在任意终端输入命令时系统优先调用 CMD 解析器。用 nvm-windows 替代直接安装 Node.js下载 nvm-windows 安装后执行nvm install 18.17.0 nvm use 18.17.0这会把 Node.js 安装到C:\Users\{user}\AppData\Roaming\nvm完全避开Program Files的权限问题。nvm use会自动更新PATH后续所有终端都能识别node和npm。macOS 用户常见问题是npm WARN deprecated node-domexception1.0.0。这不是警告而是anthropic-ai/sdk依赖链中的一个废弃包但它不影响功能。真正的坑是 macOS 的 SIPSystem Integrity Protection会阻止某些 CLI 创建的临时文件。解决方案在~/.zshrc中添加export TMPDIR/private/tmp mkdir -p $TMPDIR然后重启终端。这确保所有 CLI 生成的临时文件都写入 SIP 允许的路径。Linux 用户尤其是 Ubuntu需注意npm命令被nodejs包劫持的问题。Ubuntu 官方源安装的nodejs会把npm命令指向/usr/bin/npm而这个版本往往过旧。正确做法是curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs这会安装 NodeSource 提供的 LTS 版本npm命令指向/usr/bin/npm且版本最新。4.2 初始化与模板安装如何用一条命令接入企业级代码生成能力假设你要为团队接入“生成 TypeScript API Client”能力执行以下三步Step 1全局安装 CLI 工具# 确保 npm 镜像源是国内加速源推荐 taobao npm config set registry https://registry.npmmirror.com # 全局安装注意不是 --save-dev因为 CLI 是全局命令 npm install -g your-org/claude-code-cli # 验证安装 claude-code --version # 应输出 2.4.1Step 2初始化项目并安装模板# 进入你的代码仓库根目录 cd /path/to/your/project # 初始化 claude-code 配置会创建 ~/.claude/config.json claude-code init --templateyour-org/claude-template-api-client # 安装模板包自动下载到 node_modules 并注册到中央索引 npm install your-org/claude-template-api-client1.3.0 # 查看已安装模板 claude-code list # 输出 # NAME VERSION AUTHOR ENABLED # api-client 1.3.0 your-org trueStep 3配置 Anthropic API Key安全存储# 创建加密密钥首次运行会提示输入密码 claude-code key init # 设置 KeyKey 会被 AES 加密后存入 ~/.claude/keys.enc claude-code key set --nameprod --keysk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 验证 Key 可用性不触发实际 API 调用只校验格式 claude-code key verify --nameprod提示claude-code key命令使用 Node.js 的crypto模块进行 AES-256-CBC 加密密钥派生自用户密码PBKDF2-SHA256100000 次迭代。即使.enc文件被窃取没有密码也无法解密。4.3 MCP Server 启动与 VS Code 集成让 Claude 生成能力无缝融入编辑体验Step 1启动 MCP Server# 在任意目录执行Server 会监听 localhost:3001 claude-code mcp start # 或者后台运行Linux/macOS claude-code mcp start --daemon # 查看 Server 状态 claude-code mcp statusStep 2VS Code 插件配置安装官方 MCP for VS Code 插件打开 VS Code 设置Ctrl,搜索MCP Servers点击Edit in settings.json添加mcp.servers: [ { name: Claude Code, url: http://localhost:3001, capabilities: [claude.code.run, claude.code.list] } ]重启 VS Code。Step 3在编辑器中触发生成打开一个 TypeScript 文件如src/api/payment.ts选中一段接口定义如interface PaymentRequest { ... }按CtrlShiftPWindows或CmdShiftPmacOS输入MCP: Execute选择Claude Code: Generate API Client插件会自动构造 MCP 请求发送给本地 ServerServer 调用 CLICLI 调用 Anthropic最终生成的payment.client.ts文件会以 diff 形式预览在编辑器右侧。注意首次触发时VS Code 会弹窗询问“是否允许此扩展访问 localhost:3001”必须点“允许”否则连接被浏览器同源策略拦截。4.4 高级用法在 CI/CD 中自动化生成代码并提交 PR这才是claude-code-templates的终极价值。我们在 Jenkins Pipeline 中实现了全自动 API Client 生成pipeline { agent any environment { ANTHROPIC_API_KEY credentials(anthropic-prod-key) } stages { stage(Generate API Client) { steps { script { // 1. 安装 CLI仅需一次可缓存到 Jenkins Agent 镜像 sh npm install -g your-org/claude-code-cli // 2. 安装模板从私有 registry 拉取 sh npm install your-org/claude-template-api-client1.3.0 // 3. 执行生成--output-dir 指向 src/generated sh claude-code run --taskgen-api-client --inputsrc/api/payment.ts --output-dirsrc/generated } } } stage(Commit PR) { steps { script { // 4. 检查是否有新文件生成 def changedFiles sh(script: git status --porcelain | grep ^\\?? | cut -d -f2, returnStdout: true).trim() if (changedFiles) { // 5. 提交变更 sh git config user.name CI Bot sh git config user.email ciyour-org.com sh git add ${changedFiles} sh git commit -m [AUTO] Generate API Client from Claude // 6. 推送并创建 PR调用 GitHub API sh curl -X POST -H Authorization: token ${GITHUB_TOKEN} -d \{title:[AUTO] Update API Client,head:ci-bot:main,base:main,body:Auto-generated by Claude Code}\ https://api.github.com/repos/your-org/your-repo/pulls } } } } } }这个 Pipeline 的关键在于它完全复用了本地开发时的 CLI 命令。无需为 CI 单独写一套 Node.js 脚本也不用担心环境差异。我们实测过从 Jenkins 触发到 GitHub PR 创建成功平均耗时 42 秒失败率 0.1%。而人工执行同样流程平均耗时 8 分钟且极易出错比如忘记git add或提交信息格式错误。5. 常见问题排查那些让你抓狂的报错其实都有标准解法5.1 “Unable to connect to Anthropic services” 类错误的根因定位树这个错误看似是网络问题但 92% 的情况源于配置错误。我们整理了一个三层定位树层级检查项命令/操作预期结果修复方案L1本地网络层是否能 ping 通 Anthropicping api.anthropic.com应返回 IP 地址若超时检查公司防火墙是否放行api.anthropic.com:443L2TLS/证书层是否能建立 HTTPS 连接openssl s_client -connect api.anthropic.com:443 -servername api.anthropic.com应显示Verify return code: 0 (ok)若返回unable to get local issuer certificate执行npm config set strict-ssl false仅限内网测试环境L3CLI 配置层CLI 是否读取到有效 Keyclaude-code key list应显示prod: ✅ active若显示❌ inactive运行claude-code key set --nameprod --key...特别注意unable to locate the codex cli binary这类错误99% 是因为npm install -g后node_modules/.bin未加入PATH。在 Windows 上npm install -g默认将 bin 链接到C:\Users\{user}\AppData\Roaming\npm你需要手动把这个路径加到系统PATH环境变量里。5.2 “Claude doesn’t look like an anthropic model” 错误的真相这个错误信息极具误导性。它不是说你调用的不是 Anthropic 模型而是CLI 发送的model参数与 Anthropic API 的路由规则不匹配。Anthropic 的 API Gateway 会根据model字段决定请求转发到哪个后端集群。例如claude-3-haiku-20240307→ 路由到 Haiku 集群claude-3-sonnet-20240229→ 路由到 Sonnet 集群claude-3-opus-20240229→ 路由到 Opus 集群但如果你在 CLI 配置里写了model: claude-3-haiku缺少日期后缀Gateway 就无法识别直接返回 400。解决方案所有模板包的config.json中model字段必须带完整日期后缀。我们在claude-code init时强制校验claude-code init --templateyour-org/claude-template-api-client # 如果模板的 config.json 中 model 是 claude-3-haikuCLI 会报错 # ERROR: Invalid model name claude-3-haiku. Valid format: claude-3-haiku-YYYYMMDD5.3 npm 权限错误的终极解决方案Windows/macOS/Linux 通用所有npm : 无法加载文件 ... npm.ps1类错误根源都是 Shell 解析器试图执行.ps1文件。终极方案是彻底禁用 PowerShell 对 npm 的接管Windows在 PowerShell 中执行Remove-Item alias:npm Remove-Item alias:npx然后在C:\Users\{user}\AppData\Roaming\npm目录下将npm.cmd和npx.cmd的属性 → 安全 → 编辑 → 添加Users组的“完全控制”权限。macOS/Linux在~/.bashrc或~/.zshrc中添加alias npm$(which npm) alias npx$(which npx)这强制使用which npm找到的二进制文件绕过 Shell 的别名解析。实操心得我们给客户部署时会提供一个fix-npm-permission.sh脚本一键执行上述操作。脚本执行后npm -v和npx -v命令 100% 可用且不会影响系统其他功能。5.4 MCP 连接失败的 Chrome 扩展调试技巧当 Chrome 扩展提示“启用 MCP 连接”失败时不要盲目重启浏览器。按以下顺序排查确认 MCP Server 正在运行在终端执行lsof -i :3001macOS/Linux或netstat -ano | findstr :3001Windows查看端口是否被占用检查 Chrome 扩展权限地址栏输入chrome://extensions/→ 找到你的 MCP 扩展 → 点击“详情” → 确保“允许访问文件网址”已开启验证跨域设置在 Chrome 地址栏输入chrome://flags/#unsafely-treat-insecure-origin-as-secure将http://localhost:3001添加到列表并重启 Chrome抓包确认请求发出按F12→ Network 标签 → 在扩展触发 MCP 调用时观察是否有POST http://localhost:3001/mcp/v1/execute请求状态码是否为 200。我们曾遇到一个诡异问题Chrome 扩展能连通 Server但 Server 日志显示req.body为空。最终发现是扩展的manifest.json中content_security_policy配置了self阻止了 JSON 数据发送。解决方案在manifest.json中添加content_security_policy: { extension_pages: script-src self; object-src self }6. 模板开发进阶如何从使用者变成贡献者发布自己的 claude-code-templates 包6.1 模板包开发规范为什么你的第一个包必须包含tasks/和prompts/目录发布一个可被claude-codeCLI 识别的模板包有三个强制要求package.json中必须声明claude-template作为 keywordskeywords: [claude-template, code-generation, typescript]CLI 的init命令会扫描 npm registry只显示keywords包含claude-template的包。根目录必须有tasks/目录且每个.schema.json文件必须符合 MCP Task Schema// tasks/gen-service.schema.json { $schema: https://json-schema.org/draft/2020-12/schema, type: object, properties: { input: { type: string, description: Input file path }, outputDir: { type: string, default: src/generated } }, required: [input] }这个 Schema 会被 CLI 用来做参数校验也是 VS Code 插件生成 UI 表单的依据。prompts/目录下的 Mustache 模板必须用{{input}}、{{language}}等标准变量// prompts/gen-service.mustache Generate a {{language}} service class that implements the following interface: {{input}} Rules: - Use dependency injection pattern - Add JSDoc comments for all public methods - Return Promise for async operationsCLI 在调用 Anthropic 时会把--input参数的内容注入到{{input}}占位符中。6.2 本地开发调试用npm link实现零等待的模板