reskill 0.15.0 → 0.17.0

package/README.md

@@ -42,7 +42,6 @@ reskill offers **fine-grained skill management and synchronization**:
 
 - **Declarative config** — `skills.json` clearly expresses project dependencies
 - **Global cache** — Avoid redundant downloads, speed up installation
-- **Local development** — Use `link` to develop and debug skills locally
 
 ### Engineering-Grade Management
 
@@ -151,11 +150,35 @@ npx reskill@latest list
 | `npx reskill@latest update [skill]` | Update all or specific skill |
 | `npx reskill@latest outdated` | Check for outdated skills |
 | `npx reskill@latest uninstall <skill>` | Remove a skill |
-| `npx reskill@latest link <path>` | Link local skill for development |
-| `npx reskill@latest unlink <skill>` | Unlink a local skill |
+| `npx reskill@latest completion install` | Install shell tab completion |
 
 Run `npx reskill@latest <command> --help` for detailed options.
 
+### Shell Completion
+
+reskill supports tab completion for bash, zsh, and fish shells.
+
+```bash
+# Install completion (interactive, one-time setup)
+reskill completion install
+
+# Then restart your shell or run:
+source ~/.zshrc   # for zsh
+source ~/.bashrc  # for bash
+```
+
+After installation, you can use tab completion:
+
+```bash
+reskill <Tab>              # Show all commands
+reskill info <Tab>         # Complete installed skill names
+reskill uninstall <Tab>    # Complete installed skill names
+reskill install -<Tab>     # Complete options (-f, -g, -a, etc.)
+reskill install -a <Tab>   # Complete agent names
+```
+
+To remove completion: `reskill completion uninstall`
+
 ## Private GitLab Support
 
 reskill fully supports private GitLab repositories, including self-hosted instances. Authentication is handled transparently through your system's git configuration.

package/README.zh-CN.md

@@ -42,7 +42,6 @@ reskill 提供**精细化的 skill 管理和同步方案**：
 
 - **声明式配置** — `skills.json` 清晰表达项目依赖
 - **全局缓存** — 避免重复下载，加速安装
-- **本地开发** — 使用 `link` 链接本地 skill 进行开发调试
 
 ### 工程化项目管理
 
@@ -115,13 +114,13 @@ npx reskill@latest install user/skill@v1.0.0
 
 ### 版本规范
 
-| 格式 | 示例 | 说明 |
-|------|------|------|
-| 精确版本 | `@v1.0.0` | 锁定到指定 tag |
-| 最新版本 | `@latest` | 获取最新 tag |
-| 范围版本 | `@^2.0.0` | semver 兼容（>=2.0.0 <3.0.0） |
-| 分支 | `@branch:develop` | 指定分支 |
-| Commit | `@commit:abc1234` | 指定 commit hash |
+| 格式     | 示例              | 说明                          |
+| -------- | ----------------- | ----------------------------- |
+| 精确版本 | `@v1.0.0`         | 锁定到指定 tag                |
+| 最新版本 | `@latest`         | 获取最新 tag                  |
+| 范围版本 | `@^2.0.0`         | semver 兼容（>=2.0.0 <3.0.0） |
+| 分支     | `@branch:develop` | 指定分支                      |
+| Commit   | `@commit:abc1234` | 指定 commit hash              |
 
 ## 命令
 
@@ -143,20 +142,44 @@ npx reskill@latest list
 
 ### 命令参考
 
-| 命令 | 说明 |
-|------|------|
-| `npx reskill@latest init` | 在当前目录初始化 `skills.json` |
-| `npx reskill@latest install [skill]` | 安装 `skills.json` 中的所有 skills 或指定 skill |
-| `npx reskill@latest list` | 列出已安装的 skills |
-| `npx reskill@latest info <skill>` | 查看 skill 详情 |
-| `npx reskill@latest update [skill]` | 更新所有或指定 skill |
-| `npx reskill@latest outdated` | 检查过期的 skills |
-| `npx reskill@latest uninstall <skill>` | 卸载 skill |
-| `npx reskill@latest link <path>` | 链接本地 skill（开发用） |
-| `npx reskill@latest unlink <skill>` | 取消链接本地 skill |
+| 命令                                    | 说明                                            |
+| --------------------------------------- | ----------------------------------------------- |
+| `npx reskill@latest init`               | 在当前目录初始化 `skills.json`                  |
+| `npx reskill@latest install [skill]`    | 安装 `skills.json` 中的所有 skills 或指定 skill |
+| `npx reskill@latest list`               | 列出已安装的 skills                             |
+| `npx reskill@latest info <skill>`       | 查看 skill 详情                                 |
+| `npx reskill@latest update [skill]`     | 更新所有或指定 skill                            |
+| `npx reskill@latest outdated`           | 检查过期的 skills                               |
+| `npx reskill@latest uninstall <skill>`  | 卸载 skill                                      |
+| `npx reskill@latest completion install` | 安装 Shell Tab 补全                             |
 
 运行 `npx reskill@latest <command> --help` 查看详细选项。
 
