apple-design-skill 0.0.2 → 0.0.3

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-design-skill",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Apple-style interface design with complete dropdown verification.",
   "author": {
     "name": "yqstar",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-design-skill",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Apple-style interface design with complete dropdown verification.",
   "author": {
     "name": "yqstar",

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.0.3
+
+- Default all CLI commands to user scope and the Codex, Claude Code and Cursor targets; keep `--global` and `--all` as explicit equivalents.
+- Support `--project` for the current project and `--project PATH` for a specific project, with `--agent` limiting the selected tools in either scope.
+- Document the default change from 0.0.2 and earlier, and verify user/project isolation across installation, activation, listing and uninstall.
+
 ## 0.0.2
 
 - Remove multi-agent collaboration guidance and related package and plugin descriptions.

package/README.md

@@ -10,13 +10,13 @@
 
 [快速开始](#快速开始) · [使用前后对比](#使用前后对比) · [安装与版本管理](docs/installation.md) · [参与贡献](CONTRIBUTING.md)
 
-在目标项目中安装给 Codex（Node.js 22+）：
+一条命令安装给当前用户的 Codex、Claude Code 和 Cursor，跨项目使用（Node.js 22+）：
 
 ```sh
-npx apple-design-skill@latest install --agent codex
+npx apple-design-skill@latest install
 ```
 
-使用 Claude Code 或 Cursor？见[快速开始](#快速开始)。
+只安装给某个工具，或安装到项目目录？见[快速开始](#快速开始)。
 
 ## 使用前后对比
 
@@ -46,20 +46,25 @@ python3 -m http.server 4177 --bind 127.0.0.1 --directory examples/agent-learning
 
 ## 快速开始
 
-需要 **Node.js 22+**。在你要使用 Skill 的项目目录中执行：
+需要 **Node.js 22+**。默认安装到用户目录，可在任意目录执行：
 
 ```sh
-# Codex
-npx apple-design-skill@latest install --agent codex
+# 默认：用户级安装，供 Codex、Claude Code、Cursor 使用
+npx apple-design-skill@latest install
 
-# Claude Code
+# 只安装给指定工具
+npx apple-design-skill@latest install --agent codex
 npx apple-design-skill@latest install --agent claude
-
-# Cursor
 npx apple-design-skill@latest install --agent cursor
+
+# 仅安装到当前项目
+npx apple-design-skill@latest install --project
+
+# 安装到指定项目，也可同时选择工具
+npx apple-design-skill@latest install --project ./my-project --agent codex
 ```
 
-选择你使用的工具执行一条即可。需要同时安装给三个工具时使用 `install --all`；先查看目标路径可追加 `--dry-run`。npm 下载本包不会自动写入技能目录，`install` 命令才会执行安装。
+默认目标为 `~/.agents/skills`（Codex）、`~/.claude/skills`（Claude Code）、`~/.cursor/skills`（Cursor）中的 `apple-design-skill`。`--global` 和 `--all` 可显式声明默认行为；`--agent` 限定工具，`--project [路径]` 切换到项目目录。先查看目标路径可追加 `--dry-run`。npm 下载本包不会自动写入技能目录，`install` 命令才会执行安装。
 
 安装后，在新会话中给出具体任务：
 
@@ -69,7 +74,7 @@ npx apple-design-skill@latest install --agent cursor
 特别检查下拉按钮与展开菜单，并验证键盘选择、关闭方式和窄屏布局。
 ```
 
-Codex 可显式调用 `$apple-design-skill`，Claude Code 可调用 `/apple-design-skill`。固定版本、用户级安装、重复入口、升级与回退见[安装指南](docs/installation.md)。
+Codex 可显式调用 `$apple-design-skill`，Claude Code 可调用 `/apple-design-skill`。固定版本、项目级安装、重复入口、升级与回退见[安装指南](docs/installation.md)。
 
 ## 适合哪些任务
 

package/bin/apple-design-skill.mjs

@@ -7,6 +7,7 @@ import { execute, resolveTargets, validateName, validateVersion } from '../lib/i
 
 const packageRoot = fileURLToPath(new URL('../', import.meta.url));
 const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const defaultAgents = ['codex', 'claude', 'cursor'];
 const help = `apple-design-skill ${pkg.version}
 
 Usage:
@@ -17,9 +18,9 @@ Usage:
 
 Options:
   --agent NAME[,NAME]  codex, claude, cursor, universal (repeatable)
-  --all               Codex + Claude Code + Cursor
-  --project PATH      Project scope (default: current directory)
-  --global            User scope, in your home directory
+  --all               Codex + Claude Code + Cursor (default)
+  --global            User scope, in your home directory (default)
+  --project [PATH]    Project scope; omit PATH to use the current directory
   --name NAME         Skill name; use a distinct name for side-by-side versions
   --force             Back up and replace existing or locally modified files
   --dry-run           Show planned changes without writing files
@@ -27,12 +28,19 @@ Options:
   -v, --version       Print npm package version
   -h, --help          Show help
 
-Default target: universal (.agents/skills), also discovered by Codex and Cursor.
+Default: install for Codex, Claude Code and Cursor in your home directory.
+  Codex:       ~/.agents/skills
+  Claude Code: ~/.claude/skills
+  Cursor:      ~/.cursor/skills
+Use --agent to select tools, or --agent universal for only .agents/skills.
+All commands use the same scope and target defaults; use --project for project copies.
 No files are installed by npm postinstall; run the install command explicitly.
 
 Examples:
-  npx apple-design-skill@${pkg.version} install --all --project .
-  npx apple-design-skill@${pkg.version} install --agent claude --global
+  npx apple-design-skill@${pkg.version} install
+  npx apple-design-skill@${pkg.version} install --agent claude
+  npx apple-design-skill@${pkg.version} install --project
+  npx apple-design-skill@${pkg.version} install --agent codex --project ./my-project
   npx apple-design-skill@${pkg.version} install --name apple-design-pinned
   npx apple-design-skill@latest use ${pkg.version} --all
 `;
@@ -49,7 +57,7 @@ try {
   if (!['install', 'use', 'list', 'uninstall'].includes(command)) throw new Error(`Unknown command: ${command}`);
   const requestedVersion = command === 'use' ? argv.shift() : pkg.version;
   if (command === 'use') validateVersion(requestedVersion);
-  let scopeRoot = process.cwd();
+  let scopeRoot = homedir();
   let scopeFlag;
   const agents = [];
   const options = { command, packageRoot, version: requestedVersion, name: 'apple-design-skill', force: false, dryRun: false };
@@ -61,11 +69,14 @@ try {
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (arg === '--agent') { agents.push(...next(arg, i++).split(',')); }
-    else if (arg === '--all') { agents.push('codex', 'claude', 'cursor'); }
+    else if (arg === '--all') { agents.push(...defaultAgents); }
     else if (arg === '--project' || arg === '--global') {
       if (scopeFlag) throw new Error('Choose one of --project or --global');
       scopeFlag = arg;
-      scopeRoot = arg === '--project' ? resolve(next(arg, i++)) : homedir();
+      if (arg === '--project') {
+        const path = argv[i + 1] && !argv[i + 1].startsWith('-') ? argv[++i] : '.';
+        scopeRoot = resolve(path);
+      } else scopeRoot = homedir();
     } else if (arg === '--name') { options.name = next(arg, i++); }
     else if (arg === '--force') options.force = true;
     else if (arg === '--dry-run') options.dryRun = true;
@@ -74,7 +85,7 @@ try {
   }
   validateName(options.name);
   options.scopeRoot = resolve(scopeRoot);
-  options.targets = resolveTargets(options.scopeRoot, agents.length ? agents : ['universal'], options.name);
+  options.targets = resolveTargets(options.scopeRoot, agents.length ? agents : defaultAgents, options.name);
   const result = execute(options);
   if (json) process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
   else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-design-skill",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Apple-style interface design skills for Codex, Claude Code, Cursor and Agent Skills hosts, with versioned installation.",
   "type": "module",
   "bin": {