eskill 1.0.27 → 1.0.29

package/cli.js

@@ -13,7 +13,8 @@ const program = new Command();
 program
   .name('eskill')
   .description('Unified AI Agent Skills Management - Install skills from Git URLs')
-  .version('1.0.27');
+  .version('1.0.29')
+  .option('-g, --global', '使用全局技能目录（~/.eskill/skills/），否则使用当前目录（./.claude/skills/）', false);
 
 // 安装命令
 program
@@ -26,7 +27,11 @@ program
   .option('-f, --force', '强制覆盖已存在的技能', false)
   .action(async (url, options) => {
     try {
-      const result = await installFromGitUrl(url, options);
+      // 获取全局选项
+      const globalOptions = program.opts();
+      const fullOptions = { ...options, global: globalOptions.global };
+
+      const result = await installFromGitUrl(url, fullOptions);
 
       // 如果用户取消安装，正常退出
       if (result && result.cancelled) {
@@ -49,14 +54,19 @@ program
   .option('-a, --agent <name>', '目标 agent', getDefaultAgent())
   .action(async (options) => {
     try {
-      const skills = await listSkills(options.agent);
+      // 获取全局选项
+      const globalOptions = program.opts();
+      const global = globalOptions.global;
+
+      const skills = await listSkills(options.agent, global);
 
       if (skills.length === 0) {
         console.log('未安装任何技能');
         return;
       }
 
-      console.log(`\n已安装的技能:\n`);
+      const location = global ? '~/.eskill/skills/' : './.claude/skills/';
+      console.log(`\n已安装的技能 (${location}):\n`);
       skills.forEach(skill => {
         const displayName = skill.author ? `${skill.name}@${skill.author}` : skill.name;
         const versionInfo = skill.version || (skill.commitHash ? `#${skill.commitHash.substring(0, 7)}` : '');
@@ -84,7 +94,11 @@ program
   .option('-a, --agent <name>', '目标 agent', getDefaultAgent())
   .action(async (name, options) => {
     try {
-      removeSkill(name, options.agent);
+      // 获取全局选项
+      const globalOptions = program.opts();
+      const global = globalOptions.global;
+
+      removeSkill(name, options.agent, global);
     } catch (error) {
       console.error(`错误: ${error.message}`);
       process.exit(1);
@@ -99,14 +113,18 @@ program
   .option('-f, --force', '强制更新（即使版本相同）', false)
   .action(async (name, options) => {
     try {
+      // 获取全局选项
+      const globalOptions = program.opts();
+      const fullOptions = { ...options, global: globalOptions.global };
+
       // 支持显式使用 "all" 参数
       if (name === 'all' || name === 'All' || name === 'ALL') {
         // 更新所有技能
-        await updateAllSkills(options);
+        await updateAllSkills(fullOptions);
       } else if (name) {
         // 更新单个技能
         console.log(`\n检查技能: ${name}`);
-        const result = await updateSkill(name, options);
+        const result = await updateSkill(name, fullOptions);
 
         if (result.local) {
           console.log('\n⚠️  本地技能无法自动更新，请手动更新\n');
@@ -119,7 +137,7 @@ program
         }
       } else {
         // 更新所有技能（不指定参数时）
-        await updateAllSkills(options);
+        await updateAllSkills(fullOptions);
       }
     } catch (error) {
       console.error(`\n❌ 更新失败: ${error.message}\n`);
@@ -289,6 +307,10 @@ program
   .option('-a, --all', '清理所有数据（包括配置和技能）', false)
   .action(async (options) => {
     try {
+      // 获取全局选项
+      const globalOptions = program.opts();
+      const global = globalOptions.global;
+
       if (options.all) {
         console.log('\n⚠️  警告：这将删除所有 eskill 数据（包括 API Key 配置和已安装的技能）');
 
@@ -306,8 +328,9 @@ program
           }
         });
       } else {
-        console.log('\n清理所有已安装的技能（保留配置）...\n');
-        cleanupAllSkills();
+        const location = global ? '~/.eskill/skills/' : './.claude/skills/';
+        console.log(`\n清理 ${location} 中的所有技能...\n`);
+        cleanupAllSkills(global);
       }
     } catch (error) {
       console.error(`\n❌ 清理失败: ${error.message}\n`);

package/lib/installer.js

@@ -58,21 +58,43 @@ function getEskillPackageDir() {
 }
 
 /**
- * 获取技能存储目录（用户主目录下，不受 npm 更新影响）
+ * 获取技能目录
+ * @param {boolean} global - 是否使用全局目录
  */
-function getSkillsStorageDir() {
-  return join(homedir(), '.eskill', 'skills');
+function getSkillsDir(global = false) {
+  if (global) {
+    // 全局模式：使用 ~/.eskill/skills/
+    return join(homedir(), '.eskill', 'skills');
+  } else {
+    // 本地模式：使用当前目录的 .claude/skills/
+    return join(process.cwd(), '.claude', 'skills');
+  }
+}
+
+/**
+ * 获取技能存储目录（用于元数据）
+ * @param {boolean} global - 是否使用全局目录
+ */
+function getSkillsStorageDir(global = false) {
+  if (global) {
+    // 全局模式：使用 ~/.eskill/skills/
+    return join(homedir(), '.eskill', 'skills');
+  } else {
+    // 本地模式：使用当前目录（项目根目录）
+    return process.cwd();
+  }
 }
 
 /**
  * 迁移旧位置的技能到新位置
+ * @param {boolean} global - 是否全局模式
  */
-function migrateOldSkills() {
+function migrateOldSkills(global = false) {
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = dirname(__filename);
   const pkgDir = dirname(__dirname);
   const oldDir = join(pkgDir, 'skills-storage');
-  const newDir = getSkillsStorageDir();
+  const newDir = getSkillsStorageDir(global);
 
   // 如果旧位置不存在，无需迁移
   if (!existsSync(oldDir)) {
@@ -84,6 +106,11 @@ function migrateOldSkills() {
     return;
   }
 
+  // 只在全局模式下迁移
+  if (!global) {
+    return;
+  }
+
   try {
     // 创建新目录
     mkdirSync(newDir, { recursive: true });
@@ -119,9 +146,10 @@ function migrateOldSkills() {
 
 /**
  * 读取所有技能元数据
+ * @param {boolean} global - 是否全局模式
  */
-function getAllSkillsMeta() {
-  const skillDir = getSkillsStorageDir();
+function getAllSkillsMeta(global = false) {
+  const skillDir = getSkillsStorageDir(global);
   const metaPath = join(skillDir, '.eskill-meta.json');
 
   if (!existsSync(metaPath)) {
@@ -138,9 +166,11 @@ function getAllSkillsMeta() {
 
 /**
  * 保存所有技能元数据
+ * @param {metaArray} metaArray - 元数据数组
+ * @param {boolean} global - 是否全局模式
  */
-function saveAllSkillsMeta(metaArray) {
-  const skillDir = getSkillsStorageDir();
+function saveAllSkillsMeta(metaArray, global = false) {
+  const skillDir = getSkillsStorageDir(global);
 
   // 确保目录存在
   if (!existsSync(skillDir)) {
@@ -153,9 +183,12 @@ function saveAllSkillsMeta(metaArray) {
 
 /**
  * 保存单个技能元数据
+ * @param {string} skillName - 技能名称
+ * @param {object} meta - 元数据
+ * @param {boolean} global - 是否全局模式
  */
-function saveSkillMeta(skillName, meta) {
-  const allMeta = getAllSkillsMeta();
+function saveSkillMeta(skillName, meta, global = false) {
+  const allMeta = getAllSkillsMeta(global);
 
   // 查找并更新或添加
   const index = allMeta.findIndex(m => m.name === skillName);
@@ -165,24 +198,28 @@ function saveSkillMeta(skillName, meta) {
     allMeta.push(meta);
   }
 
-  saveAllSkillsMeta(allMeta);
+  saveAllSkillsMeta(allMeta, global);
 }
 
 /**
  * 读取单个技能元数据
+ * @param {string} skillName - 技能名称
+ * @param {boolean} global - 是否全局模式
  */
-function getSkillMeta(skillName) {
-  const allMeta = getAllSkillsMeta();
+function getSkillMeta(skillName, global = false) {
+  const allMeta = getAllSkillsMeta(global);
   return allMeta.find(m => m.name === skillName) || null;
 }
 
 /**
  * 删除技能元数据
+ * @param {string} skillName - 技能名称
+ * @param {boolean} global - 是否全局模式
  */
-function removeSkillMeta(skillName) {
-  const allMeta = getAllSkillsMeta();
+function removeSkillMeta(skillName, global = false) {
+  const allMeta = getAllSkillsMeta(global);
   const newMeta = allMeta.filter(m => m.name !== skillName);
-  saveAllSkillsMeta(newMeta);
+  saveAllSkillsMeta(newMeta, global);
 }
 
 /**
@@ -280,7 +317,7 @@ function confirmAction(message) {
  * 从 Git URL 安装技能
  */
 export async function installFromGitUrl(gitUrl, options = {}) {
-  const { agent = 'claude', link = false, force = false } = options;
+  const { agent = 'claude', link = false, force = false, global = false } = options;
 
   // 检测并处理 name@author 格式
   let actualUrl = await handleSkillAtAuthorFormat(gitUrl);
@@ -303,17 +340,17 @@ export async function installFromGitUrl(gitUrl, options = {}) {
     console.log(`路径: ${parsed.path}`);
   }
 
-  // 获取技能存储目录
-  const skillDir = getSkillsStorageDir();
+  // 获取技能目录（技能文件存放位置）
+  const skillsDir = getSkillsDir(global);
 
   // 确保技能目录存在
-  if (!existsSync(skillDir)) {
-    mkdirSync(skillDir, { recursive: true });
+  if (!existsSync(skillsDir)) {
+    mkdirSync(skillsDir, { recursive: true });
   }
 
   // 确定技能名称
   const skillName = parsed.path ? basename(parsed.path) : parsed.repo;
-  const targetPath = join(skillDir, skillName);
+  const targetPath = join(skillsDir, skillName);
 
   // 检查是否已存在
   if (existsSync(targetPath)) {
@@ -366,8 +403,9 @@ export async function installFromGitUrl(gitUrl, options = {}) {
     }
 
     console.log(`\n✓ 技能已安装到: ${targetPath}`);
-    console.log(`  存储位置: ~/.eskill/skills/`);
-    console.log(`  说明: 技能永久保存，更新 eskill 不会丢失`);
+    const metaLocation = global ? '~/.eskill/skills/.eskill-meta.json' : './.eskill-meta.json';
+    console.log(`  元数据位置: ${metaLocation}`);
+    console.log(`  说明: 技能永久保存，可提交到 Git`);
 
     // 获取 git 版本信息
     const commitHash = getGitCommitHash(sourcePath);
@@ -385,7 +423,7 @@ export async function installFromGitUrl(gitUrl, options = {}) {
       version,
       installedAt: new Date().toISOString(),
       updatedAt: new Date().toISOString()
-    });
+    }, global);
 
     return { success: true, path: targetPath };
   } finally {
@@ -400,11 +438,11 @@ export async function installFromGitUrl(gitUrl, options = {}) {
 /**
  * 列出已安装的技能
  */
-export function listSkills(agent = 'claude') {
+export function listSkills(agent = 'claude', global = false) {
   // 自动迁移旧位置的技能
-  migrateOldSkills();
+  migrateOldSkills(global);
 
-  const skillDir = getSkillsStorageDir();
+  const skillDir = getSkillsDir(global);
 
   if (!existsSync(skillDir)) {
     return [];
@@ -415,7 +453,7 @@ export function listSkills(agent = 'claude') {
     .filter(dirent => dirent.isDirectory());
 
   // 读取所有元数据
-  const allMeta = getAllSkillsMeta();
+  const allMeta = getAllSkillsMeta(global);
 
   return skillDirs.map(dirent => {
     const skillPath = join(skillDir, dirent.name);
@@ -435,8 +473,8 @@ export function listSkills(agent = 'claude') {
 /**
  * 删除技能
  */
-export function removeSkill(skillName, agent = 'claude') {
-  const skillDir = getSkillsStorageDir();
+export function removeSkill(skillName, agent = 'claude', global = false) {
+  const skillDir = getSkillsDir(global);
   const targetPath = join(skillDir, skillName);
 
   if (!existsSync(targetPath)) {
@@ -444,15 +482,15 @@ export function removeSkill(skillName, agent = 'claude') {
   }
 
   rmSync(targetPath, { recursive: true, force: true });
-  removeSkillMeta(skillName);
+  removeSkillMeta(skillName, global);
   console.log(`✓ 已删除技能: ${skillName}`);
 }
 
 /**
  * 清理所有技能（用于卸载）
  */
-export function cleanupAllSkills() {
-  const skillDir = getSkillsStorageDir();
+export function cleanupAllSkills(global = false) {
+  const skillDir = getSkillsDir(global);
 
   if (!existsSync(skillDir)) {
     console.log('没有需要清理的技能');
@@ -490,10 +528,9 @@ export function cleanupAll() {
 
 /**
  * 获取技能存储目录路径
+ * 导出内部的 getSkillsDir 函数
  */
-export function getSkillsDir() {
-  return getSkillsStorageDir();
-}
+export { getSkillsDir };
 
 /**
  * 获取远程仓库的 commit hash（不克隆）
@@ -516,8 +553,8 @@ function getRemoteCommitHash(gitUrl, branch) {
  * 更新单个技能
  */
 export async function updateSkill(skillName, options = {}) {
-  const { force = false } = options;
-  const skillDir = getSkillsStorageDir();
+  const { force = false, global = false } = options;
+  const skillDir = getSkillsDir(global);
   const targetPath = join(skillDir, skillName);
 
   // 检查技能是否存在
@@ -526,7 +563,7 @@ export async function updateSkill(skillName, options = {}) {
   }
 
   // 读取元数据
-  const meta = getSkillMeta(skillName);
+  const meta = getSkillMeta(skillName, global);
 
   // 如果没有 gitUrl，说明是本地技能，无法更新
   if (!meta || !meta.gitUrl) {
@@ -599,7 +636,7 @@ export async function updateSkill(skillName, options = {}) {
       commitHash: newCommitHash,
       version: newVersion,
       updatedAt: new Date().toISOString()
-    });
+    }, global);
 
     return {
       success: true,
@@ -620,12 +657,12 @@ export async function updateSkill(skillName, options = {}) {
  * 更新所有技能
  */
 export async function updateAllSkills(options = {}) {
-  const { force = false } = options;
+  const { force = false, global = false } = options;
 
   // 自动迁移旧位置的技能
-  migrateOldSkills();
+  migrateOldSkills(global);
 
-  const skillDir = getSkillsStorageDir();
+  const skillDir = getSkillsDir(global);
 
   if (!existsSync(skillDir)) {
     console.log('未安装任何技能');
@@ -637,7 +674,7 @@ export async function updateAllSkills(options = {}) {
     .filter(dirent => dirent.isDirectory())
     .map(dirent => {
       const skillPath = join(skillDir, dirent.name);
-      const meta = getSkillMeta(dirent.name);
+      const meta = getSkillMeta(dirent.name, global);
       return {
         name: dirent.name,
         path: skillPath,
@@ -668,7 +705,7 @@ export async function updateAllSkills(options = {}) {
       }
 
       // 更新技能
-      const result = await updateSkill(skill.name, { force });
+      const result = await updateSkill(skill.name, { force, global });
 
       if (result.success && result.updated) {
         console.log(`✓ ${skill.name} - ${result.currentVersion} → ${result.newVersion}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eskill",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "description": "Unified AI Agent Skills Management - Install skills from Git URLs",
   "main": "index.js",
   "type": "module",