+### Shell 补全
+
+reskill 支持 bash、zsh 和 fish 的 Tab 补全。
+
+```bash
+# 安装补全（交互式，一次性设置）
+reskill completion install
+
+# 然后重启 shell 或执行：
+source ~/.zshrc   # zsh
+source ~/.bashrc  # bash
+```
+
+安装后即可使用 Tab 补全：
+
+```bash
+reskill <Tab>              # 显示所有命令
+reskill info <Tab>         # 补全已安装的 skill 名称
+reskill uninstall <Tab>    # 补全已安装的 skill 名称
+reskill install -<Tab>     # 补全选项 (-f, -g, -a 等)
+reskill install -a <Tab>   # 补全 agent 名称
+```
+
+卸载补全：`reskill completion uninstall`
+
 ## 私有 GitLab 支持
 
 reskill 完整支持私有 GitLab 仓库，包括自建实例。认证通过系统的 git 配置透明处理。
@@ -254,14 +277,14 @@ npx reskill@latest install git@git.mycompany.io:team/skill.git@v1.0.0
 
 reskill 支持所有主流 AI 编程 Agent。Skills 默认安装到 `.skills/` 目录，可与任何 Agent 集成。
 
-| Agent | 集成路径 |
-|-------|----------|
-| Cursor | `.cursor/rules/` 或 `.cursor/skills/` |
-| Claude Code | `.claude/skills/` |
-| Codex | `.codex/skills/` |
-| OpenCode | `.opencode/skills/` |
-| Windsurf | `.windsurf/skills/` |
-| GitHub Copilot | `.github/skills/` |
+| Agent          | 集成路径                              |
+| -------------- | ------------------------------------- |
+| Cursor         | `.cursor/rules/` 或 `.cursor/skills/` |
+| Claude Code    | `.claude/skills/`                     |
+| Codex          | `.codex/skills/`                      |
+| OpenCode       | `.opencode/skills/`                   |
+| Windsurf       | `.windsurf/skills/`                   |
+| GitHub Copilot | `.github/skills/`                     |
 
 ## Skill 仓库结构
 
@@ -308,10 +331,10 @@ my-project/
 
 ## 环境变量
 
-| 变量 | 说明 | 默认值 |
-|------|------|--------|
+| 变量                | 说明         | 默认值             |
+| ------------------- | ------------ | ------------------ |
 | `RESKILL_CACHE_DIR` | 全局缓存目录 | `~/.reskill-cache` |
-| `DEBUG` | 启用调试日志 | - |
+| `DEBUG`             | 启用调试日志 | -                  |
 
 ## 开发
 

package/dist/cli/commands/completion.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+/**
+ * completion command - Setup shell completion
+ */
+export declare const completionCommand: Command;
+/**
+ * Check if completion is being requested and handle it
+ *
+ * This should be called at the start of CLI execution
+ */
+export declare function maybeHandleCompletion(): boolean;
+export default completionCommand;
+//# sourceMappingURL=completion.d.ts.map

package/dist/cli/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2IpC;;GAEG;AACH,eAAO,MAAM,iBAAiB,SA2D1B,CAAC;AAEL;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAED,eAAe,iBAAiB,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -1,7 +1,7 @@
+export { completionCommand, maybeHandleCompletion } from './completion.js';
 export { infoCommand } from './info.js';
 export { initCommand } from './init.js';
 export { installCommand } from './install.js';
-export { linkCommand, unlinkCommand } from './link.js';
 export { listCommand } from './list.js';
 export { outdatedCommand } from './outdated.js';
 export { uninstallCommand } from './uninstall.js';

package/dist/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/commands/install.d.ts

@@ -1,18 +1,17 @@
 import { Command } from 'commander';
 /**
- * install command - Install a skill
+ * install command - Install a skill or all skills from skills.json
  *
- * Supports multiple installation modes:
- * - Project install (default): Install to project directory
- * - Global install (-g): Install to user home directory
- * - Multi-Agent install (-a): Install to specified agents
+ * Installation Flow:
+ * 1. Resolve target agents (CLI > stored > detected > prompt)
+ * 2. Resolve installation scope (global vs project)
+ * 3. Resolve installation mode (symlink vs copy)
+ * 4. Execute installation
+ * 5. Save defaults for future installs
  *
- * Interactive flow:
- * 1. Detect installed agents
- * 2. Select target agents (multi-select)
- * 3. Select installation scope (project/global)
- * 4. Select installation method (symlink/copy)
- * 5. Confirm and execute
+ * Behavior:
+ * - Single skill install: Prompts for agents/mode (stored config as defaults)
+ * - Reinstall all (no args): Uses stored config directly, no confirmation
  */
 export declare const installCommand: Command;
 export default installCommand;

package/dist/cli/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,SAkYvB,CAAC;AAEL,eAAe,cAAc,CAAC"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkjBpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,SA6DvB,CAAC;AAEL,eAAe,cAAc,CAAC"}

package/dist/cli/commands/uninstall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAezB,CAAC;AAEL,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAoEzB,CAAC;AAEL,eAAe,gBAAgB,CAAC"}