## ADDED Requirements

### Requirement: 系统必须持久化安装记录

工具必须在每次成功安装后，将安装信息写入 `~/.skillmgr/install.json`。

#### Scenario: 创建新记录

- **WHEN** 首次安装某个 skill/command
- **THEN** 系统在 install.json 的 installations 数组中添加新记录

#### Scenario: 记录包含必要字段

- **WHEN** 创建安装记录
- **THEN** 记录必须包含 type、name、source_repo、platform、scope、install_path、installed_at、updated_at

---

### Requirement: 用户可以查询已安装项

工具必须提供命令列出所有已安装的 skills 和 commands。

#### Scenario: 列出所有已安装项

- **WHEN** 用户执行 `skillmgr list` 命令
- **THEN** 系统显示所有 install.json 中的记录

#### Scenario: 按类型过滤

- **WHEN** 用户执行 `skillmgr list --type skill` 或 `--type command`
- **THEN** 系统仅显示对应类型的安装记录

#### Scenario: 按平台过滤

- **WHEN** 用户执行 `skillmgr list --platform claude` 或 `--platform opencode`
- **THEN** 系统仅显示对应平台的安装记录

#### Scenario: 按作用域过滤

- **WHEN** 用户执行 `skillmgr list --global` 或省略该参数
- **THEN** 系统仅显示对应作用域的安装记录

#### Scenario: 无已安装项

- **WHEN** install.json 为空或不存在
- **THEN** 系统提示"无已安装的 skills/commands"

---

### Requirement: 用户可以卸载已安装项

工具必须提供卸载功能，删除文件并移除安装记录。

#### Scenario: 卸载 skill

- **WHEN** 用户执行 `skillmgr uninstall skill <name> --platform <platform> --global`
- **THEN** 系统从 install.json 查找记录，删除对应目录，移除记录

#### Scenario: 卸载 command

- **WHEN** 用户执行 `skillmgr uninstall command <group> --platform <platform> --global`
- **THEN** 系统删除对应的命令文件或目录，移除记录

#### Scenario: 卸载不存在的项

- **WHEN** install.json 中无对应记录
- **THEN** 系统提示"未找到安装记录"，不执行删除

#### Scenario: 安装路径已被手动删除

- **WHEN** install.json 有记录但文件已不存在
- **THEN** 系统仅移除记录，不报错

---

### Requirement: 用户可以更新已安装项

工具必须提供更新功能，重新从源仓库安装最新版本。

#### Scenario: 更新单个 skill

- **WHEN** 用户执行 `skillmgr update skill <name> --platform <platform> --global`
- **THEN** 系统从源重新安装到原路径，更新 updated_at 字段

#### Scenario: 更新单个 command

- **WHEN** 用户执行 `skillmgr update command <group> --platform <platform> --global`
- **THEN** 系统从源重新安装到原路径，更新 updated_at 字段

#### Scenario: 更新所有已安装项

- **WHEN** 用户执行 `skillmgr update --all`
- **THEN** 系统遍历 install.json 中所有记录，逐个更新

#### Scenario: 源仓库找不到原始项

- **WHEN** 更新时源仓库中不再存在该 skill/command
- **THEN** 系统报错，不修改已安装文件和记录

---

### Requirement: 用户可以清理孤立记录

工具必须提供命令扫描并清理 install.json 中文件路径已不存在的记录。

#### Scenario: 扫描孤立记录

- **WHEN** 用户执行 `skillmgr clean` 命令
- **THEN** 系统遍历 install.json 中所有记录，检查 install_path 是否存在

#### Scenario: 清理孤立记录

- **WHEN** 发现安装路径不存在的记录
- **THEN** 系统列出这些记录并从 install.json 中删除

#### Scenario: 无孤立记录

- **WHEN** 所有记录的安装路径都存在
- **THEN** 系统提示"无孤立记录"

#### Scenario: 显示清理结果

- **WHEN** 清理完成
- **THEN** 系统显示清理的记录数量和详情（type、name、platform、scope、路径）