ydeng11/rulesify

# Rulesify Rulesify 是一款**专为 AI agent 设计的技能管理工具**。发现、浏览并从精选的 GitHub 仓库安装预构建的技能，从而增强你的 AI 助手的能力。  ## 什么是技能？ 技能是预构建的工作流、方法论和指令，用于增强 AI agent 的能力。每个技能都是一个独立的模块，能够引导 AI 助手完成复杂的任务，例如： - **测试驱动开发** - 在实现之前编写测试 - **系统性调试** - 使用科学方法排查 bug - **部署工作流** - 部署到 Netlify、Render、Cloudflare - **文档创建** - 生成 PDF、Word 文档和演示文稿 - **安全审查** - 威胁建模、安全最佳实践 - **设计工作流** - Figma 集成、UI 生成 ## 功能 - **技能注册表**：从可信来源浏览并安装 50+ 技能 - **LLM 分类**：自动分配领域和标签，便于发现 - **领域过滤**：按类别查找技能（开发、测试、设计等） - **标签搜索**：通过能力标签发现技能 - **直接安装**：自动下载并安装技能（完整文件夹复制） - **多工具支持**：同时安装到多个 AI 工具（Claude Code、Codex、Cursor 等） - **精选来源**：来自 Anthropic、OpenAI 和社区专家的技能 - **自动协调**：当技能被手动删除时，配置会自动与磁盘状态同步 ## 技能注册表 ### 技能来源 技能精选自以下可信的 GitHub 仓库： - **anthropics/skills** - Anthropic 官方技能合集 - **openai/skills** - OpenAI 精选与系统技能 - **mattpocock/skills** - Matt Pocock 的开发技能 - **MiniMax-AI/skills** - MiniMax 技能合集 ### 基于 LLM 的分类 技能被自动划分为 10 个领域： | 领域 | 描述 | 示例技能 | |--------|-------------|----------------| | `planning-and-orchestration` | 项目规划、任务编排 | `notion-spec-to-implementation` | | `development` | 代码开发、SDK、应用构建 | `skill-creator`, `mcp-builder` | | `design` | UI 设计、视觉艺术、创意工作 | `figma-*`, `canvas-design` | | `documentation` | 文档创建、格式化 | `docx`, `pptx`, `pdf` | | `data` | 数据分析、研究 | `jupyter-notebook` | | `testing` | 测试、调试、错误处理 | `playwright`, `sentry` | | `deployment` | 云部署、托管 | `netlify-deploy`, `render-deploy` | | `integrations` | API 集成、MCP server | `mcp-builder`, `linear` | | `collaboration` | 团队沟通、会议 | `internal-comms`, `notion-meeting-intelligence` | | `security` | 安全审查、威胁建模 | `security-threat-model` | 每个技能最多包含 3 个用于描述特定能力的标签。 ### 注册表格式 ``` [skills.tdd] name = "test-driven-development" description = "Write tests before implementation code using TDD methodology" source_url = "https://github.com/mattpocock/skills/tree/main/tdd" stars = 1500 context_size = 2400 domain = "development" last_updated = "2026-04-15" tags = ["testing", "tdd", "best-practices"] ``` ## 安装 ### Homebrew (macOS) ``` brew tap ydeng11/rulesify brew install rulesify ``` 或者直接安装： ``` brew install ydeng11/rulesify/rulesify ``` ### 一行命令 (Linux/macOS) ``` curl -sSL https://github.com/ydeng11/rulesify/releases/latest/download/install.sh | bash ``` 安装完成后，重启你的 shell 或运行： ``` export PATH="$HOME/.local/bin:$PATH" ``` ### 手动安装 1. 从 [GitHub Releases](https://github.com/ydeng11/rulesify/releases) 下载最新的二进制文件 2. 安装到 `~/.local/bin`： mkdir -p ~/.local/bin mv rulesify-- ~/.local/bin/rulesify chmod +x ~/.local/bin/rulesify ## 快速开始 ``` # 列出所有可用 skills rulesify skill list # 按 domain 过滤 rulesify skill list --domain development # 按 tags 搜索 rulesify skill list --tags testing,debugging # 查看 skill 详情 rulesify skill show playwright # 安装 skill rulesify skill add test-driven-development ``` ## 命令参考 ### 技能命令 | 命令 | 描述 | |---------|-------------| | `rulesify init` | 交互式设置 - 选择工具和技能 | | `rulesify skill list` | 列出已安装的技能 | | `rulesify skill add ` | 下载并安装技能（项目级别） | | `rulesify skill add --global` | 全局安装技能 | | `rulesify skill remove ` | 移除技能（提示确认） | | `rulesify skill update` | 将已安装的技能更新至最新版本 | ### 全局选项 - `--config ` - 使用自定义配置文件 - `--verbose` - 启用详细输出以进行调试 ## 使用示例 ### 发现技能 ``` # 浏览所有 skills rulesify skill list # 查找 deployment skills rulesify skill list --domain deployment # 查找 debugging skills rulesify skill list --tags debugging # 查找 testing 相关 skills rulesify skill list --tags testing ``` ### 安装技能 ``` # 使用交互式选择初始化项目 rulesify init # 安装 skill（从 GitHub 下载，创建文件夹） rulesify skill add test-driven-development # 全局安装（在所有项目中可用） rulesify skill add test-driven-development --global # 移除 skill（提示确认） rulesify skill remove test-driven-development # 更新已安装的 skills rulesify skill update ``` ### 按领域过滤 ``` # Development skills rulesify skill list --domain development # Design skills rulesify skill list --domain design # Security skills rulesify skill list --domain security ``` ## 更新注册表 注册表通过 GitHub Actions 每周更新。如需手动刷新： ``` # 需要 GitHub 和 OpenRouter tokens GH_TOKEN=xxx OPENROUTER_API_KEY=xxx cargo run --bin update-registry # 强制重新分类 cargo run --bin update-registry -- --force # Verbose mode cargo run --bin update-registry -- --force -v # 自定义 model（默认：claude-3.5-haiku） OPENROUTER_MODEL=openai/gpt-4o-mini cargo run --bin update-registry -- --force ``` ## 开发说明 ### 项目结构 ``` rulesify/ ├── Cargo.toml ├── registry.toml # Skills registry (LLM-classified) ├── src/ │ ├── main.rs │ ├── lib.rs │ ├── bin/ │ │ └── update-registry.rs # Registry automation │ ├── cli/ │ │ └── skill.rs # Skill commands │ ├── models/ │ │ ├── domain.rs # 10 domains enum │ │ ├── skill.rs # Skill model │ │ └── registry.rs # Registry model │ ├── llm/ │ │ ├── client.rs # OpenRouter client │ │ ├── classifier.rs # Batch classification │ │ └── prompt.rs # Prompts │ ├── registry/ │ │ ├── source.rs # GitHub sources │ │ ├── github.rs # GitHub API │ │ ├── parser.rs # SKILL.md parser │ │ ├── scorer.rs # Quality scoring │ │ └── generator.rs # TOML generator │ └── tui/ │ └── skill_selector.rs # Interactive selection ├── .github/ │ └── workflows/ │ └── update-registry.yml # Weekly updates └── docs/ └ plans/ ``` ### 测试 ``` cargo test # Run all 116 tests cargo check # Verify compilation cargo clippy # Lint ``` ### 测试覆盖率 - **所有模块共计 116 个测试** - **12 个协调测试**（技能验证、配置清理） - **7 个执行器测试**（URL 解析、安装/卸载） - **10 个领域测试**（enum 解析、验证） - **24 个注册表测试**（技能目录、GitHub API） - **4 个 TUI 测试**（交互式选择） ## 许可证 [MIT 许可证](./LICENSE) 版权所有 (c) 2024 Rulesify 贡献者

标签：AI智能体, LLM工具, Python安全, SOC Prime, 可视化界面, 工作流, 开发工具, 技能管理, 通知系统