chore: 新增 monorepo skills sync 命令

Author: sonofmagic

.changeset/skills-sync-resources.md

@@ -0,0 +1,5 @@
+---
+"@icebreakers/monorepo": minor
+---
+
+新增 `monorepo skills sync` 命令，并将内置技能模板移动至 `resources/skills` 以便随包发布与同步。

packages/monorepo/README.md

@@ -15,10 +15,17 @@ npx monorepo -h
 npx monorepo ai create -o agentic-task.md -f
 # 或使用别名
 npx monorepo ai new --name checkout
+# 同步技能到全局目录
+npx monorepo skills sync
+# 仅同步指定目标
+npx monorepo skills sync --codex
+npx monorepo skills sync --claude
 ```
 
 `monorepo ai create`（别名 `ai new`）默认会把模板写入 `agentic/prompts/<timestamp>/prompt.md`，每次都会建一个以时间命名的目录，并在命令行提示可修改该目录名称，方便追加截图等素材；也可以通过参数自定义路径。
 
+`monorepo skills sync` 会将包内 `resources/skills/icebreakers-monorepo-cli` 同步到 `~/.codex/skills/icebreakers-monorepo-cli` 或 `~/.claude/skills/icebreakers-monorepo-cli`；未指定目标时会交互选择。
+
 `monorepo ai create` 支持批量生成：
 
 ```bash

packages/monorepo/package.json

@@ -52,6 +52,7 @@
     "assets",
     "bin",
     "dist",
