메뉴
后端代码修改后，通过 CLI 测试验证功能正确性。使用场景：修改了 electron/services/ 下的代码需要测试、准备提交代码前跑回归、用户要求"跑测试"/"验证一下"。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
生成或审计模块的 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 常用命令
| 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