reskill 0.15.0 → 0.16.0

package/README.md

@@ -153,9 +153,35 @@ npx reskill@latest list
 | `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

@@ -115,13 +115,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 +143,46 @@ 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 link <path>`        | 链接本地 skill（开发用）                        |
+| `npx reskill@latest unlink <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 +280,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 +334,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;AA6KpC;;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,3 +1,4 @@
+export { completionCommand, maybeHandleCompletion } from './completion.js';
 export { infoCommand } from './info.js';
 export { initCommand } from './init.js';
 export { installCommand } from './install.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,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"}

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"}