+    "resources",
     "templates"
   ],
   "engines": {

skills/icebreakers-monorepo-cli/SKILL.md …skills/icebreakers-monorepo-cli/SKILL.mdskills/icebreakers-monorepo-cli/SKILL.md renamed to packages/monorepo/resources/skills/icebreakers-monorepo-cli/SKILL.md skills/icebreakers-monorepo-cli/SKILL.md renamed to packages/monorepo/resources/skills/icebreakers-monorepo-cli/SKILL.md

@@ -1,16 +1,18 @@
-import type { AgenticTemplateFormat } from '../commands'
-import type { CreateNewProjectOptions } from '../commands/create'
+import type { AgenticTemplateFormat, GenerateAgenticTemplateOptions } from '../commands/ai'
 import type { CleanCommandConfig, CliOpts } from '../types'
 import process from 'node:process'
 import input from '@inquirer/input'
 import select from '@inquirer/select'
 import { program } from 'commander'
-import { cleanProjects, createNewProject, createTimestampFolderName, defaultAgenticBaseDir, generateAgenticTemplate, generateAgenticTemplates, getCreateChoices, init, loadAgenticTasks, setVscodeBinaryMirror, syncNpmMirror, upgradeMonorepo } from '../commands'
+import { cleanProjects, createNewProject, createTimestampFolderName, defaultAgenticBaseDir, generateAgenticTemplate, generateAgenticTemplates, getCreateChoices, init, loadAgenticTasks, setVscodeBinaryMirror, skillTargets, syncNpmMirror, syncSkills, upgradeMonorepo } from '../commands'
 import { defaultTemplate } from '../commands/create'
-import { name, version } from '../constants'
+import { name as cliName, version } from '../constants'
 import { resolveCommandConfig } from '../core/config'
 import { logger } from '../core/logger'
 
+type SkillTarget = typeof skillTargets[number]
+type CreateNewProjectOptions = NonNullable<Parameters<typeof createNewProject>[0]>
+
 interface AiTemplateCommandOptions {
   output?: string
   force?: boolean
@@ -26,9 +28,15 @@ interface CleanCommandOptions {
   pinnedVersion?: string
 }
 
+interface SkillsSyncCommandOptions {
+  codex?: boolean
+  claude?: boolean
+  all?: boolean
+}
+
 const cwd = process.cwd()
 
-program.name(name).version(version)
+program.name(cliName).version(version)
 
 /**
  * 升级子命令：同步 assets 模板到当前仓库。
@@ -86,6 +94,41 @@ program.command('mirror').description('设置 VscodeBinaryMirror').action(async
   logger.success('set vscode binary mirror finished!')
 })
 
+const skillsCommand = program.command('skills').description('技能工具集')
+
+skillsCommand.command('sync')
+  .description('同步 resources/skills/icebreakers-monorepo-cli 到全局目录')
+  .option('--codex', '同步到 ~/.codex/skills')
+  .option('--claude', '同步到 ~/.claude/skills')
+  .option('--all', '同步全部目标')
+  .action(async (opts: SkillsSyncCommandOptions) => {
+    const selected = new Set<SkillTarget>()
+    if (opts.all) {
+      for (const target of skillTargets) {
+        selected.add(target)
+      }
+    }
+    else {
+      if (opts.codex) {
+        selected.add('codex')
+      }
+      if (opts.claude) {
+        selected.add('claude')
+      }
+    }
+
+    const options = selected.size
+      ? { cwd, targets: Array.from(selected) }
+      : { cwd }
+    const results = await syncSkills(options)
+    if (!results.length) {
+      logger.info('未选择任何目标，已跳过同步。')
+      return
+    }
+    logger.info(`[已同步的目标]:\n${results.map(item => `- ${item.target}: ${item.dest}`).join('\n')}\n`)
+    logger.success('skills sync finished!')
+  })
+
 const aiCommand = program.command('ai').description('AI 助手工具集')
 
 aiCommand.command('create')
@@ -104,7 +147,7 @@ aiCommand.command('create')
     const output = opts.output ?? aiConfig?.output
     const baseDir = opts.dir ?? aiConfig?.baseDir ?? defaultAgenticBaseDir
     const tasksFile = opts.tasks ?? aiConfig?.tasksFile
-    const name = opts.name
+    const templateName = opts.name
 
     const shouldUseTasks = Boolean(tasksFile && !opts.output && !opts.name)
 
@@ -123,7 +166,7 @@ aiCommand.command('create')
     }
 
     let folderName: string | undefined
-    if (!output && !name) {
+    if (!output && !templateName) {
       const generated = createTimestampFolderName()
       const answer = await input({
         message: '提示词将写入哪个文件夹？（可回车确认或自定义）',
@@ -132,25 +175,34 @@ aiCommand.command('create')
       folderName = (answer?.trim?.() ?? generated) || generated
     }
 
-    await generateAgenticTemplate({
+    const templateOptions: GenerateAgenticTemplateOptions = {
       cwd,
-      output,
       force,
       format,
       baseDir,
-      name,
-      folderName,
-    })
+    }
+    if (output !== undefined) {
+      templateOptions.output = output
+    }
+    if (templateName !== undefined) {
+      templateOptions.name = templateName
+    }
+    if (folderName !== undefined) {
+      templateOptions.folderName = folderName
+    }
+
+    await generateAgenticTemplate(templateOptions)
   })
 
 program.command('new')
   .description('创建一个新的子包')
   .alias('create')
   .argument('[name]')
-  .action(async (name: string) => {
+  .action(async (inputName: string) => {
     const createConfig = await resolveCommandConfig('create', cwd)
-    if (!name) {
-      name = await input({
+    let packageName = inputName
+    if (!packageName) {
+      packageName = await input({
         message: '请输入包名',
         default: createConfig?.name ?? 'my-package',
       })
@@ -162,7 +214,7 @@ program.command('new')
     })
 
     await createNewProject({
-      name,
+      name: packageName,
       cwd,
       type,
     })

…kers-monorepo-cli/references/commands.md …kers-monorepo-cli/references/commands.mdskills/icebreakers-monorepo-cli/references/commands.md renamed to packages/monorepo/resources/skills/icebreakers-monorepo-cli/references/commands.md skills/icebreakers-monorepo-cli/references/commands.md renamed to packages/monorepo/resources/skills/icebreakers-monorepo-cli/references/commands.md

@@ -5,6 +5,7 @@ import path from 'pathe'
 import set from 'set-value'
 import { resolveCommandConfig } from '../core/config'
 import { getWorkspaceData } from '../core/workspace'
+import { getSkillTargetPaths } from './skills'
 
 function mergeCleanConfig(base?: CleanCommandConfig, overrides?: Partial<CleanCommandConfig>): CleanCommandConfig {
   const normalizedBase = base ?? {}
@@ -65,10 +66,12 @@ export async function cleanProjects(cwd: string, overrides?: Partial<CleanComman
 
   const readmeZh = path.resolve(workspaceDir, 'README.zh-CN.md')
   const qoderDir = path.resolve(workspaceDir, '.qoder')
+  const skillTargets = Object.values(getSkillTargetPaths())
   const candidates = Array.from(new Set([
     ...cleanDirs.filter(Boolean),
     readmeZh,
     qoderDir,
+    ...skillTargets,
   ]))
   await Promise.all(candidates.map(async (dir) => {
     if (await fs.pathExists(dir)) {

…eakers-monorepo-cli/references/config.md …eakers-monorepo-cli/references/config.mdskills/icebreakers-monorepo-cli/references/config.md renamed to packages/monorepo/resources/skills/icebreakers-monorepo-cli/references/config.md skills/icebreakers-monorepo-cli/references/config.md renamed to packages/monorepo/resources/skills/icebreakers-monorepo-cli/references/config.md

@@ -1,13 +1,15 @@
 import type { GetWorkspacePackagesOptions } from '../types'
 import type { AgenticTemplateFormat, AgenticTemplateTask, GenerateAgenticTemplateOptions } from './ai'
 import type { CreateNewProjectOptions } from './create'
+import type { SkillTarget, SyncSkillsOptions } from './skills'
 import { GitClient } from '../core/git'
 import { getWorkspaceData, getWorkspacePackages } from '../core/workspace'
 import { createTimestampFolderName, defaultAgenticBaseDir, generateAgenticTemplate, generateAgenticTemplates, loadAgenticTasks } from './ai'
 import { cleanProjects } from './clean'
 import { createNewProject, getCreateChoices, getTemplateMap, templateMap } from './create'
 import { init } from './init'
 import { setVscodeBinaryMirror } from './mirror'
+import { getSkillTargetPaths, skillTargets, syncSkills } from './skills'
 import { syncNpmMirror } from './sync'
 import { upgradeMonorepo } from './upgrade'
 
@@ -17,6 +19,8 @@ export type {
   CreateNewProjectOptions,
   GenerateAgenticTemplateOptions,
   GetWorkspacePackagesOptions,
+  SkillTarget,
+  SyncSkillsOptions,
 }
 
 export {
@@ -27,14 +31,17 @@ export {
   generateAgenticTemplate,
   generateAgenticTemplates,
   getCreateChoices,
+  getSkillTargetPaths,
   getTemplateMap,
   getWorkspaceData,
   getWorkspacePackages,
   GitClient,
   init,
   loadAgenticTasks,
   setVscodeBinaryMirror,
+  skillTargets,
   syncNpmMirror,
+  syncSkills,
   templateMap,
   upgradeMonorepo,
 }