القائمة
后端代码修改后，通过 CLI 测试验证功能正确性。使用场景：修改了 electron/services/ 下的代码需要测试、准备提交代码前跑回归、用户要求"跑测试"/"验证一下"。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
生成或审计模块的 SPEC.md。使用场景：用户要求"给 XX 模块写 spec"、"审计所有 spec"、"检查 spec 是否过期"。
Automates SailFish release workflow: fix build/type errors, update CHANGELOG (EN + CN), run npm version with pre/post hooks. Use when the user asks to release, 发版, 发布, bump version, or update changelog.
完成新功能开发或较大修改后，使用本机 Claude CLI 进行代码审查。
使用 ts-morph 静态分析工具查询代码结构（类层次、方法签名、引用、依赖等），替代手动读源码。使用场景：需要了解类的方法/属性、继承链、符号引用、文件结构、依赖关系时。
When committing or staging changes, only include files related to the current task or conversation; do not stage or commit unrelated modifications. Use when the user asks to commit, stage, 提交, or when preparing to run git add/commit.
阿里云 CLI (aliyun) 安装配置、ECS 管理、OSS 操作、安全组、DNS、SLB 常用命令
استنادا إلى تصنيف SOC المهني
| name | cli-testing |
| description | 后端代码修改后，通过 CLI 测试验证功能正确性。使用场景：修改了 electron/services/ 下的代码需要测试、准备提交代码前跑回归、用户要求"跑测试"/"验证一下"。 |
项目提供了 CLI 模式（npm run sailfish，sft/cli 为别名），可在纯 Node.js 下运行所有后端服务。
修改后端代码后，必须利用 CLI 验证功能正确性，不能只靠"能编译"就认为没问题。
electron/services/ 下的任何服务bash electron/cli/test-cli.sh --no-ai # 无需 AI API Key，~10秒
bash electron/cli/test-cli.sh # 有 API Key 时跑全量
| 改动范围 | 验证命令 |
|---|---|
| config.service.ts | sailfish config:get language && sailfish config:set theme '"test"' && sailfish config:get theme |
| ai.service.ts | sailfish ai:models / sailfish ai:chat "测试" |
| agent/ 目录 | sailfish agent:run "列出当前目录文件" --mode free |
| knowledge/ 目录 | sailfish knowledge:list && sailfish knowledge:search "测试" |
| history.service.ts | sailfish history:list && sailfish history:stats |
| host-profile.service.ts | sailfish host:list && sailfish host:get local |
| ssh.service.ts | sailfish ssh:list |
| pty.service.ts | sailfish pty:exec "echo ok" && sailfish pty:shells |
| scheduler.service.ts | sailfish scheduler:list && sailfish scheduler:history |
| mcp.service.ts | sailfish mcp:list |
| local-fs.service.ts | sailfish fs:list /tmp && sailfish fs:info |
| document-parser.service.ts | sailfish doc:parse README.md && sailfish doc:types |
| user-skill.service.ts | sailfish skill:list |
| watch/ 目录 | sailfish watch:list && sailfish watch:history && sailfish watch:templates && sailfish watch:state |
| sensor/ 目录 | sailfish sensor:status && sailfish sensor:heartbeat |
sailfish即已安装的 PATH 命令，或npm run sailfish --；直接用node electron/cli/main.js也行。npm run sft仍为别名。
electron/cli/index.ts 中添加对应的 CLI 命令test-cli.sh 中添加对应的测试用例（包括正常场景和错误场景）.cursor/rules/project-architecture.mdc 中的架构描述test-cli.sh