[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-numman-ali--openskills":3,"tool-numman-ali--openskills":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":80,"owner_location":81,"owner_email":82,"owner_twitter":83,"owner_website":84,"owner_url":85,"languages":86,"stars":95,"forks":96,"last_commit_at":97,"license":98,"difficulty_score":99,"env_os":100,"env_gpu":101,"env_ram":101,"env_deps":102,"category_tags":107,"github_topics":84,"view_count":108,"oss_zip_url":84,"oss_zip_packed_at":84,"status":16,"created_at":109,"updated_at":110,"faqs":111,"releases":141},2361,"numman-ali\u002Fopenskills","openskills","Universal skills loader for AI coding agents - npm i -g openskills","OpenSkills 是一款专为 AI 编程助手打造的通用技能加载工具。它成功打破了 Anthropic 官方技能系统的生态壁垒，让 Claude Code、Cursor、Windsurf、Aider 等各类智能体都能直接使用原本专属于 Claude 的\"SKILL.md\"技能包。\n\n在 AI 辅助开发中，不同工具往往拥有各自独立的插件格式，导致优质技能资源无法互通。OpenSkills 通过统一的标准格式解决了这一痛点：它能将技能以与 Claude Code 完全兼容的 XML 结构注入到通用的 `AGENTS.md` 配置文件中。这意味着开发者无需为不同工具重复配置，即可在项目中版本化管理技能，并实现“按需加载”，既保持了上下文环境的整洁，又提升了任务执行效率。\n\n这款工具非常适合软件开发者、技术团队以及热衷于探索 AI 编程工作流的研究人员使用。其核心亮点在于完美的兼容性——直接复用 Anthropic 市场及 GitHub 上丰富的现有技能资源；同时支持从本地路径或私有仓库安装，兼顾了灵活性与安全性。只需简单的命令行操作，OpenSkills 就能让你的 AI 助手瞬间掌握处理","OpenSkills 是一款专为 AI 编程助手打造的通用技能加载工具。它成功打破了 Anthropic 官方技能系统的生态壁垒，让 Claude Code、Cursor、Windsurf、Aider 等各类智能体都能直接使用原本专属于 Claude 的\"SKILL.md\"技能包。\n\n在 AI 辅助开发中，不同工具往往拥有各自独立的插件格式，导致优质技能资源无法互通。OpenSkills 通过统一的标准格式解决了这一痛点：它能将技能以与 Claude Code 完全兼容的 XML 结构注入到通用的 `AGENTS.md` 配置文件中。这意味着开发者无需为不同工具重复配置，即可在项目中版本化管理技能，并实现“按需加载”，既保持了上下文环境的整洁，又提升了任务执行效率。\n\n这款工具非常适合软件开发者、技术团队以及热衷于探索 AI 编程工作流的研究人员使用。其核心亮点在于完美的兼容性——直接复用 Anthropic 市场及 GitHub 上丰富的现有技能资源；同时支持从本地路径或私有仓库安装，兼顾了灵活性与安全性。只需简单的命令行操作，OpenSkills 就能让你的 AI 助手瞬间掌握处理 PDF、操作数据库等专业能力，极大地扩展了智能体的应用边界。","\u003Cdiv align=\"center\">\n\n\u003Cimg src=\".\u002Fassets\u002Flogo.svg\" alt=\"OpenSkills\" width=\"420\" \u002F>\n\n\u003Cbr\u002F>\n\u003Cbr\u002F>\n\n**Universal skills loader for AI coding agents**\n\nOne CLI. Every agent. Same format as Claude Code.\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fopenskills.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fopenskills)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fopenskills.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fopenskills)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FApache-2.0)\n\n[Quick Start](#-quick-start) · [How It Works](#-how-it-works) · [Commands](#-commands) · [Create Skills](#-creating-your-own-skills) · [FAQ](#-faq)\n\n\u003C\u002Fdiv>\n\n---\n\n## ✨ What Is OpenSkills?\n\nOpenSkills brings **Anthropic's skills system** to every AI coding agent — Claude Code, Cursor, Windsurf, Aider, Codex, and anything that can read `AGENTS.md`.\n\n**Think of it as the universal installer for SKILL.md.**\n\n---\n\n## 🚀 Quick Start\n\n```bash\nnpx openskills install anthropics\u002Fskills\nnpx openskills sync\n```\n\nBy default, installs are project-local (`.\u002F.claude\u002Fskills`, or `.\u002F.agent\u002Fskills` with `--universal`). Use `--global` for `~\u002F.claude\u002Fskills`.\n\n---\n\n## ✅ Why OpenSkills\n\n- **Exact Claude Code compatibility** — same prompt format, same marketplace, same folder structure\n- **Universal** — works with Claude Code, Cursor, Windsurf, Aider, Codex, and more\n- **Progressive disclosure** — load skills only when needed (keeps context clean)\n- **Repo-friendly** — skills live in your project and can be versioned\n- **Private friendly** — install from local paths or private git repos\n\n---\n\n## 🧠 How It Works\n\n### Claude Code System Prompt (Skills)\n\nClaude Code ships skills as **SKILL.md files** and exposes them inside a `\u003Cavailable_skills>` block. When the user asks for a task, Claude dynamically loads the matching skill.\n\n```xml\n\u003Cavailable_skills>\n\u003Cskill>\n\u003Cname>pdf\u003C\u002Fname>\n\u003Cdescription>Comprehensive PDF manipulation toolkit for extracting text and tables...\u003C\u002Fdescription>\n\u003Clocation>plugin\u003C\u002Flocation>\n\u003C\u002Fskill>\n\u003C\u002Favailable_skills>\n```\n\n### OpenSkills: Same Format, Universal Loader\n\nOpenSkills generates the **exact same `\u003Cavailable_skills>` XML** in your `AGENTS.md` and loads skills via:\n\n```bash\nnpx openskills read \u003Cskill-name>\n```\n\nSo any agent that can read `AGENTS.md` can use Claude Code skills without needing Claude Code itself.\n\n### Side-by-Side\n\n| Aspect | Claude Code | OpenSkills |\n|--------|-------------|------------|\n| **Prompt Format** | `\u003Cavailable_skills>` XML | Same XML | \n| **Skill Storage** | `.claude\u002Fskills\u002F` | `.claude\u002Fskills\u002F` (default) | \n| **Invocation** | `Skill(\"name\")` tool | `npx openskills read \u003Cname>` | \n| **Marketplace** | Anthropic marketplace | GitHub (anthropics\u002Fskills) | \n| **Progressive Disclosure** | ✅ | ✅ |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Show the exact AGENTS.md format OpenSkills writes\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```xml\n\u003Cskills_system priority=\"1\">\n\n## Available Skills\n\n\u003C!-- SKILLS_TABLE_START -->\n\u003Cusage>\nWhen users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively.\n\nHow to use skills:\n- Invoke: `npx openskills read \u003Cskill-name>` (run in your shell)\n- The skill content will load with detailed instructions\n- Base directory provided in output for resolving bundled resources\n\nUsage notes:\n- Only use skills listed in \u003Cavailable_skills> below\n- Do not invoke a skill that is already loaded in your context\n\u003C\u002Fusage>\n\n\u003Cavailable_skills>\n\n\u003Cskill>\n\u003Cname>pdf\u003C\u002Fname>\n\u003Cdescription>Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging\u002Fsplitting documents, and handling forms...\u003C\u002Fdescription>\n\u003Clocation>project\u003C\u002Flocation>\n\u003C\u002Fskill>\n\n\u003C\u002Favailable_skills>\n\u003C!-- SKILLS_TABLE_END -->\n\n\u003C\u002Fskills_system>\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🔧 Install Skills\n\n### From Anthropic Marketplace\n\n```bash\nnpx openskills install anthropics\u002Fskills\n```\n\n### From Any GitHub Repo\n\n```bash\nnpx openskills install your-org\u002Fyour-skills\n```\n\n### From a Local Path\n\n```bash\nnpx openskills install .\u002Flocal-skills\u002Fmy-skill\n```\n\n### From Private Git Repos\n\n```bash\nnpx openskills install git@github.com:your-org\u002Fprivate-skills.git\n```\n\n---\n\n## 🌍 Universal Mode (Multi-Agent Setups)\n\nIf you use Claude Code **and** other agents with one `AGENTS.md`, install to `.agent\u002Fskills\u002F` to avoid conflicts with Claude's plugin marketplace:\n\n```bash\nnpx openskills install anthropics\u002Fskills --universal\n```\n\n**Priority order (highest wins):**\n1. `.\u002F.agent\u002Fskills\u002F`\n2. `~\u002F.agent\u002Fskills\u002F`\n3. `.\u002F.claude\u002Fskills\u002F`\n4. `~\u002F.claude\u002Fskills\u002F`\n\n---\n\n## 🧰 Commands\n\n```bash\nnpx openskills install \u003Csource> [options]  # Install from GitHub, local path, or private repo\nnpx openskills sync [-y] [-o \u003Cpath>]       # Update AGENTS.md (or custom output)\nnpx openskills list                        # Show installed skills\nnpx openskills read \u003Cname>                 # Load skill (for agents)\nnpx openskills update [name...]            # Update installed skills (default: all)\nnpx openskills manage                      # Remove skills (interactive)\nnpx openskills remove \u003Cname>               # Remove specific skill\n```\n\n### Flags\n\n- `--global` — Install globally to `~\u002F.claude\u002Fskills` (default: project install)\n- `--universal` — Install to `.agent\u002Fskills\u002F` instead of `.claude\u002Fskills\u002F`\n- `-y, --yes` — Skip prompts (useful for CI)\n- `-o, --output \u003Cpath>` — Output file for sync (default: `AGENTS.md`)\n\n---\n\n## 🧬 The SKILL.md Format\n\nOpenSkills uses Anthropic's exact format:\n\n```markdown\n---\nname: pdf\ndescription: Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging\u002Fsplitting documents, and handling forms.\n---\n\n# PDF Skill Instructions\n\nWhen the user asks you to work with PDFs, follow these steps:\n1. Install dependencies: `pip install pypdf2`\n2. Extract text using scripts\u002Fextract_text.py\n3. Use references\u002Fapi-docs.md for details\n```\n\nSkills are **loaded on demand**, keeping your agent's context clean and focused.\n\n---\n\n## 🧪 Creating Your Own Skills\n\n### Minimal Structure\n\n```\nmy-skill\u002F\n└── SKILL.md\n```\n\n### With Resources\n\n```\nmy-skill\u002F\n├── SKILL.md\n├── references\u002F\n├── scripts\u002F\n└── assets\u002F\n```\n\nInstall your own skill:\n\n```bash\nnpx openskills install .\u002Fmy-skill\n```\n\n### Local Development with Symlinks\n\n```bash\ngit clone git@github.com:your-org\u002Fmy-skills.git ~\u002Fdev\u002Fmy-skills\nmkdir -p .claude\u002Fskills\nln -s ~\u002Fdev\u002Fmy-skills\u002Fmy-skill .claude\u002Fskills\u002Fmy-skill\n```\n\n### Authoring Guide\n\n```bash\nnpx openskills install anthropics\u002Fskills\nnpx openskills read skill-creator\n```\n\n---\n\n## 🔄 Updating Skills\n\nIf you installed skills from a git repo, you can refresh them anytime:\n\n```bash\nnpx openskills update\n```\n\nTo update specific skills, pass a comma-separated list:\n\n```bash\nnpx openskills update git-workflow,check-branch-first\n```\n\nIf a skill was installed before updates were tracked, re-install it once to record its source.\n\n---\n\n## ✅ Tips\n\n- You can always run OpenSkills via `npx`; a global install is optional.\n- For multiple reads, prefer comma-separated names: `npx openskills read foo,bar`.\n\n---\n\n## ❓ FAQ\n\n### Why CLI instead of MCP?\n\n**MCP is for dynamic tools.** Skills are static instructions + resources.\n\n- Skills are just files → no server required\n- Works with every agent → no MCP support needed\n- Matches Anthropic's design → SKILL.md is the spec\n\nMCP and skills solve different problems. OpenSkills keeps skills lightweight and universal.\n\n---\n\n## 📋 Requirements\n\n- **Node.js** 20.6+\n- **Git** (for cloning repositories)\n\n---\n\n## 📜 License\n\nApache 2.0\n\n## Attribution\n\nImplements [Anthropic's Agent Skills](https:\u002F\u002Fwww.anthropic.com\u002Fengineering\u002Fequipping-agents-for-the-real-world-with-agent-skills) specification.\n\n**Not affiliated with Anthropic.** Claude, Claude Code, and Agent Skills are trademarks of Anthropic, PBC.\n","\u003Cdiv align=\"center\">\n\n\u003Cimg src=\".\u002Fassets\u002Flogo.svg\" alt=\"OpenSkills\" width=\"420\" \u002F>\n\n\u003Cbr\u002F>\n\u003Cbr\u002F>\n\n**面向 AI 编码代理的通用技能加载器**\n\n一个 CLI。所有代理。与 Claude Code 相同的格式。\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fopenskills.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fopenskills)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fopenskills.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fopenskills)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FApache-2.0)\n\n[快速入门](#-quick-start) · [工作原理](#-how-it-works) · [命令](#-commands) · [创建技能](#-creating-your-own-skills) · [常见问题](#-faq)\n\n\u003C\u002Fdiv>\n\n---\n\n## ✨ OpenSkills 是什么？\n\nOpenSkills 将 **Anthropic 的技能系统** 带给所有 AI 编码代理——Claude Code、Cursor、Windsurf、Aider、Codex，以及任何能够读取 `AGENTS.md` 的工具。\n\n**可以把它看作 SKILL.md 的通用安装程序。**\n\n---\n\n## 🚀 快速入门\n\n```bash\nnpx openskills install anthropics\u002Fskills\nnpx openskills sync\n```\n\n默认情况下，安装是项目本地的（`.\u002F.claude\u002Fskills`，或使用 `--universal` 时为 `.\u002F.agent\u002Fskills`）。若需全局安装至 `~\u002F.claude\u002Fskills`，请使用 `--global`。\n\n---\n\n## ✅ 为什么选择 OpenSkills？\n\n- **与 Claude Code 完全兼容**——相同的提示格式、相同的市场、相同的文件结构\n- **通用性**——适用于 Claude Code、Cursor、Windsurf、Aider、Codex 等多种工具\n- **渐进式披露**——仅在需要时加载技能，保持上下文简洁\n- **适合版本控制**——技能存储在项目中，可进行版本管理\n- **支持私有仓库**——可从本地路径或私有 Git 仓库安装技能\n\n---\n\n## 🧠 工作原理\n\n### Claude Code 系统提示（技能）\n\nClaude Code 以 **SKILL.md 文件** 的形式分发技能，并将其暴露在 `\u003Cavailable_skills>` 块中。当用户请求任务时，Claude 会动态加载匹配的技能。\n\n```xml\n\u003Cavailable_skills>\n\u003Cskill>\n\u003Cname>pdf\u003C\u002Fname>\n\u003Cdescription>全面的 PDF 操作工具包，用于提取文本和表格……\u003C\u002Fdescription>\n\u003Clocation>plugin\u003C\u002Flocation>\n\u003C\u002Fskill>\n\u003C\u002Favailable_skills>\n```\n\n### OpenSkills：相同格式，通用加载器\n\nOpenSkills 在你的 `AGENTS.md` 中生成 **完全相同的 `\u003Cavailable_skills>` XML**，并通过以下命令加载技能：\n\n```bash\nnpx openskills read \u003Cskill-name>\n```\n\n因此，任何能够读取 `AGENTS.md` 的代理都可以使用 Claude Code 的技能，而无需依赖 Claude Code 本身。\n\n### 对比表\n\n| 方面 | Claude Code | OpenSkills |\n|--------|-------------|------------|\n| **提示格式** | `\u003Cavailable_skills>` XML | 相同的 XML | \n| **技能存储** | `.claude\u002Fskills\u002F` | `.claude\u002Fskills\u002F`（默认） | \n| **调用方式** | `Skill(\"name\")` 工具 | `npx openskills read \u003Cname>` | \n| **市场** | Anthropic 市场 | GitHub（anthropics\u002Fskills） | \n| **渐进式披露** | ✅ | ✅ |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>展示 OpenSkills 写入的精确 AGENTS.md 格式\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```xml\n\u003Cskills_system priority=\"1\">\n\n## 可用技能\n\n\u003C!-- SKILLS_TABLE_START -->\n\u003Cusage>\n当用户请求执行任务时，请检查下方列出的可用技能是否能更高效地完成该任务。\n\n使用方法：\n- 调用：`npx openskills read \u003Cskill-name>`（在终端运行）\n- 技能内容将加载，并附带详细说明\n- 输出中会提供基础目录，用于解析打包资源\n\n使用注意事项：\n- 仅使用下方 \u003Cavailable_skills> 中列出的技能\n- 不要重复加载已在上下文中存在的技能\n\u003C\u002Fusage>\n\n\u003Cavailable_skills>\n\n\u003Cskill>\n\u003Cname>pdf\u003C\u002Fname>\n\u003Cdescription>全面的 PDF 操作工具包，用于提取文本和表格、创建新 PDF、合并\u002F拆分文档以及处理表单……\u003C\u002Fdescription>\n\u003Clocation>project\u003C\u002Flocation>\n\u003C\u002Fskill>\n\n\u003C\u002Favailable_skills>\n\u003C!-- SKILLS_TABLE_END -->\n\n\u003C\u002Fskills_system>\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🔧 安装技能\n\n### 来自 Anthropic 市场\n\n```bash\nnpx openskills install anthropics\u002Fskills\n```\n\n### 来自任意 GitHub 仓库\n\n```bash\nnpx openskills install your-org\u002Fyour-skills\n```\n\n### 来自本地路径\n\n```bash\nnpx openskills install .\u002Flocal-skills\u002Fmy-skill\n```\n\n### 来自私有 Git 仓库\n\n```bash\nnpx openskills install git@github.com:your-org\u002Fprivate-skills.git\n```\n\n---\n\n## 🌍 通用模式（多代理环境）\n\n如果你同时使用 Claude Code 和其他代理，并共用一个 `AGENTS.md`，则应将技能安装到 `.agent\u002Fskills\u002F` 目录下，以避免与 Claude 的插件市场发生冲突：\n\n```bash\nnpx openskills install anthropics\u002Fskills --universal\n```\n\n**优先级顺序（最高者胜出）：**\n1. `.\u002F.agent\u002Fskills\u002F`\n2. `~\u002F.agent\u002Fskills\u002F`\n3. `.\u002F.claude\u002Fskills\u002F`\n4. `~\u002F.claude\u002Fskills\u002F`\n\n---\n\n## 🧰 命令\n\n```bash\nnpx openskills install \u003Csource> [options]  # 从 GitHub、本地路径或私有仓库安装\nnpx openskills sync [-y] [-o \u003Cpath>]       # 更新 AGENTS.md（或自定义输出）\nnpx openskills list                        # 显示已安装的技能\nnpx openskills read \u003Cname>                 # 加载指定技能（供代理使用）\nnpx openskills update [name...]            # 更新已安装的技能（默认更新全部）\nnpx openskills manage                      # 交互式移除技能\nnpx openskills remove \u003Cname>               # 移除特定技能\n```\n\n### 标志位\n\n- `--global` — 全局安装至 `~\u002F.claude\u002Fskills`（默认为项目安装）\n- `--universal` — 安装至 `.agent\u002Fskills\u002F` 而不是 `.claude\u002Fskills\u002F`\n- `-y, --yes` — 跳过提示（适用于 CI）\n- `-o, --output \u003Cpath>` — 同步时的输出文件（默认为 `AGENTS.md`）\n\n---\n\n## 🧬 SKILL.md 格式\n\nOpenSkills 使用 Anthropic 的精确格式：\n\n```markdown\n---\nname: pdf\ndescription: 全面的 PDF 操作工具包，用于提取文本和表格、创建新 PDF、合并\u002F拆分文档以及处理表单。\n---\n\n# PDF 技能使用说明\n\n当用户请求处理 PDF 时，请按照以下步骤操作：\n1. 安装依赖：`pip install pypdf2`\n2. 使用 scripts\u002Fextract_text.py 提取文本\n3. 参考 references\u002Fapi-docs.md 获取详细信息\n```\n\n技能是 **按需加载** 的，从而保持代理的上下文简洁且专注。\n\n---\n\n## 🧪 创建你自己的技能\n\n### 最小化结构\n\n```\nmy-skill\u002F\n└── SKILL.md\n```\n\n### 包含资源\n\n```\nmy-skill\u002F\n├── SKILL.md\n├── references\u002F\n├── scripts\u002F\n└── assets\u002F\n```\n\n安装你自己的技能：\n\n```bash\nnpx openskills install .\u002Fmy-skill\n```\n\n### 使用符号链接进行本地开发\n\n```bash\ngit clone git@github.com:your-org\u002Fmy-skills.git ~\u002Fdev\u002Fmy-skills\nmkdir -p .claude\u002Fskills\nln -s ~\u002Fdev\u002Fmy-skills\u002Fmy-skill .claude\u002Fskills\u002Fmy-skill\n```\n\n### 作者指南\n\n```bash\nnpx openskills install anthropics\u002Fskills\nnpx openskills read skill-creator\n```\n\n---\n\n## 🔄 更新技能\n\n如果你是从 Git 仓库安装的技能，可以随时刷新：\n\n```bash\nnpx openskills update\n```\n\n若需更新特定技能，可传入逗号分隔的列表：\n\n```bash\nnpx openskills update git-workflow,check-branch-first\n```\n\n如果某项技能是在未跟踪更新之前安装的，需重新安装一次以记录其来源。\n\n---\n\n## ✅ 提示\n\n- 你始终可以通过 `npx` 运行 OpenSkills；全局安装是可选的。\n- 如果需要读取多个技能，建议使用逗号分隔的名称：`npx openskills read foo,bar`。\n\n---\n\n## ❓ 常见问题解答\n\n### 为什么选择 CLI 而不是 MCP？\n\n**MCP 适用于动态工具。** 技能则是静态的指令加资源。\n\n- 技能只是文件，无需服务器支持。\n- 可与任何智能体配合使用，无需 MCP 支持。\n- 符合 Anthropic 的设计——`SKILL.md` 就是规范。\n\nMCP 和技能解决的是不同问题。OpenSkills 让技能保持轻量级和通用性。\n\n---\n\n## 📋 系统要求\n\n- **Node.js** 20.6 或更高版本\n- **Git**（用于克隆仓库）\n\n---\n\n## 📜 许可证\n\nApache 2.0\n\n## 致谢\n\n实现了 [Anthropic 的 Agent Skills](https:\u002F\u002Fwww.anthropic.com\u002Fengineering\u002Fequipping-agents-for-the-real-world-with-agent-skills) 规范。\n\n**与 Anthropic 无关联。** Claude、Claude Code 和 Agent Skills 是 Anthropic, PBC 的商标。","# OpenSkills 快速上手指南\n\nOpenSkills 是一个通用的 AI 编码代理技能加载器。它将 Anthropic 的 Skills 系统（SKILL.md）带给所有支持读取 `AGENTS.md` 的 AI 工具（如 Claude Code、Cursor、Windsurf、Aider 等），实现“一次安装，处处可用”。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **Node.js**: 版本 20.6 或更高。\n*   **Git**: 已安装并配置好，用于克隆技能仓库。\n*   **终端**: 支持运行 npx 命令的命令行工具。\n\n> **提示**：国内用户若遇到 npm 包下载缓慢的问题，可临时配置淘宝镜像源：\n> `npm config set registry https:\u002F\u002Fregistry.npmmirror.com`\n\n## 安装步骤\n\nOpenSkills 无需全局安装，推荐直接使用 `npx` 运行，也可按需全局安装。\n\n### 方式一：直接使用 (推荐)\n\n无需预先安装，直接在项目目录运行命令即可自动拉取最新执行文件。\n\n### 方式二：全局安装 (可选)\n\n如果您希望将 `openskills` 作为全局命令使用：\n\n```bash\nnpm install -g openskills\n```\n\n## 基本使用\n\n以下是将官方技能库集成到您的项目并同步配置的最简流程。\n\n### 1. 安装技能库\n\n从 Anthropic 官方技能市场安装技能到当前项目（默认保存在 `.\u002F.claude\u002Fskills`）：\n\n```bash\nnpx openskills install anthropics\u002Fskills\n```\n\n> **多代理兼容模式**：如果您同时使用 Claude Code 和其他代理工具，建议使用 `--universal` 参数，将技能安装至 `.\u002F.agent\u002Fskills` 以避免冲突：\n> ```bash\n> npx openskills install anthropics\u002Fskills --universal\n> ```\n\n### 2. 同步配置\n\n运行 sync 命令，自动在项目根目录生成或更新 `AGENTS.md` 文件，注入技能定义信息：\n\n```bash\nnpx openskills sync\n```\n\n### 3. 验证与使用\n\n安装完成后，您的 AI 代理（如 Cursor 或 Windsurf）在读取 `AGENTS.md` 时即可识别可用技能。\n\n您可以在终端手动测试加载某个技能（例如 `pdf` 技能）：\n\n```bash\nnpx openskills read pdf\n```\n\n此时，AI 代理将根据 `AGENTS.md` 中的指引，在需要时动态调用该技能，保持上下文整洁高效。","某全栈开发团队正在同时使用 Cursor、Windsurf 和 Aider 等多种 AI 编程助手协作开发一个复杂的金融报表系统，需要频繁调用专业的 PDF 解析与数据提取能力。\n\n### 没有 openskills 时\n- **技能复用困难**：为 Claude Code 编写的优质 `SKILL.md` 无法直接用于 Cursor 或 Windsurf，团队被迫为不同工具重复编写相同的提示词逻辑。\n- **上下文污染严重**：为了能让 AI 记住操作规范，开发者不得不将长篇大论的 PDF 处理指令硬编码在每次对话的系统提示中，导致上下文窗口被无效占用。\n- **维护成本高昂**：当需要优化 PDF 提取算法时，必须手动同步更新所有项目目录下的多个配置文件，极易出现版本不一致导致的执行错误。\n- **私有技能共享缺失**：团队内部沉淀的定制化技能只能散落在个人电脑中，缺乏统一的标准格式和加载机制，难以在团队成员间高效流转。\n\n### 使用 openskills 后\n- **一次编写，处处运行**：通过 `npx openskills install` 直接从 GitHub 加载标准的 `SKILL.md`，Cursor、Windsurf 等所有支持 `AGENTS.md` 的工具瞬间获得与 Claude Code 完全一致的专业能力。\n- **按需动态加载**：利用“渐进式披露”机制，仅在用户涉及 PDF 任务时通过 `npx openskills read pdf` 注入相关指令，平时保持上下文清爽，显著节省 Token 消耗。\n- **集中化管理**：技能文件统一存储在 `.claude\u002Fskills` 目录并纳入版本控制，修改一处即可自动同步给所有使用该项目的团队成员和 AI 代理。\n- **生态无缝对接**：直接复用 Anthropic 官方市场或社区的高质量技能包，无需重新造轮子，让团队能立即站在巨人的肩膀上解决复杂问题。\n\nopenskills 打破了不同 AI 编程助手之间的技能壁垒，让标准化的专家能力像插件一样在任何开发环境中即插即用。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnumman-ali_openskills_3f40ac86.png","numman-ali","Numman Ali","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fnumman-ali_df3cf2a5.png","Applied AI, Enterprise Agentic Coding & Product Strategy | Creator of OpenSkills and more | CTO @ https:\u002F\u002Fwww.retailbook.com (UK FinTech)","RetailBook","UK (Remote)","numman.ali@gmail.com","nummanali",null,"https:\u002F\u002Fgithub.com\u002Fnumman-ali",[87,91],{"name":88,"color":89,"percentage":90},"TypeScript","#3178c6",96.9,{"name":92,"color":93,"percentage":94},"JavaScript","#f1e05a",3.1,9408,592,"2026-04-02T20:33:44","NOASSERTION",1,"Linux, macOS, Windows","未说明",{"notes":103,"python":101,"dependencies":104},"该工具是一个基于 Node.js 的命令行界面（CLI），用于管理 AI 编码代理的技能文件。它不依赖 GPU 或大量内存，主要依赖 Node.js 运行环境和 Git（用于从仓库克隆技能）。支持在所有主流操作系统上运行，只要安装了所需的 Node.js 和 Git 版本。",[105,106],"Node.js>=20.6","Git",[15,45],7,"2026-03-27T02:49:30.150509","2026-04-06T05:35:34.500479",[112,117,122,127,132,137],{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},10856,"在 Windows 上运行安装命令时，为什么总是报错 \"Security error: Installation path outside target directory\"？","这是由于旧版本（如 1.2.1 或 1.3.0）中路径验证逻辑使用了硬编码的正斜杠（\u002F），而 Windows 使用反斜杠（\\），导致安全检查失败。该问题已在 v1.3.1 版本中修复。解决方案是升级 openskills 到最新版本：\n\nnpm install -g openskills@latest\n\n升级后，路径检查将自动适配跨平台分隔符，技能即可正常安装到 .claude\u002Fskills 目录。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F28",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},10857,"安装了 v1.3.0 版本，但运行 `openskills -V` 显示的版本号却是 1.2.1，且无法安装技能，这是怎么回事？","这是一个已知的版本发布错误。v1.3.0 版本的 package.json 中版本号未正确更新，且包含了导致 Windows 安装失败的路径验证 Bug。维护者已在 v1.3.1 版本中同时修复了版本号显示问题和 Windows 路径兼容性问题。请执行以下命令升级到修复版：\n\nnpm cache clean --force\nnpm install -g openskills@1.3.1\n\n升级后，`openskills -V` 将正确显示版本，且技能安装功能恢复正常。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F20",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},10858,"如何使用 `--yes` 参数实现完全非交互式安装（包括自动覆盖已有技能）？","在 v1.3.0\u002Fv1.3.1 及更高版本中，`--yes` (或 `-y`) 标志的功能已增强。现在使用该参数不仅会自动确认安装列表，还会自动确认覆盖已存在的技能文件，无需人工干预。您可以直接运行：\n\nopenskills install \u003Crepository> --yes\n\n这将实现全流程自动化安装，适用于脚本或 CI\u002FCD 环境。如果使用的是旧版本，请务必先升级。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F6",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},10859,"尝试安装某个仓库的技能时，提示 \"No SKILL.md files found in repository\" 怎么办？","此错误表示 openskills 在目标仓库的根目录或预期子目录中未找到必需的 `SKILL.md` 描述文件。即使仓库中有其他文件，缺少此文件也会导致安装被阻止。解决方法如下：\n1. 检查仓库结构：确认 `SKILL.md` 文件是否存在于仓库根目录下。\n2. 检查分支：确保您安装的分支包含该文件（有时可能在 main 分支而非默认分支）。\n3. 联系作者：如果文件确实缺失，需联系仓库维护者添加标准的 `SKILL.md` 文件。\n注意：目前不支持通过参数跳过此检查，必须满足文件存在条件才能安装。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F51",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},10860,"Windows 用户遇到安装路径安全错误，除了升级版本外，是否有临时的替代方案？","在官方修复版本（v1.3.1）发布前，部分用户发现回退到特定版本或使用社区 Fork 版本可以解决问题。临时方案包括：\n1. 尝试重新安装旧版稳定版本（视具体情况可能有效）：\nnpm install -g openskills@1.2.1\n2. 使用社区修复版（包含中文交互和路径修复）：\nnpm uninstall -g openskills\nnpm install -g @junxin367\u002Fopenskills\n但最推荐的方案仍然是等待或直接升级到官方发布的 v1.3.1 及以上版本，以获得长期支持和安全性保障。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F43",{"id":138,"question_zh":139,"answer_zh":140,"source_url":136},10861,"全局安装 openskills 后，为什么在终端输入命令提示找不到命令？","这通常是因为 npm 的全局二进制文件目录未添加到系统的环境变量 PATH 中。在 Windows 上，默认路径通常是 `C:\\Users\\\u003C用户名>\\AppData\\Roaming\\npm`。解决步骤如下：\n1. 找到 npm 全局路径：在命令行运行 `npm config get prefix`。\n2. 将该路径下的 `node_modules\\.bin` 或直接将该前缀路径添加到系统环境变量 PATH 中。\n3. 重启终端或重新登录使配置生效。\n配置完成后，即可在任何目录下直接使用 `openskills` 命令。",[142,147,152,157,162,167,172,177,182],{"id":143,"version":144,"summary_zh":145,"released_at":146},53310,"v1.5.0","### 新增\n- **`openskills update`** - 从记录的源位置刷新已安装的技能（默认：全部）\n- **源元数据跟踪** - 安装时会记录来源信息，以确保更新可靠\n\n### 变更\n- **多技能读取** - `openskills read` 支持以逗号分隔的技能名称\n- **生成的使用说明** - 针对 Shell 使用场景，明确了 `read` 命令的调用方式\n- **README** - 添加了更新指南和用户使用提示\n\n### 修复\n- **更新用户体验** - 跳过无源元数据的技能，并将其列出以便重新安装","2026-01-17T19:04:07",{"id":148,"version":149,"summary_zh":150,"released_at":151},53311,"v1.4.0","## 变更\n- README：澄清项目本地的默认安装方式，并移除冗余的同步提示\n- 安装程序消息：明确区分项目本地默认安装与 --global 全局安装\n\n完整变更日志：https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fcompare\u002Fv1.3.2...v1.4.0","2026-01-17T18:08:41",{"id":153,"version":154,"summary_zh":155,"released_at":156},53312,"v1.3.2","## 已更改\n- 文档和生成的 AGENTS.md 使用说明现在一致地使用反斜杠 `\\`。","2026-01-17T17:30:58",{"id":158,"version":159,"summary_zh":160,"released_at":161},53313,"v1.3.1","## 修复\n- Windows 安装：路径验证现在可在 Windows 上正常工作（不再出现“安全错误：安装路径位于目标目录之外”）\n- CLI 版本：`openskills --version` 现在从 `package.json` 中读取版本信息\n- 根目录 `SKILL.md`：在仓库根目录下包含 `SKILL.md` 的单技能仓库现在可以正确安装\n","2026-01-17T14:47:40",{"id":163,"version":164,"summary_zh":165,"released_at":166},53314,"v1.3.0","## v1.3.0 新增内容\n\n本次发布重点在于使 OpenSkills 更加适用于 **CI\u002FCD 流水线**、**本地技能开发**，并提升 **安全性**。\n\n### 亮点\n\n- **任意位置安装**：支持本地路径、私有 Git 仓库或任何 GitHub 仓库\n- **同步到任意文件**：新增 `--output` 标志，可自定义输出路径\n- **完全非交互式**：`--yes` 标志现可跳过所有提示，适合 CI\u002FCD 使用\n- **符号链接支持**：可在本地使用符号链接开发技能\n- **安全加固**：防止路径遍历攻击，并安全处理符号链接\n\n---\n\n## 新特性\n\n### 🔗 符号链接支持 ([#3](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F3))\n\n现在可以将技能以符号链接的形式放入技能目录中。这使得：\n- 基于 Git 的技能更新成为可能（克隆仓库后创建符号链接）\n- 支持本地开发工作流\n- 可在多个项目间共享技能\n\n```bash\nln -s ~\u002Fdev\u002Fmy-skills\u002Fcustom-skill .claude\u002Fskills\u002Fcustom-skill\nopenskills list  # 显示 custom-skill\n```\n\n### 📁 可配置的输出路径 ([#5](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F5))\n\n`sync` 命令新增 `--output` \u002F `-o` 标志：\n\n```bash\nopenskills sync --output .ruler\u002FAGENTS.md\nopenskills sync -o custom-rules.md\n```\n\n- 如果文件不存在，则会自动创建并添加标题\n- 如需，也会自动创建嵌套目录\n- 适用于任何 `.md` 文件\n\n### 📂 本地路径安装 ([#10](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F10))\n\n现在可以直接从本地文件系统安装技能：\n\n```bash\nopenskills install \u002Fpath\u002Fto\u002Fskill\nopenskills install .\u002Flocal-skills\u002Fmy-skill\nopenskills install ~\u002Fmy-skills\u002Fcustom-skill\n```\n\n### 🔐 私有 Git 仓库支持 ([#10](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F10))\n\n可通过 SSH 从私有仓库安装：\n\n```bash\nopenskills install git@github.com:your-org\u002Fprivate-skills.git\nopenskills install https:\u002F\u002Fgitlab.com\u002Fgroup\u002Fskills.git\n```\n\n### 🤖 完全非交互模式 ([#6](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fissues\u002F6))\n\n`--yes` 标志现可跳过 **所有** 提示，包括覆盖操作：\n\n```bash\nopenskills install anthropics\u002Fskills -y  # 覆盖现有技能而不提示\nopenskills sync -y                        # 非交互式同步\n```\n\n非常适合 CI\u002FCD 流水线和自动化脚本。\n\n---\n\n## 安全性改进\n\n- **路径遍历防护**：验证安装路径始终位于目标目录内\n- **符号链接解析**：`cpSync` 使用 `dereference: true` 安全复制符号链接指向的目标\n- **非贪婪 YAML 正则表达式**：防止在解析 frontmatter 时出现潜在的 ReDoS 攻击\n\n---\n\n## 测试覆盖率\n\n新增 **77 个测试用例**，覆盖 5 个测试文件，总测试数达到 88 个：\n\n| 测试文件 | 测试用例 | 覆盖率 |\n|----------|----------|--------|\n| `tests\u002Futils\u002Fskills.test.ts` | 13 | 符号链接检测、去重 |\n| `tests\u002Fcommands\u002Finstall.test.ts` | 27 | 本地路径、Git URL、安全性 |\n| `tests\u002Fcommands\u002Fsync.test.ts` | 17 | XML 生成、`--output` 标志 |\n| `tests\u002Fintegration\u002Fe2e.test.ts` | 16 | 完整 CLI 工作流 |\n| `tests\u002Futils\u002Fyaml.test.ts` | 10 | YAML 解析","2025-12-14T10:37:55",{"id":168,"version":169,"summary_zh":170,"released_at":171},53315,"v1.2.1","## 文档修复\n\n修复了 README 中的不一致之处，并去除了重复内容：\n\n- ✅ 移除了重复的“高级用户指南”部分\n- ✅ 修正了 `--project` 标志的错误用法（现在项目参数已设为默认值）\n- ✅ 整合了所有通用模式的相关文档\n- ✅ 更新了所有示例中的命令，确保其正确性\n\n**未进行代码更改**，仅进行了文档清理。\n\n安装：\n```bash\nnpm i -g openskills@1.2.1\n```","2025-10-27T20:12:30",{"id":173,"version":174,"summary_zh":175,"released_at":176},53316,"v1.2.0","## 主要特性\n\n### 🚀 通用技能支持 (--universal 标志)\n\n将技能安装到 `.agent\u002Fskills\u002F` 目录，以便通过 AGENTS.md 文件与 **任何编码助手**（Claude Code、Cursor、Windsurf、Aider）一起使用：\n\n```bash\n# 安装到 .agent\u002Fskills（通用）\nopenskills install anthropics\u002Fskills --universal\n\n# 全局安装到 .agent\u002Fskills\nopenskills install anthropics\u002Fskills --global --universal\n```\n\n**使用场景：** 高级用户可以使用一个 AGENTS.md 文件管理多个编码助手。避免与 Claude Code 的原生插件系统产生重复。\n\n### 🎯 现默认为项目级安装\n\n现在项目级安装成为默认行为（之前是全局安装）：\n\n```bash\n# 默认：安装到 .claude\u002Fskills（项目）\nopenskills install anthropics\u002Fskills\n\n# 高级用法：全局安装\nopenskills install anthropics\u002Fskills --global\n```\n\n**重大变更：** 移除了 `--project` 标志，新增了 `--global` 标志。\n\n### 📁 支持 4 种安装位置\n\n优先级顺序（list\u002Fread\u002Fsync 命令会检查所有位置）：\n\n1. `.agent\u002Fskills\u002F`（项目通用）\n2. `~\u002F.agent\u002Fskills\u002F`（全局通用）\n3. `.claude\u002Fskills\u002F`（项目）\n4. `~\u002F.claude\u002Fskills\u002F`（全局）\n\n### 🔍 智能去重\n\n同名技能在 `list` 命令中仅显示一次（优先级最高者胜出）。当技能同时存在于 `.agent\u002F` 和 `.claude\u002F` 目录时，可防止重复。\n\n## 变更内容\n\n**新增：**\n- `--universal` 标志，用于安装到 `.agent\u002Fskills\u002F`\n- `--global` 标志（取代 `--project`）\n- 支持 4 种安装位置\n- 在 list\u002Fread\u002Fsync 命令中实现去重\n- 新增 2 个测试用例（总计 11 个通过）\n\n**变更：**\n- 默认安装位置：从全局改为项目\n- 优先级顺序：`.agent\u002F` 优先于 `.claude\u002F`\n\n**移除：**\n- `--project` 标志（项目现为默认）\n\n## 迁移指南\n\n```bash\n# v1.2.0 之前\nopenskills install X              # 全局安装\nopenskills install X --project    # 项目安装\n\n# v1.2.0 及之后\nopenskills install X              # 项目安装（新默认）\nopenskills install X --global     # 全局安装\nopenskills install X --universal  # 通用（.agent\u002Fskills）\n```\n\n## 使用场景\n\n**仅使用 Claude Code：**\n```bash\nopenskills install anthropics\u002Fskills\n# → .claude\u002Fskills（默认）\n```\n\n**Claude Code 结合其他助手（Cursor、Windsurf）：**\n```bash\nopenskills install anthropics\u002Fskills --universal\n# → .agent\u002Fskills（通用 AGENTS.md）\n```\n\n**在所有项目间共享技能：**\n```bash\nopenskills install anthropics\u002Fskills --global\n# → ~\u002F.claude\u002Fskills\n```\n\n## 安装方法\n\n```bash\nnpm i -g openskills@1.2.0\n```\n\n## 完整更新日志\n\nhttps:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fcompare\u002Fv1.1.0...v1.2.0","2025-10-27T20:09:16",{"id":178,"version":179,"summary_zh":180,"released_at":181},53317,"v1.1.0","## 主要改进\n\n### 🔧 修复缺失的 `\u003Clocation>` 标签\n- **关键修复**：`openskills sync` 现在会输出符合 Claude Code 格式的 `\u003Clocation>` 标签\n- 技能将显示 `\u003Clocation>project\u003C\u002Flocation>` 或 `\u003Clocation>global\u003C\u002Flocation>`\n- 确保与 Claude Code 的 `\u003Cavailable_skills>` XML 结构 100% 兼容\n\n### 📚 全面的单页 README\n- **移除了 `docs` 文件夹** - 所有内容现在都整合到一个 README 中\n- 清晰的结构：是什么 → 怎么做 → 为什么\n- 新增了“工作原理”章节，对比了 Claude Code 和 OpenSkills\n- 新增了“为什么选择 CLI 而不是 MCP？”部分，解释了设计思路\n- 提供并排对比表格，展示两者的实现完全一致\n- 包含 Claude Code 和 OpenSkills 提示词的完整示例\n\n### 📖 文档增强\n- 完整的 Claude Code 系统提示示例\n- 完整的 OpenSkills `AGENTS.md` 示例\n- 详细的渐进式披露说明\n- 交互式的 TUI 命令示例\n- 完整的技能编写指南，并附带配套资源\n\n## 变更内容\n\n**修复：**\n- 生成的 XML 中缺少 `\u003Clocation>` 标签（现已完全匹配 Claude Code）\n\n**改进：**\n- 单一的综合性 README（不再有单独的文档）\n- 对技能系统和渐进式披露机制的清晰解释\n- 更好的组织结构和阅读流畅度\n\n**移除：**\n- 独立的 `docs` 文件夹（已整合到 README 中）\n\n## 安装\n\n```bash\nnpm i -g openskills@1.1.0\n```\n\n## 完整变更日志\n\nhttps:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fcompare\u002Fv1.0.0...v1.1.0","2025-10-27T14:09:30",{"id":183,"version":184,"summary_zh":185,"released_at":186},53318,"v1.0.0","# OpenSkills v1.0.0 - 初始发布\n\n适用于 AI 编码代理的通用技能加载器。可在任何代理（Claude Code、Cursor、Windsurf、Aider）中安装并使用 Anthropic SKILL.md 格式的技能。\n\n## 安装\n\n```bash\nnpm i -g openskills\n```\n\n## 快速入门\n\n```bash\n# 安装技能（交互式选择）\nopenskills install anthropics\u002Fskills --project\n\n# 同步到 AGENTS.md（交互式，预选当前状态）\nopenskills sync\n\n# 列出已安装的技能\nopenskills list\n```\n\n## 特性\n\n✅ **默认交互式**\n- 安装和同步时支持复选框选择\n- 智能默认设置（预选当前 AGENTS.md 状态）\n- 带颜色和加载动画的美观 TUI 界面\n\n✅ **与 Claude Code 兼容**\n- 使用 `.claude\u002Fskills\u002F` 标准位置\n- 警告市场技能冲突\n- 可与原生 Claude Code 插件共存\n\n✅ **通用性**\n- 适用于任何支持 Bash 的 AI 代理\n- Claude Code、Cursor、Windsurf、Aider\n- 无厂商锁定\n\n✅ **专业品质**\n- TypeScript 强制模式开发\n- 使用 vitest 进行 9 项单元测试\n- 在 Node 18\u002F20\u002F22 上运行 CI\u002FCD\n- 提供全面文档\n\n## 命令\n\n```bash\nopenskills install \u003Csource> [--project] [-y]  # 从 GitHub 安装\nopenskills sync [-y]                          # 更新 AGENTS.md\nopenskills list                               # 显示已安装的技能\nopenskills read \u003Cname>                        # 读取技能（用于代理）\nopenskills manage                             # 交互式移除技能\nopenskills remove \u003Cname>                      # 移除单个技能\n```\n\n## 包含内容\n\n- **install**: 带技能大小的交互式复选框选择\n- **sync**: 基于当前 AGENTS.md 的智能预选\n- **manage**: 交互式多选移除\n- **面向代理的 AGENTS.md**: 专为 AI 代理编写的使用说明\n- **冲突警告**: 检测 Anthropic 市场中的技能\n- **优雅的 Ctrl+C 处理**: 清洁退出，无堆栈跟踪\n\n## 示例\n\n**安装技能：**\n```bash\nopenskills install anthropics\u002Fskills --project\n```\n\n显示：\n```\n? 选择要安装的技能\n  [x] xlsx                    45.2KB\n  [x] pdf                     120.5KB\n  [ ] algorithmic-art         85.3KB\n```\n\n**同步到 AGENTS.md：**\n```bash\nopenskills sync\n```\n\n会预选 AGENTS.md 中已有的技能。勾选更多以添加，取消勾选则移除。\n\n## 文档\n\n- [入门指南](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fblob\u002Fmain\u002Fdocs\u002Fgetting-started.md)\n- [创建技能](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fblob\u002Fmain\u002Fdocs\u002Fcreating-skills.md)\n- [集成指南](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fopenskills\u002Fblob\u002Fmain\u002Fdocs\u002Fintegration.md)\n\n## 归属声明\n\n实现 [Anthropic 的 Agent Skills](https:\u002F\u002Fwww.anthropic.com\u002Fengineering\u002Fequipping-agents-for-the-real-world-with-agent-skills) 规范。\n\n**与 Anthropic 无关联。** Claude、Claude Code 和 Agent Skills 是 Anthropic, PBC 的商标。\n\n---\n\n**安装：** `npm i -g openskills`\n\n**关注：** [@nummanthinks](https:\u002F\u002Fx.com\u002Fnummanthinks) 获取最新动态","2025-10-26T21:29:53"]