胖鱼 PEtFiSh — AI Worker's Companion

// problem

三个痛点

Skill数量少时无感。一旦团队有十几二十个Skill在用，同时爆发。

PAIN 01 · 碎片化

规则分散，无法同步

Cursor一份 .cursorrules，Claude一份 CLAUDE.md，改了一处，另外两处忘了同步。

PAIN 02 · 无治理

没有CI，不知道质量

触发准确率多少？有没有 shell=True 这种安全隐患？写了就扔，从不检查。

PAIN 03 · 无追踪

用了什么，效果如何

哪些Skill从来没被触发过？哪些在生产中实际有效？不知道，优化无从谈起。

// solution

三件核心的事

胖鱼把AI能力单元抽象为Skill。一个Skill有结构、有脚本、有元数据、有验证逻辑。

🌐

一套 Skill，8个平台

写一次 SKILL.md，自动翻译成 Cursor、Claude Code、Copilot、Windsurf 等平台的格式，安装到对应路径。支持 --platform 指定平台或 --detect 自动识别。

OpenCodeClaudeCursorCopilotWindsurfCodex +2

🔄

全生命周期管理

发现 → 创建 → 格式检查 → 安全审计 → 发布门禁 → 描述优化 → 触发评测 → 使用追踪。14个 /petfish 子命令覆盖全流程。

🛡️

质量门禁

Lint 100分制打分 → 安全审计 0.0–1.0 风险分 → Quality Gate 给出 PASS / CONDITIONAL / FAIL。跟代码 CI 一个思路。

// skill packs

10 个 Skill Pack

按需安装，项目级或全局级，安装时传入 --platform <平台名> 或 --detect 自动识别平台。

init

项目初始化向导，/initproject 一键启动

1 skill · global

companion

胖鱼本体，10个Skill生命周期管理工具 + 14个子命令

10 skills · global

course

课程开发全套：提纲、正文、实验、QA/QC

15 skills

deploy

部署与运维：CI/CD、Docker、回滚、健康检查

7 skills

testdocs

测试用例生成与使用文档自动化

2 skills

petfish

工程写作风格——让AI说人话，去掉AI味

1 skill

ppt

PPT设计与演示文稿制作辅助

2 skills

trust

Skill可信度治理：6维风险、5级动作、4条红线

1 skill

calibrate

反迎合决策校准——评审不顺着说，先中性化再给结论

1 skill

context

话题治理器：上下文隔离、污染评分、7种关系、28个MCP tools、会话管理

1 skill · 1 MCP

// install

安装

▸ 一句话安装（推荐）— 粘贴到任意AI编程助手

Install PEtFiSh by following: https://raw.githubusercontent.com/kylecui/SKILL_builder/master/docs/agent-install.md

AI助手会读取安装指令，自动检测你的平台和操作系统，对话式引导完成安装。适用于OpenCode、Claude Code、Cursor、Copilot、Windsurf等。

或者用传统命令行：

▸ macOS / Linux / WSL

# 安装 init + companion packs（推荐起点）
curl -fsSL https://raw.githubusercontent.com/kylecui/SKILL_builder/master/remote-install.sh \
  | bash -s -- --pack init,companion --detect

▸ Windows PowerShell

# 安装 init + companion packs（推荐起点）
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/kylecui/SKILL_builder/master/remote-install.ps1))) -Pack "init,companion" -Detect

安装脚本自动获取最新稳定release版本，无需手动指定版本号。
装完后，在你的AI工具里输入 /initproject — 胖鱼询问项目类型，自动安装匹配的Skill Pack，完成配置向导。

已安装？升级也是一条命令

重新运行安装命令并加上 --force 即可升级。安装器自动检测版本差异，提示可用更新。

▸ macOS / Linux / WSL

# 升级全部已安装的pack
curl -fsSL https://raw.githubusercontent.com/kylecui/SKILL_builder/master/remote-install.sh \
  | bash -s -- --pack all --force

▸ Windows PowerShell

# 升级全部已安装的pack
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/kylecui/SKILL_builder/master/remote-install.ps1))) -Pack all -Force

不加 --force 时，安装器只显示版本差异提示，不会覆盖已有文件。

// commands

/petfish 命令

安装 companion pack 后可用，14个子命令覆盖Skill全生命周期。

命令	说明
/petfish	查看已安装Skill状态
/petfish catalog	浏览全量技能目录
/petfish suggest	基于项目结构推荐Skill
/petfish search <kw>	跨市场搜索Skill和MCP Server
/petfish mine <repo>	分析仓库，挖掘可Skill化模块
/petfish create <name>	创建新Skill（交互式脚手架）
/petfish lint [path]	格式质量打分（100分制，40+条规则）
/petfish audit <path>	静态安全审计（0.0–1.0风险评分）
/petfish gate <path>	完整发布门禁：lint + audit → PASS/FAIL
/petfish optimize <path>	分析并优化Skill描述与触发词
/petfish eval <path>	用测试集跑 precision / recall
/petfish stats	查看使用频率与反馈统计
/petfish detect	检测当前AI平台
/petfish install <alias>	获取指定Pack的安装命令