@minus-ai/create-skill 0.1.0-beta.1

package/index.mjs

@@ -0,0 +1,658 @@
+#!/usr/bin/env node
+
+import { createInterface } from 'node:readline/promises'
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'
+import { execSync } from 'node:child_process'
+import { createServer } from 'node:net'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const TEMPLATES_DIR = join(__dirname, 'templates')
+const CREDENTIALS_DIR = join(homedir(), '.minus')
+const CREDENTIALS_FILE = join(CREDENTIALS_DIR, 'credentials.json')
+
+const DEFAULT_PLATFORM_URL = 'http://47.107.144.22:18990'
+
+function findAvailablePort(start = 4001) {
+  return new Promise(resolve => {
+    const server = createServer()
+    server.listen(start, '127.0.0.1', () => {
+      server.close(() => resolve(start))
+    })
+    server.on('error', () => resolve(findAvailablePort(start + 1)))
+  })
+}
+
+// ── Naming helpers ──────────────────────────────────────
+
+function idToFolder(id) {
+  return id.replace(/[-\s]+/g, '_')
+}
+
+function idToClassName(id) {
+  return (
+    id
+      .split(/[-_\s]+/)
+      .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+      .join('') + 'Pipeline'
+  )
+}
+
+// ── Template rendering ──────────────────────────────────
+
+function render(template, vars) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? '')
+}
+
+function readTemplate(name, subdir) {
+  if (subdir) {
+    const sub = join(TEMPLATES_DIR, subdir, name)
+    if (existsSync(sub)) return readFileSync(sub, 'utf-8')
+  }
+  return readFileSync(join(TEMPLATES_DIR, name), 'utf-8')
+}
+
+function writeOut(path, content) {
+  mkdirSync(dirname(path), { recursive: true })
+  writeFileSync(path, content)
+}
+
+// ── Credentials cache ───────────────────────────────────
+
+function loadCredentials() {
+  try {
+    return JSON.parse(readFileSync(CREDENTIALS_FILE, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+function saveCredentials(platformUrl, sid, extra = {}) {
+  mkdirSync(CREDENTIALS_DIR, { recursive: true })
+  writeFileSync(
+    CREDENTIALS_FILE,
+    JSON.stringify(
+      {
+        session_id: sid,
+        user_id: extra.userId || null,
+        team_id: extra.teamId || null,
+        api_base: platformUrl
+      },
+      null,
+      2
+    )
+  )
+}
+
+// ── HTTP helpers ────────────────────────────────────────
+
+async function api(platformUrl, method, path, body, sid) {
+  const url = `${platformUrl}${path}`
+  const headers = { 'Content-Type': 'application/json' }
+  if (sid) headers['Cookie'] = `MINUS_AI_SID=${sid}`
+
+  const res = await fetch(url, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+    redirect: 'manual'
+  })
+
+  const setCookie = res.headers.get('set-cookie') || ''
+  const sidMatch = setCookie.match(/MINUS_AI_SID=([^;]+)/)
+  const newSid = sidMatch ? sidMatch[1] : null
+
+  let data = null
+  const text = await res.text()
+  if (text) {
+    try {
+      data = JSON.parse(text)
+    } catch {}
+  }
+
+  return { status: res.status, data, sid: newSid }
+}
+
+async function validateSession(platformUrl, sid) {
+  try {
+    const { status } = await api(platformUrl, 'GET', '/api/me', null, sid)
+    return status === 200
+  } catch {
+    return false
+  }
+}
+
+// ── Auth flow ───────────────────────────────────────────
+
+function detectChannel(identifier) {
+  return identifier.includes('@') ? 'email' : 'phone'
+}
+
+function normalizeIdentifier(identifier, channel) {
+  if (channel === 'phone' && !identifier.startsWith('+')) {
+    return `+86${identifier}`
+  }
+  return identifier
+}
+
+async function login(rl, platformUrl) {
+  const identifier = (await rl.question('  ? 手机号或邮箱: ')).trim()
+  if (!identifier) {
+    console.error('\n  ✗ 手机号或邮箱不能为空')
+    process.exit(1)
+  }
+
+  const channel = detectChannel(identifier)
+  const target = normalizeIdentifier(identifier, channel)
+
+  console.log('  → 发送验证码...')
+  const vcodeRes = await api(platformUrl, 'POST', '/api/auth/vcode/send', {
+    channel,
+    target,
+    purpose: 'login'
+  })
+
+  if (vcodeRes.status === 429) {
+    console.error('\n  ✗ 请求过于频繁，请稍后再试')
+    process.exit(1)
+  }
+  if (vcodeRes.status >= 400) {
+    console.error(`\n  ✗ 发送验证码失败: ${vcodeRes.data?.message || '未知错误'}`)
+    process.exit(1)
+  }
+
+  console.log('  ✓ 验证码已发送')
+  const code = (await rl.question('  ? 验证码: ')).trim()
+
+  const grantType = channel === 'email' ? 'email_code' : 'phone_code'
+  const loginRes = await api(platformUrl, 'POST', '/api/auth/login', {
+    grantType,
+    identifier: target,
+    credential: code,
+    rememberMe: true
+  })
+
+  if (loginRes.status !== 200 || !loginRes.sid) {
+    const msg = loginRes.data?.code === 'VCODE_INVALID' ? '验证码错误' : loginRes.data?.code === 'VCODE_EXPIRED' ? '验证码已过期' : loginRes.data?.code === 'IDENTITY_NOT_FOUND' ? '该账号未注册，请先在平台注册' : loginRes.data?.message || '登录失败'
+    console.error(`\n  ✗ ${msg}`)
+    process.exit(1)
+  }
+
+  console.log('  ✓ 登录成功')
+  saveCredentials(platformUrl, loginRes.sid, { userId: loginRes.data?.userId })
+  return loginRes.sid
+}
+
+async function ensureAuth(rl, platformUrl) {
+  const creds = loadCredentials()
+
+  if (creds?.session_id) {
+    const valid = await validateSession(platformUrl, creds.session_id)
+    if (valid) {
+      console.log('  ✓ 已使用缓存的登录态')
+      return creds.session_id
+    }
+    console.log('  → 登录态已过期，需要重新登录')
+  }
+
+  return login(rl, platformUrl)
+}
+
+// ── Create skill on platform ────────────────────────────
+
+async function createSkillOnPlatform(platformUrl, sid, { displayName, description }) {
+  console.log('  → 正在向平台注册 skill...')
+  const body = {
+    displayName,
+    description: description
+  }
+
+  let res
+  try {
+    res = await api(platformUrl, 'POST', '/api/skills', body, sid)
+  } catch (e) {
+    console.error(`\n  ✗ 网络连接失败，请检查网络后重试`)
+    console.error(`    错误详情：${e.message}`)
+    process.exit(1)
+  }
+
+  if (res.status === 201) {
+    return res.data
+  }
+
+  if (res.status >= 500) {
+    console.error(`\n  ✗ Minus 平台暂时有问题，请稍后重试`)
+  } else if (res.data?.code === 'FORBIDDEN') {
+    console.error(`\n  ✗ 当前账号无创建 Skill 的权限`)
+  } else if (res.data?.code === 'UNAUTHORIZED') {
+    console.error(`\n  ✗ 登录已过期，请重新登录后再试`)
+  } else {
+    console.error(`\n  ✗ 创建失败：${res.data?.message || `HTTP ${res.status}`}`)
+  }
+  process.exit(1)
+}
+
+// ── CLI ─────────────────────────────────────────────────
+
+const BOOLEAN_FLAGS = new Set(['non-interactive'])
+
+function parseFlags(args) {
+  const result = { positional: [], flags: {} }
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith('--')) {
+      const key = args[i].slice(2)
+      if (BOOLEAN_FLAGS.has(key)) {
+        result.flags[key] = true
+      } else if (i + 1 < args.length) {
+        result.flags[key] = args[++i]
+      }
+    } else {
+      result.positional.push(args[i])
+    }
+  }
+  return result
+}
+
+// ── Sub-commands for non-interactive (Claude) usage ─────
+
+async function cmdCheckSession(flags) {
+  const platformUrl = flags.platform || DEFAULT_PLATFORM_URL
+
+  // Check --sid first
+  if (flags.sid) {
+    const valid = await validateSession(platformUrl, flags.sid)
+    if (valid) {
+      console.log(JSON.stringify({ ok: true, sid: flags.sid }))
+      return
+    }
+    console.log(JSON.stringify({ ok: false, reason: 'sid_invalid' }))
+    return
+  }
+
+  // Check cached credentials
+  const creds = loadCredentials()
+  if (creds?.session_id) {
+    const valid = await validateSession(platformUrl, creds.session_id)
+    if (valid) {
+      console.log(JSON.stringify({ ok: true, sid: creds.session_id }))
+      return
+    }
+  }
+
+  console.log(JSON.stringify({ ok: false, reason: 'no_session' }))
+}
+
+async function cmdSendVcode(flags) {
+  const platformUrl = flags.platform || DEFAULT_PLATFORM_URL
+  const identifier = flags.identifier
+  if (!identifier) {
+    console.error(JSON.stringify({ ok: false, error: 'missing --identifier' }))
+    process.exit(1)
+  }
+
+  const channel = detectChannel(identifier)
+  const target = normalizeIdentifier(identifier, channel)
+
+  const purpose = flags.purpose || 'login'
+  const res = await api(platformUrl, 'POST', '/api/auth/vcode/send', {
+    channel,
+    target,
+    purpose
+  })
+
+  if (res.status === 429) {
+    console.log(JSON.stringify({ ok: false, error: 'rate_limited', message: '请求过于频繁，请稍后再试' }))
+    process.exit(1)
+  }
+  if (res.status >= 400) {
+    console.log(JSON.stringify({ ok: false, error: 'send_failed', message: res.data?.message || '发送失败' }))
+    process.exit(1)
+  }
+
+  console.log(JSON.stringify({ ok: true, channel, target }))
+}
+
+async function cmdLogin(flags) {
+  const platformUrl = flags.platform || DEFAULT_PLATFORM_URL
+  const identifier = flags.identifier
+  const credential = flags.credential
+  const grantType = flags['grant-type']
+
+  if (!identifier || !credential) {
+    console.error(JSON.stringify({ ok: false, error: 'missing --identifier and/or --credential' }))
+    process.exit(1)
+  }
+
+  const channel = detectChannel(identifier)
+  const target = normalizeIdentifier(identifier, channel)
+  const resolvedGrantType = grantType || (channel === 'email' ? 'email_code' : 'phone_code')
+
+  const res = await api(platformUrl, 'POST', '/api/auth/login', {
+    grantType: resolvedGrantType,
+    identifier: target,
+    credential,
+    rememberMe: true
+  })
+
+  if (res.status !== 200 || !res.sid) {
+    const msg = res.data?.code === 'VCODE_INVALID' ? '验证码错误' : res.data?.code === 'VCODE_EXPIRED' ? '验证码已过期，请重新发送' : res.data?.code === 'IDENTITY_NOT_FOUND' ? '该账号未注册' : res.data?.message || '登录失败'
+    console.log(JSON.stringify({ ok: false, error: res.data?.code || 'login_failed', message: msg }))
+    process.exit(1)
+  }
+
+  saveCredentials(platformUrl, res.sid, { userId: res.data?.userId })
+  console.log(JSON.stringify({ ok: true, sid: res.sid }))
+}
+
+async function cmdRegister(flags) {
+  const platformUrl = flags.platform || DEFAULT_PLATFORM_URL
+  const identifier = flags.identifier
+  const code = flags.credential
+  const password = flags.password
+
+  if (!identifier || !code) {
+    console.error(JSON.stringify({ ok: false, error: 'missing --identifier and/or --credential' }))
+    process.exit(1)
+  }
+
+  const channel = detectChannel(identifier)
+  const target = normalizeIdentifier(identifier, channel)
+
+  const body = { channel, target, code }
+  if (password) body.password = password
+
+  const res = await api(platformUrl, 'POST', '/api/auth/register', body)
+
+  if (res.status === 409) {
+    console.log(JSON.stringify({ ok: false, error: 'IDENTITY_TAKEN', message: '该手机号/邮箱已注册，请直接登录' }))
+    process.exit(1)
+  }
+
+  if (res.status !== 200 || !res.sid) {
+    const msg = res.data?.code === 'VCODE_INVALID' ? '验证码错误' : res.data?.code === 'VCODE_EXPIRED' ? '验证码已过期，请重新发送' : res.data?.message || '注册失败'
+    console.log(JSON.stringify({ ok: false, error: res.data?.code || 'register_failed', message: msg }))
+    process.exit(1)
+  }
+
+  saveCredentials(platformUrl, res.sid, { userId: res.data?.userId })
+  console.log(JSON.stringify({ ok: true, sid: res.sid, userId: res.data?.userId }))
+}
+
+// ── Main (create flow) ─────────────────────────────────
+
+async function main() {
+  const { positional, flags } = parseFlags(process.argv.slice(2))
+
+  // Sub-commands: non-interactive helpers for Claude
+  const subcommand = positional[0]
+  if (subcommand === 'check-session') {
+    return cmdCheckSession(flags)
+  }
+  if (subcommand === 'send-vcode') {
+    return cmdSendVcode(flags)
+  }
+  if (subcommand === 'login') {
+    return cmdLogin(flags)
+  }
+  if (subcommand === 'register') {
+    return cmdRegister(flags)
+  }
+
+  // Main create flow
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+
+  console.log('\n  @minus/create-skill — 创建新的 Skill 项目\n')
+
+  // 1. Collect skill info — 只问名称，问完立刻创建
+  let displayName
+
+  if (positional.length >= 1) {
+    displayName = positional[0]
+  } else {
+    displayName = (await rl.question('  ? 给你的 Skill 项目起个名字？（这会作为项目文件夹名）: ')).trim()
+  }
+
+  if (!displayName) {
+    console.error('\n  ✗ 项目名称不能为空')
+    process.exit(1)
+  }
+
+  const description = flags.description || ''
+  const INPUT_TYPES = ['asin', 'keyword', 'file', 'custom', 'default']
+  const inputType = flags['input-type'] || 'asin'
+  if (!INPUT_TYPES.includes(inputType)) {
+    console.error(`\n  ✗ 无效的输入类型: ${inputType}（可选: ${INPUT_TYPES.join(', ')}）`)
+    process.exit(1)
+  }
+
+  // 2. Platform auth + register skill
+  const platformUrl = flags.platform || process.env.MINUS_AI_PLATFORM_URL || DEFAULT_PLATFORM_URL
+  const nonInteractive = flags['non-interactive'] === true
+  console.log(`\n  平台: ${platformUrl}\n`)
+
+  let sid
+  if (flags.sid) {
+    const valid = await validateSession(platformUrl, flags.sid)
+    if (!valid) {
+      console.error('\n  ✗ 提供的 --sid 无效或已过期')
+      process.exit(1)
+    }
+    sid = flags.sid
+    console.log('  ✓ 已使用 --sid 登录态')
+  } else if (nonInteractive) {
+    const creds = loadCredentials()
+    if (creds?.session_id && (await validateSession(platformUrl, creds.session_id))) {
+      sid = creds.session_id
+      console.log('  ✓ 已使用缓存的登录态')
+    } else {
+      console.error('\n  ✗ 非交互模式下没有有效的登录态')
+      console.error('  请先运行: node create-skill/index.mjs login --identifier <手机号或邮箱> --credential <验证码>')
+      process.exit(1)
+    }
+  } else {
+    sid = await ensureAuth(rl, platformUrl)
+  }
+
+  const skillResult = await createSkillOnPlatform(platformUrl, sid, { displayName, description })
+
+  console.log(`  ✓ 注册成功`)
+  console.log(`    skill_id: ${skillResult.id}`)
+  console.log(`    api_key:  ${skillResult.apiKey}`)
+
+  rl.close()
+
+  // 3. Generate project files
+  const folder = idToFolder(displayName)
+  const targetDir = join(process.cwd(), folder)
+  if (existsSync(targetDir)) {
+    console.error(`\n  ✗ 目录 ${folder}/ 已存在`)
+    process.exit(1)
+  }
+
+  const className = idToClassName(skillResult.id)
+  const namespace = folder
+  const port = String(await findAvailablePort(4001))
+  const apiKey = skillResult.apiKey
+
+  const vars = { skillId: skillResult.id, folder, className, displayName, description, namespace, port }
+
+  // Backend files (pipeline.py from input-type subdir)
+  writeOut(join(targetDir, 'pipeline.py'), render(readTemplate('pipeline.py.tpl', inputType), vars))
+  writeOut(join(targetDir, 'server.py'), render(readTemplate('server.py.tpl'), vars))
+  writeOut(join(targetDir, 'pyproject.toml'), render(readTemplate('pyproject.toml.tpl'), vars))
+  writeOut(join(targetDir, '.env.example'), render(readTemplate('env.example.tpl'), vars))
+  writeOut(join(targetDir, '.env.local'), `MINUS_AI_SKILL_API_KEY=${apiKey}\nMINUS_AI_PLATFORM_URL=${platformUrl}\n`)
+  writeOut(join(targetDir, '.gitignore'), render(readTemplate('gitignore.tpl'), vars))
+
+  writeOut(
+    join(targetDir, '.minus', 'skill.json'),
+    JSON.stringify(
+      {
+        skillId: skillResult.id,
+        version: skillResult.draftVersion ?? skillResult.version ?? '1.0-alpha.1'
+      },
+      null,
+      2
+    )
+  )
+
+  // CLAUDE.md — Claude Code 项目指令（根据 inputType 动态生成）
+  const templateDocs = {
+    asin: `## 模板能力（inputType: asin）
+- 输入组件：\`AmazonSearchBar\` + \`CountrySelect\`（来自 @minus/platform-widgets）
+- 校验函数：\`validateAsins(value)\` — 校验 ASIN 格式，返回 { asins: string[], error? }
+- 支持单个或多个 ASIN 输入（逗号/换行分隔）
+- 修改输入验证规则：编辑 frontend/src/main.tsx 中的 handleSubmit 函数
+- 修改 pipeline 步骤：编辑 pipeline.py 中的 step_N 方法`,
+    keyword: `## 模板能力（inputType: keyword）
+- 输入组件：\`AmazonSearchBar\` + \`CountrySelect\`（来自 @minus/platform-widgets）
+- 校验函数：\`validateKeywords(value)\` — 校验关键词格式，返回 { keywords: string[], error? }
+- 支持单个或多个关键词输入（逗号/换行分隔）
+- 修改输入验证规则：编辑 frontend/src/main.tsx 中的 handleSubmit 函数
+- 修改 pipeline 步骤：编辑 pipeline.py 中的 step_N 方法`,
+    file: `## 模板能力（inputType: file）
+- 输入组件：\`FilePicker\`（来自 @minus/platform-widgets）
+- 上传函数：\`uploadFile(file)\` — 上传文件到平台
+- 修改 pipeline 步骤：编辑 pipeline.py 中的 step_N 方法`,
+    custom: `## 模板能力（inputType: custom）
+- 输入组件：纯文本输入框（自定义）
+- 无预置校验，根据业务需求自行实现
+- 修改 pipeline 步骤：编辑 pipeline.py 中的 step_N 方法`,
+    default: `## 模板能力（inputType: default）
+- 默认页面：展示 Skill 名称、描述、适用场景、标签
+- 输入组件：无（由三步法第一步确认后生成）
+- 修改 pipeline 步骤：编辑 pipeline.py 中的 step_N 方法`
+  }
+
+  writeOut(
+    join(targetDir, 'CLAUDE.md'),
+    `# ${displayName}
+
+Minus Skill Project
+
+## Commands
+- \`/minus\` — 进入开发模式
+- \`/minus help\` — 查看帮助
+- \`/minus publish\` — 校验、打包、发布
+
+${templateDocs[inputType] || templateDocs.custom}
+
+## 项目结构
+- \`pipeline.py\` — 后端 pipeline 逻辑，每个步骤是一个 step_N 方法
+- \`server.py\` — ASGI 服务入口
+- \`frontend/src/main.tsx\` — 前端入口，包含输入表单和结果渲染
+- \`frontend/src/locales/\` — 多语言文件
+- \`.minus/skill.json\` — 项目标识（Skill ID）
+- \`.env.local\` — 运行时凭证（MINUS_AI_SKILL_API_KEY）
+- \`tests/\` — 测试用例
+
+## SDK 使用规则（重要）
+
+写代码前必须先了解 SDK 提供的能力，优先使用 SDK 已有的组件和方法，不要手写。
+
+### 开发手册
+写前端代码前，读以下开发手册：
+- 读 \`${join(__dirname, '../../runtime/frontend-guide')}/*/doc.md\`
+- 手册包含：前后端数据契约（StepOutcome → StepRenderCtx）、Widget 选型与用法（defineWidgetStep、内置 Interactive/Display Widget）、自定义 Widget 开发、多语言接入。
+
+### 后端 SDK 参考
+写 pipeline.py 前，读以下本地文件了解可用 API：
+- \`StepOutcome\`：读 \`.venv/**/minus_ai_sdk/pipeline/outcome.py\`
+- \`PipelineContext\`：读 \`.venv/**/minus_ai_sdk/pipeline/context.py\`
+
+### 前端 SDK 参考
+@minus/* 包通过平台 CDN 加载，本地无源码。写前端代码前，读以下文档了解可用 API：
+- Widget 框架：读 \`${join(__dirname, '../../runtime/widget-framework')}/*/docs.md\`
+- 平台组件：读 \`${join(__dirname, '../../runtime/platform-widgets')}/*/docs.md\`
+
+修改前端代码后，同步更新 \`frontend/src/locales/\` 下的多语言文件。
+
+## 开发约定
+- 新增 pipeline 步骤：在 pipeline.py 中添加 \`async def step_N(self, ctx)\` 方法
+- 新增前端步骤渲染：在 main.tsx 的 \`buildSteps\` 函数中添加步骤配置
+- Skill 业务信息（名称、描述、步骤定义）存储在后端，通过 Plugin 的 \`skill_update\` MCP tool 管理
+`
+  )
+
+  // README.md
+  writeOut(join(targetDir, 'README.md'), render(readTemplate('README.md.tpl'), vars))
+
+  // frontend/assets/ 和 tests/ 目录
+  writeOut(join(targetDir, 'frontend', 'assets', '.gitkeep'), '')
+  writeOut(join(targetDir, 'tests', '.gitkeep'), '')
+
+  const rootPkgContent = render(readTemplate('root-package.json.tpl'), vars)
+  const fePkgContent = render(readTemplate('frontend-package.json.tpl'), vars)
+  writeOut(join(targetDir, 'package.json'), rootPkgContent)
+  writeOut(join(targetDir, 'pnpm-workspace.yaml'), readTemplate('pnpm-workspace.yaml.tpl'))
+
+  // Frontend files
+  writeOut(join(targetDir, 'frontend/package.json'), fePkgContent)
+  writeOut(join(targetDir, 'frontend/vite.config.ts'), render(readTemplate('vite.config.ts.tpl'), vars))
+  writeOut(join(targetDir, 'frontend/embed.html'), render(readTemplate('embed.html.tpl'), vars))
+  writeOut(join(targetDir, 'frontend/tsconfig.json'), render(readTemplate('tsconfig.json.tpl'), vars))
+  writeOut(join(targetDir, 'frontend/src/main.tsx'), render(readTemplate('main.tsx.tpl', inputType), vars))
+  writeOut(join(targetDir, 'frontend/src/locales/zh-CN.json'), render(readTemplate('zh-CN.json.tpl', inputType), vars))
+  writeOut(join(targetDir, 'frontend/src/locales/en-US.json'), render(readTemplate('en-US.json.tpl', inputType), vars))
+
+  // 类型声明文件（让 tsc build 能识别 @minus/* 模块）
+  writeOut(join(targetDir, 'frontend/src/minus-runtime.d.ts'), `declare module '@minus/*';\n`)
+
+  // 4. git init (skip if git not installed)
+  try {
+    execSync('git --version', { stdio: 'pipe' })
+    execSync('git init', { cwd: targetDir, stdio: 'pipe' })
+    execSync('git add -A && git commit -m "init: scaffold by create-skill"', { cwd: targetDir, stdio: 'pipe' })
+    console.log('  ✓ Git 仓库已初始化')
+  } catch {}
+
+  // 5. 注册到 projects.json
+  try {
+    const projectsFile = join(homedir(), '.minus', 'projects.json')
+    let projects = { projects: [] }
+    try {
+      projects = JSON.parse(readFileSync(projectsFile, 'utf-8'))
+    } catch {}
+    if (!projects.projects) projects.projects = []
+    const now = new Date().toISOString()
+    if (!projects.projects.find(p => p.path === targetDir)) {
+      projects.projects.push({ name: displayName, path: targetDir, created_at: now, last_opened: now })
+      mkdirSync(dirname(projectsFile), { recursive: true })
+      writeFileSync(projectsFile, JSON.stringify(projects, null, 2))
+      console.log('  ✓ 已注册到项目列表')
+    }
+  } catch {
+    console.log('  ⚠ 注册到 projects.json 失败')
+  }
+
+  // 依赖安装延迟到首次进入项目时（Phase 4），scaffold 阶段不安装
+
+  // Output JSON summary for non-interactive consumers
+  if (nonInteractive) {
+    console.log(
+      `\n__CREATE_RESULT__${JSON.stringify({
+        folder,
+        targetDir,
+        skillId: skillResult.id,
+        apiKey: skillResult.apiKey,
+        port,
+        inputType
+      })}`
+    )
+  }
+
+  console.log(`
+  ✓ 项目已创建：${folder}/
+  位置：${targetDir}
+
+  下一步：打开项目文件夹开始开发
+  依赖会在首次进入项目时自动安装。
+`)
+}
+
+main().catch(e => {
+  console.error(e)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@minus-ai/create-skill",
+  "version": "0.1.0-beta.1",
+  "type": "module",
+  "bin": {
+    "create-skill": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "templates/"
+  ]
+}