@fastagent/cli 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +23 -0
  2. package/cli.js +331 -319
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -201,6 +201,27 @@ fastagent doctor --config ./fastagent.config.json
201
201
  - 带 `--config <path>` 时:`config.sandbox.launcher` -> env -> PATH
202
202
  - 若两者都没有,会直接提示 companion package / env 的修复方式
203
203
 
204
+ ## Skills 命令
205
+
206
+ - `fastagent skills add <source>` 默认走 runtime 推断:
207
+ repo-local 本地 source 会安装到当前 workspace 的 `.fastagent/skills/<name>`,
208
+ 其他 source 默认安装到 runtime-global skill root `<globalDataDir>/skills/<name>`;
209
+ 对普通 npm 安装且未显式覆盖时,通常是 `~/.fastagent/skills/<name>`
210
+ - `fastagent skills add <source> --scope project` 强制安装到当前 workspace 的 `.fastagent/skills/<name>`
211
+ - `fastagent skills add <source> --scope user` 强制安装到 runtime-global skill root `<globalDataDir>/skills/<name>`;
212
+ 对普通 npm 安装且未显式覆盖时,通常是 `~/.fastagent/skills/<name>`
213
+ - `fastagent skills add <source> --list` 只列出候选 skill,不写磁盘
214
+ - `fastagent skills list` 默认同时列出 project + user 两个 scope 的已安装 skill,并按 scope 分组显示
215
+ - `fastagent skills list --scope project|user` 只列出单一 scope 的已安装 skill
216
+ - `fastagent skills add` 不再暴露 `--yes`;当前没有 CLI-owned confirmation flow
217
+
218
+ 当前常见 source 形态:
219
+
220
+ - 本地路径:已有目录优先按本地 source 处理,包括 `./skills/demo-skill`
221
+ - GitHub shorthand:`owner/repo`
222
+ - GitHub repo URL:`https://github.com/<owner>/<repo>`
223
+ - GitHub tree URL:`https://github.com/<owner>/<repo>/tree/<ref>` 或 `.../tree/<ref>/skills/...`
224
+
204
225
  ## 常见用例
205
226
 
206
227
  ```bash
@@ -210,7 +231,9 @@ fastagent --channel weixin
210
231
  fastagent --channel weixin --output jsonl
211
232
  fastagent --channel weixin --sandbox local
212
233
  fastagent skills add owner/repo
234
+ fastagent skills add owner/repo --list
213
235
  fastagent skills add ./skills/review-pr --scope project
236
+ fastagent skills list --scope user
214
237
  fastagent config
215
238
  fastagent doctor
216
239
  fastagent skills list