[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-softaworks--agent-toolkit":3,"tool-softaworks--agent-toolkit":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},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,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},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 真正成长为懂上",160411,2,"2026-04-18T23:33:24",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":78,"owner_email":78,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":81,"stars":102,"forks":103,"last_commit_at":104,"license":105,"difficulty_score":42,"env_os":106,"env_gpu":107,"env_ram":106,"env_deps":108,"category_tags":113,"github_topics":114,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":122,"updated_at":123,"faqs":124,"releases":154},9350,"softaworks\u002Fagent-toolkit","agent-toolkit","A curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.","agent-toolkit 是一套专为 AI 编程助手（如 Claude Code、Cursor 等）精心策划的技能扩展包。它将复杂的开发指令和脚本封装成标准化的“技能”模块，显著增强了 AI 在代码开发、文档撰写、项目规划及专业工作流中的执行能力。\n\n在日常工作中，开发者常面临 AI 助手对特定任务理解不够深入或操作流程繁琐的问题。agent-toolkit 通过提供预定义的高质量技能，解决了这一痛点，让 AI 能够更精准地执行代码重构、架构绘图、API 文档交接甚至跨模型分析等复杂任务，从而大幅提升人机协作效率。\n\n这套工具特别适合软件开发者、技术团队负责人以及希望深度定制 AI 工作流的高级用户。无论是需要快速生成 C4 架构图、编写规范的 README，还是利用不同大模型（如 GPT-5.2、Gemini）进行专项代码分析，都能从中获益。\n\n其独特亮点在于采用了开放的 Agent Skills 标准格式，支持模块化安装与热更新。用户不仅可以一键安装现成的技能、智能体或斜杠命令，还能利用内置的\"plugin-forge\"等元技能轻松构建和分享自己的专属插件，真正实现了 AI 能力","agent-toolkit 是一套专为 AI 编程助手（如 Claude Code、Cursor 等）精心策划的技能扩展包。它将复杂的开发指令和脚本封装成标准化的“技能”模块，显著增强了 AI 在代码开发、文档撰写、项目规划及专业工作流中的执行能力。\n\n在日常工作中，开发者常面临 AI 助手对特定任务理解不够深入或操作流程繁琐的问题。agent-toolkit 通过提供预定义的高质量技能，解决了这一痛点，让 AI 能够更精准地执行代码重构、架构绘图、API 文档交接甚至跨模型分析等复杂任务，从而大幅提升人机协作效率。\n\n这套工具特别适合软件开发者、技术团队负责人以及希望深度定制 AI 工作流的高级用户。无论是需要快速生成 C4 架构图、编写规范的 README，还是利用不同大模型（如 GPT-5.2、Gemini）进行专项代码分析，都能从中获益。\n\n其独特亮点在于采用了开放的 Agent Skills 标准格式，支持模块化安装与热更新。用户不仅可以一键安装现成的技能、智能体或斜杠命令，还能利用内置的\"plugin-forge\"等元技能轻松构建和分享自己的专属插件，真正实现了 AI 能力的按需扩展与社区共创。","# Softaworks Agent Skills\n\nOpinionated skills shared by [@leonardocouy](https:\u002F\u002Fgithub.com\u002Fleonardocouy) for improving daily work efficiency with Claude Code. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.\n\nSkills follow the [Agent Skills](https:\u002F\u002Fagentskills.io\u002F) format.\n\n---\n\n## 🧭 Quick Navigation\n\n**[🚀 Installation](#-installation)** • **[📚 Available Skills](#-available-skills)** • **[🤖 Agents & Commands](#-agents--commands)** • **[📖 Skill Structure](#-skill-structure)** • **[🤝 Contributing](#-contributing)** • **[📄 License](#-license)** • **[🔗 Links](#-links)**\n\n---\n\n## 🚀 Installation\n\n### Quick Install (Recommended)\n\n```bash\nnpx skills add softaworks\u002Fagent-toolkit\n```\n\nThis method works with multiple AI coding agents (Claude Code, Codex, Cursor, AdaL, etc.)\n\n### Register as Plugin Marketplace\n\nRun the following commands in Claude Code:\n\n```bash\n\u002Fplugin marketplace add softaworks\u002Fagent-toolkit\n\u002Fplugin\n```\n\n### Install Plugins\n\n**Option 1: Via Browse UI**\n\n1. Switch to **Marketplaces** tab (use arrow keys or Tab)\n2. Select **agent-toolkit**, press Enter\n3. Browse and select the plugin(s) you want to install\n4. Select **Install now**\n\n**Option 2: Direct Install**\n\n```bash\n# Install specific skill\n\u002Fplugin install codex@agent-toolkit\n\u002Fplugin install humanizer@agent-toolkit\n\n# Install specific agent\n\u002Fplugin install agent-codebase-pattern-finder@agent-toolkit\n\n# Install specific command\n\u002Fplugin install command-codex-plan@agent-toolkit\n```\n\n**Option 3: Ask the Agent**\n\nSimply tell Claude Code:\n\n> Please install Skills from github.com\u002Fsoftaworks\u002Fagent-toolkit\n\n### Available Plugins\n\nEach skill, agent, and command is an individual plugin that can be installed separately:\n\n- **Skills** → See [Available Skills](#-available-skills) for the full list\n- **Agents** → See [Agents](#agents) (install as `agent-\u003Cname>@agent-toolkit`)\n- **Commands** → See [Slash Commands](#slash-commands) (install as `command-\u003Cname>@agent-toolkit`)\n\n### Update Plugins\n\nTo update plugins to the latest version:\n\n1. Run `\u002Fplugin` in Claude Code\n2. Switch to **Marketplaces** tab\n3. Select **agent-toolkit**\n4. Choose **Update marketplace**\n\nYou can also **Enable auto-update** to get the latest versions automatically.\n\n### Manual Installation\n\n**For Claude Code (Manual)** — Skills only\n```bash\ncp -r skills\u002F\u003Cskill-name> ~\u002F.claude\u002Fskills\u002F\n```\n\n**For claude.ai** — Skills only\n\nAdd skills to project knowledge or paste SKILL.md contents into the conversation.\n\n---\n\n## 📚 Available Skills\n\n| Category | Skill | Description |\n|----------|-------|-------------|\n| 🤖 AI Tools | [codex](skills\u002Fcodex\u002FREADME.md) | Advanced code analysis with GPT-5.2 |\n| 🤖 AI Tools | [gemini](skills\u002Fgemini\u002FREADME.md) | Large-scale review (200k+ context) |\n| 🤖 AI Tools | [perplexity](skills\u002Fperplexity\u002FREADME.md) | Web search & research |\n| 🔮 Meta | [agent-md-refactor](skills\u002Fagent-md-refactor\u002FREADME.md) | Refactor bloated agent instruction files |\n| 🔮 Meta | [command-creator](skills\u002Fcommand-creator\u002FREADME.md) | Create Claude Code slash commands |\n| 🔮 Meta | [plugin-forge](skills\u002Fplugin-forge\u002FREADME.md) | Build Claude Code plugins & manifests |\n| 🔮 Meta | [skill-judge](skills\u002Fskill-judge\u002FREADME.md) | Evaluate skill design quality |\n| 📝 Documentation | [backend-to-frontend-handoff-docs](skills\u002Fbackend-to-frontend-handoff-docs\u002FREADME.md) | API handoff docs for frontend |\n| 📝 Documentation | [c4-architecture](skills\u002Fc4-architecture\u002FREADME.md) | C4 architecture diagrams with Mermaid |\n| 📝 Documentation | [crafting-effective-readmes](skills\u002Fcrafting-effective-readmes\u002FREADME.md) | Write effective README files |\n| 📝 Documentation | [draw-io](skills\u002Fdraw-io\u002FREADME.md) | Create & edit draw.io diagrams |\n| 📝 Documentation | [excalidraw](skills\u002Fexcalidraw\u002FREADME.md) | Work with Excalidraw diagrams |\n| 📝 Documentation | [frontend-to-backend-requirements](skills\u002Ffrontend-to-backend-requirements\u002FREADME.md) | Document API requirements |\n| 📝 Documentation | [marp-slide](skills\u002Fmarp-slide\u002FREADME.md) | Professional presentation slides |\n| 📝 Documentation | [mermaid-diagrams](skills\u002Fmermaid-diagrams\u002FREADME.md) | Software diagrams with Mermaid |\n| 📝 Documentation | [writing-clearly-and-concisely](skills\u002Fwriting-clearly-and-concisely\u002FREADME.md) | Clear, professional writing |\n| 🎨 Design & Frontend | [design-system-starter](skills\u002Fdesign-system-starter\u002FREADME.md) | Create design systems |\n| 🎨 Design & Frontend | [mui](skills\u002Fmui\u002FREADME.md) | Material-UI v7 patterns |\n| 🎨 Design & Frontend | [openapi-to-typescript](skills\u002Fopenapi-to-typescript\u002FREADME.md) | Convert OpenAPI to TypeScript |\n| 🎨 Design & Frontend | [react-dev](skills\u002Freact-dev\u002FREADME.md) | Type-safe React 18-19 with TypeScript |\n| 🎨 Design & Frontend | [react-useeffect](skills\u002Freact-useeffect\u002FREADME.md) | React useEffect best practices |\n| 🛠️ Development | [database-schema-designer](skills\u002Fdatabase-schema-designer\u002FREADME.md) | Design robust database schemas |\n| 🛠️ Development | [dependency-updater](skills\u002Fdependency-updater\u002FREADME.md) | Smart dependency management |\n| 🛠️ Development | [naming-analyzer](skills\u002Fnaming-analyzer\u002FREADME.md) | Suggest better variable\u002Ffunction names |\n| 🛠️ Development | [lesson-learned](skills\u002Flesson-learned\u002FREADME.md) | Extract SE lessons from recent code changes |\n| 🛠️ Development | [reducing-entropy](skills\u002Freducing-entropy\u002FREADME.md) | Minimize codebase size |\n| 🛠️ Development | [session-handoff](skills\u002Fsession-handoff\u002FREADME.md) | Seamless AI session transfers |\n| 🎯 Planning | [game-changing-features](skills\u002Fgame-changing-features\u002FREADME.md) | Find 10x product opportunities |\n| 🎯 Planning | [gepetto](skills\u002Fgepetto\u002FREADME.md) | Detailed implementation planning |\n| 🎯 Planning | [requirements-clarity](skills\u002Frequirements-clarity\u002FREADME.md) | Clarify requirements before coding |\n| 🎯 Planning | [ship-learn-next](skills\u002Fship-learn-next\u002FREADME.md) | Turn learning into actionable reps |\n| 👔 Professional | [daily-meeting-update](skills\u002Fdaily-meeting-update\u002FREADME.md) | Interactive daily standup generator |\n| 👔 Professional | [difficult-workplace-conversations](skills\u002Fdifficult-workplace-conversations\u002FREADME.md) | Navigate difficult conversations |\n| 👔 Professional | [feedback-mastery](skills\u002Ffeedback-mastery\u002FREADME.md) | Deliver constructive feedback |\n| 👔 Professional | [professional-communication](skills\u002Fprofessional-communication\u002FREADME.md) | Technical communication guide |\n| 🧪 Testing | [qa-test-planner](skills\u002Fqa-test-planner\u002FREADME.md) | Comprehensive QA test planning |\n| 📦 Git | [commit-work](skills\u002Fcommit-work\u002FREADME.md) | High-quality git commits |\n| 🔧 Utilities | [datadog-cli](skills\u002Fdatadog-cli\u002FREADME.md) | Debug with Datadog logs & metrics |\n| 🔧 Utilities | [domain-name-brainstormer](skills\u002Fdomain-name-brainstormer\u002FREADME.md) | Generate & check domain names |\n| 🔧 Utilities | [humanizer](skills\u002Fhumanizer\u002FREADME.md) | Remove AI writing patterns |\n| 🔧 Utilities | [meme-factory](skills\u002Fmeme-factory\u002FREADME.md) | Generate memes with API |\n| 🔧 Utilities | [jira](skills\u002Fjira\u002FREADME.md) | Natural language Jira interaction |\n| 🔧 Utilities | [web-to-markdown](skills\u002Fweb-to-markdown\u002FREADME.md) | Convert webpages to Markdown |\n\n---\n\n## 🤖 Agents & Commands\n\n> **Requires [Claude Code CLI](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude-code)** — These agents and commands are exclusive to Claude Code users.\n>\n> For full access, add the marketplace and install plugins:\n> ```bash\n> \u002Fplugin marketplace add softaworks\u002Fagent-toolkit\n> \u002Fplugin install codex@agent-toolkit\n> ```\n\n### Agents\n\nSpecialized sub-agents that Claude Code can delegate tasks to:\n\n| Agent | Description |\n|-------|-------------|\n| ascii-ui-mockup-generator | Visualize UI concepts through ASCII mockups |\n| codebase-pattern-finder | Find similar implementations and patterns |\n| communication-excellence-coach | Email refinement, tone calibration, roleplay |\n| general-purpose | Default agent for complex multi-step tasks |\n| mermaid-diagram-specialist | Create flowcharts, sequence diagrams, ERDs |\n| ui-ux-designer | Research-backed UI\u002FUX design feedback |\n\n### Slash Commands\n\nReusable workflows invoked with `\u002Fcommand-name`:\n\n| Command | Description |\n|---------|-------------|\n| `\u002Fcodex-plan` | Create implementation plans using Codex 5.2 |\n| `\u002Fcompose-email` | Draft professional emails |\n| `\u002Fexplain-changes-mental-model` | Build mental model of code changes |\n| `\u002Fexplain-pr-changes` | Generate PR summaries |\n| `\u002Fsync-branch` | Sync feature branch with main |\n| `\u002Fsync-skills-readme` | Update README skills table |\n| `\u002Fviral-tweet` | Optimize tweet ideas for X engagement |\n\n---\n\n## 📖 Skill Structure\n\nEach skill contains:\n- `SKILL.md` - Detailed instructions for the agent (with YAML frontmatter)\n- `README.md` - User-friendly documentation with examples\n- `scripts\u002F` - Helper scripts for automation (optional)\n- `references\u002F` - Supporting documentation (optional)\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! When adding new skills:\n\n1. Follow the [Agent Skills](https:\u002F\u002Fagentskills.io\u002F) format\n2. Include both `SKILL.md` (for agents) and `README.md` (for users)\n3. Add YAML frontmatter to `SKILL.md` with `name:` and `description:` fields\n4. Update this README.md with a link to your skill\n\n---\n\n## 📄 License\n\nMIT\n\n---\n\n## 🔗 Links\n\n- [Agent Skills Format](https:\u002F\u002Fagentskills.io\u002F)\n- [Claude Code Documentation](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude\u002Fdocs)\n- [GitHub Repository](https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit)\n","# Softaworks 代理技能\n\n由 [@leonardocouy](https:\u002F\u002Fgithub.com\u002Fleonardocouy) 分享的一系列实用技能，旨在通过 Claude Code 提升日常工作效率。这些技能是以封装好的指令和脚本形式提供的，能够扩展代理在开发、文档编写、项目规划及各类专业工作流中的能力。\n\n技能遵循 [Agent Skills](https:\u002F\u002Fagentskills.io\u002F) 的格式。\n\n---\n\n## 🧭 快速导航\n\n**[🚀 安装](#-installation)** • **[📚 可用技能](#-available-skills)** • **[🤖 代理与命令](#-agents--commands)** • **[📖 技能结构](#-skill-structure)** • **[🤝 贡献](#-contributing)** • **[📄 许可证](#-license)** • **[🔗 链接](#-links)**\n\n---\n\n## 🚀 安装\n\n### 快速安装（推荐）\n\n```bash\nnpx skills add softaworks\u002Fagent-toolkit\n```\n\n此方法适用于多种 AI 编程代理（Claude Code、Codex、Cursor、AdaL 等）。\n\n### 注册为插件市场\n\n在 Claude Code 中运行以下命令：\n\n```bash\n\u002Fplugin marketplace add softaworks\u002Fagent-toolkit\n\u002Fplugin\n```\n\n### 安装插件\n\n**选项 1：通过浏览界面**\n\n1. 切换到 **Marketplaces** 选项卡（使用方向键或 Tab 键）\n2. 选择 **agent-toolkit**，按 Enter 键\n3. 浏览并选择您想要安装的插件\n4. 选择 **Install now**\n\n**选项 2：直接安装**\n\n```bash\n# 安装特定技能\n\u002Fplugin install codex@agent-toolkit\n\u002Fplugin install humanizer@agent-toolkit\n\n# 安装特定代理\n\u002Fplugin install agent-codebase-pattern-finder@agent-toolkit\n\n# 安装特定命令\n\u002Fplugin install command-codex-plan@agent-toolkit\n```\n\n**选项 3：询问代理**\n\n只需告诉 Claude Code：\n\n> 请从 github.com\u002Fsoftaworks\u002Fagent-toolkit 安装技能\n\n### 可用插件\n\n每个技能、代理和命令都是可以单独安装的独立插件：\n\n- **技能** → 请参阅 [可用技能](#-available-skills) 获取完整列表\n- **代理** → 请参阅 [代理](#agents)（以 `agent-\u003Cname>@agent-toolkit` 格式安装）\n- **命令** → 请参阅 [斜杠命令](#slash-commands)（以 `command-\u003Cname>@agent-toolkit` 格式安装）\n\n### 更新插件\n\n要将插件更新到最新版本：\n\n1. 在 Claude Code 中运行 `\u002Fplugin`\n2. 切换到 **Marketplaces** 选项卡\n3. 选择 **agent-toolkit**\n4. 选择 **Update marketplace**\n\n您还可以 **启用自动更新**，以便自动获取最新版本。\n\n### 手动安装\n\n**针对 Claude Code（手动）** — 仅限技能  \n```bash\ncp -r skills\u002F\u003Cskill-name> ~\u002F.claude\u002Fskills\u002F\n```\n\n**针对 claude.ai** — 仅限技能\n\n将技能添加到项目知识库中，或将 SKILL.md 内容粘贴到对话中。\n\n---\n\n## 📚 可用技能\n\n| 类别 | 技能 | 描述 |\n|----------|-------|-------------|\n| 🤖 AI 工具 | [codex](skills\u002Fcodex\u002FREADME.md) | 使用 GPT-5.2 进行高级代码分析 |\n| 🤖 AI 工具 | [gemini](skills\u002Fgemini\u002FREADME.md) | 大规模审查（超过 20 万上下文）|\n| 🤖 AI 工具 | [perplexity](skills\u002Fperplexity\u002FREADME.md) | 网络搜索与研究 |\n| 🔮 元 | [agent-md-refactor](skills\u002Fagent-md-refactor\u002FREADME.md) | 重构臃肿的代理指令文件 |\n| 🔮 元 | [command-creator](skills\u002Fcommand-creator\u002FREADME.md) | 创建 Claude Code 斜杠命令 |\n| 🔮 元 | [plugin-forge](skills\u002Fplugin-forge\u002FREADME.md) | 构建 Claude Code 插件及清单文件 |\n| 🔮 元 | [skill-judge](skills\u002Fskill-judge\u002FREADME.md) | 评估技能设计质量 |\n| 📝 文档 | [backend-to-frontend-handoff-docs](skills\u002Fbackend-to-frontend-handoff-docs\u002FREADME.md) | 前端 API 交接文档 |\n| 📝 文档 | [c4-architecture](skills\u002Fc4-architecture\u002FREADME.md) | 使用 Mermaid 绘制 C4 架构图 |\n| 📝 文档 | [crafting-effective-readmes](skills\u002Fcrafting-effective-readmes\u002FREADME.md) | 撰写高效的 README 文件 |\n| 📝 文档 | [draw-io](skills\u002Fdraw-io\u002FREADME.md) | 创建并编辑 draw.io 图表 |\n| 📝 文档 | [excalidraw](skills\u002Fexcalidraw\u002FREADME.md) | 使用 Excalidraw 图表工作 |\n| 📝 文档 | [frontend-to-backend-requirements](skills\u002Ffrontend-to-backend-requirements\u002FREADME.md) | 记录 API 需求 |\n| 📝 文档 | [marp-slide](skills\u002Fmarp-slide\u002FREADME.md) | 专业演示文稿幻灯片 |\n| 📝 文档 | [mermaid-diagrams](skills\u002Fmermaid-diagrams\u002FREADME.md) | 使用 Mermaid 绘制软件架构图 |\n| 📝 文档 | [writing-clearly-and-concisely](skills\u002Fwriting-clearly-and-concisely\u002FREADME.md) | 清晰、专业的写作 |\n| 🎨 设计与前端 | [design-system-starter](skills\u002Fdesign-system-starter\u002FREADME.md) | 创建设计系统 |\n| 🎨 设计与前端 | [mui](skills\u002Fmui\u002FREADME.md) | Material-UI v7 模式 |\n| 🎨 设计与前端 | [openapi-to-typescript](skills\u002Fopenapi-to-typescript\u002FREADME.md) | 将 OpenAPI 转换为 TypeScript |\n| 🎨 设计与前端 | [react-dev](skills\u002Freact-dev\u002FREADME.md) | 使用 TypeScript 的类型安全 React 18-19 版本 |\n| 🎨 设计与前端 | [react-useeffect](skills\u002Freact-useeffect\u002FREADME.md) | React useEffect 最佳实践 |\n| 🛠️ 开发 | [database-schema-designer](skills\u002Fdatabase-schema-designer\u002FREADME.md) | 设计健壮的数据库模式 |\n| 🛠️ 开发 | [dependency-updater](skills\u002Fdependency-updater\u002FREADME.md) | 智能依赖管理 |\n| 🛠️ 开发 | [naming-analyzer](skills\u002Fnaming-analyzer\u002FREADME.md) | 提供建议，改进变量\u002F函数命名 |\n| 🛠️ 开发 | [lesson-learned](skills\u002Flesson-learned\u002FREADME.md) | 从最近的代码变更中提取 SE 经验教训 |\n| 🛠️ 开发 | [reducing-entropy](skills\u002Freducing-entropy\u002FREADME.md) | 最小化代码库大小 |\n| 🛠️ 开发 | [session-handoff](skills\u002Fsession-handoff\u002FREADME.md) | 无缝切换 AI 会话 |\n| 👔 专业 | [daily-meeting-update](skills\u002Fdaily-meeting-update\u002FREADME.md) | 交互式每日站会生成器 |\n| 👔 专业 | [difficult-workplace-conversations](skills\u002Fdifficult-workplace-conversations\u002FREADME.md) | 应对困难的工作场所对话 |\n| 👔 专业 | [feedback-mastery](skills\u002Ffeedback-mastery\u002FREADME.md) | 提供建设性反馈 |\n| 👔 专业 | [professional-communication](skills\u002Fprofessional-communication\u002FREADME.md) | 技术沟通指南 |\n| 🧪 测试 | [qa-test-planner](skills\u002Fqa-test-planner\u002FREADME.md) | 全面的 QA 测试计划 |\n| 📦 Git | [commit-work](skills\u002Fcommit-work\u002FREADME.md) | 高质量的 git 提交 |\n| 🔧 实用工具 | [datadog-cli](skills\u002Fdatadog-cli\u002FREADME.md) | 使用 Datadog 日志和指标进行调试 |\n| 🔧 实用工具 | [domain-name-brainstormer](skills\u002Fdomain-name-brainstormer\u002FREADME.md) | 生成并检查域名 |\n| 🔧 实用工具 | [humanizer](skills\u002Fhumanizer\u002FREADME.md) | 去除 AI 写作痕迹 |\n| 🔧 实用工具 | [meme-factory](skills\u002Fmeme-factory\u002FREADME.md) | 使用 API 生成表情包 |\n| 🔧 实用工具 | [jira](skills\u002Fjira\u002FREADME.md) | 自然语言与 Jira 交互 |\n| 🔧 实用工具 | [web-to-markdown](skills\u002Fweb-to-markdown\u002FREADME.md) | 将网页转换为 Markdown |\n\n---\n\n## 🤖 代理与命令\n\n> **需要 [Claude Code CLI](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude-code)** — 这些代理和命令仅限 Claude Code 用户使用。\n>\n> 若要获得完整访问权限，请添加市场并安装插件：\n> ```bash\n> \u002Fplugin marketplace add softaworks\u002Fagent-toolkit\n> \u002Fplugin install codex@agent-toolkit\n> ```\n\n### 代理\n\nClaude Code 可以委派任务的专用子代理：\n\n| 代理 | 描述 |\n|-------|-------------|\n| ascii-ui-mockup-generator | 通过 ASCII 模拟图可视化 UI 概念 |\n| codebase-pattern-finder | 查找相似的实现和模式 |\n| communication-excellence-coach | 邮件优化、语气校准、角色扮演 |\n| general-purpose | 复杂多步骤任务的默认代理 |\n| mermaid-diagram-specialist | 创建流程图、序列图、ERD |\n| ui-ux-designer | 基于研究的 UI\u002FUX 设计反馈 |\n\n### 斜杠命令\n\n通过 `\u002Fcommand-name` 调用的可重用工作流：\n\n| 命令 | 描述 |\n|---------|-------------|\n| `\u002Fcodex-plan` | 使用 Codex 5.2 创建实施计划 |\n| `\u002Fcompose-email` | 撰写专业电子邮件 |\n| `\u002Fexplain-changes-mental-model` | 构建代码变更的心理模型 |\n| `\u002Fexplain-pr-changes` | 生成 PR 摘要 |\n| `\u002Fsync-branch` | 将功能分支与主分支同步 |\n| `\u002Fsync-skills-readme` | 更新 README 中的技能表格 |\n| `\u002Fviral-tweet` | 优化推文创意以提高 X 平台的互动率 |\n\n---\n\n## 📖 技能结构\n\n每个技能包含：\n- `SKILL.md` - 代理的详细说明（带有 YAML 前置内容）\n- `README.md` - 包含示例的用户友好型文档\n- `scripts\u002F` - 用于自动化的辅助脚本（可选）\n- `references\u002F` - 支持性文档（可选）\n\n---\n\n## 🤝 贡献\n\n欢迎贡献！添加新技能时：\n1. 遵循 [Agent Skills](https:\u002F\u002Fagentskills.io\u002F) 格式\n2. 同时包含 `SKILL.md`（面向代理）和 `README.md`（面向用户）\n3. 在 `SKILL.md` 中添加 YAML 前置内容，包括 `name:` 和 `description:` 字段\n4. 更新此 README.md，添加指向您技能的链接\n\n---\n\n## 📄 许可证\n\nMIT\n\n---\n\n## 🔗 链接\n\n- [Agent Skills 格式](https:\u002F\u002Fagentskills.io\u002F)\n- [Claude Code 文档](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude\u002Fdocs)\n- [GitHub 仓库](https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit)","# agent-toolkit 快速上手指南\n\nagent-toolkit 是一套专为提升日常开发效率设计的 AI 技能包（Skills），适用于 Claude Code、Codex、Cursor 等 AI 编程助手。它提供了从代码分析、文档生成到项目规划的专业指令集。\n\n## 环境准备\n\n*   **系统要求**：支持 macOS、Linux 或 Windows (WSL)。\n*   **前置依赖**：\n    *   已安装 [Node.js](https:\u002F\u002Fnodejs.org\u002F) (推荐 LTS 版本)。\n    *   已安装并配置好 **Claude Code CLI** (`npm install -g @anthropic-ai\u002Fclaude-code`) 或其他支持的 AI Agent 工具。\n    *   确保终端可以访问 GitHub 和 npm 源（如遇网络问题，请配置国内镜像源）。\n\n## 安装步骤\n\n推荐使用 `npx` 进行一键安装，该方法兼容多种 AI 编程助手。\n\n### 方法一：快速安装（推荐）\n\n在终端中运行以下命令：\n\n```bash\nnpx skills add softaworks\u002Fagent-toolkit\n```\n\n### 方法二：在 Claude Code 中注册插件市场\n\n如果你主要使用 Claude Code，可以通过以下命令将 toolkit 注册为插件市场：\n\n```bash\n\u002Fplugin marketplace add softaworks\u002Fagent-toolkit\n\u002Fplugin\n```\n\n随后在交互界面中：\n1. 切换到 **Marketplaces** 标签页。\n2. 选择 `agent-toolkit` 并按回车。\n3. 浏览并选择需要的技能插件，点击 **Install now**。\n\n### 方法三：直接安装特定技能\n\n你也可以直接安装单个技能、Agent 或命令：\n\n```bash\n# 安装特定技能 (例如: codex, humanizer)\n\u002Fplugin install codex@agent-toolkit\n\u002Fplugin install humanizer@agent-toolkit\n\n# 安装特定 Agent\n\u002Fplugin install agent-codebase-pattern-finder@agent-toolkit\n\n# 安装特定斜杠命令\n\u002Fplugin install command-codex-plan@agent-toolkit\n```\n\n## 基本使用\n\n安装完成后，技能将自动增强你的 AI 助手能力。以下是几种典型的使用方式：\n\n### 1. 自然语言调用技能\n直接在对话中描述需求，AI 会自动匹配已安装的技能。例如，告诉 Claude Code：\n\n> \"Please use the codex skill to analyze this codebase.\"\n> \"Help me write a professional README using the crafting-effective-readmes skill.\"\n\n或者针对中文用户，可以直接用中文描述任务（取决于底层模型的语言能力）：\n> \"请使用 codex 技能分析这段代码。\"\n> \"帮我写一份专业的 README 文档。\"\n\n### 2. 使用专用 Agent\n对于复杂任务，可以指派专门的子 Agent 处理。例如调用 UI 设计专家：\n\n> \"@ui-ux-designer Please review this component design.\"\n\n### 3. 使用斜杠命令 (Slash Commands)\n通过 `\u002F` 触发预定义的工作流：\n\n```bash\n\u002Fcodex-plan          # 使用 Codex 5.2 创建实施计划\n\u002Fcompose-email       # 起草专业邮件\n\u002Fexplain-pr-changes  # 生成 PR 变更摘要\n\u002Fsync-branch         # 同步功能分支到主分支\n```\n\n### 4. 手动安装（可选）\n如果自动安装失败，可手动复制技能文件：\n\n```bash\ncp -r skills\u002F\u003Cskill-name> ~\u002F.claude\u002Fskills\u002F\n```\n\n> **提示**：完整技能列表涵盖 AI 工具、文档编写、前端设计、开发辅助、测试规划及职场沟通等多个类别，可根据实际需求按需安装。","某全栈开发团队在接手一个遗留微服务项目时，需要快速理清后端 API 与前端页面的对接细节，并补全缺失的技术文档。\n\n### 没有 agent-toolkit 时\n- 开发人员需手动翻阅分散的代码文件，耗时数小时才能拼凑出完整的接口定义，效率极低且容易遗漏参数。\n- 前后端协作依赖口头沟通或零散的聊天记录，缺乏标准化的交接文档，导致联调阶段频繁出现数据格式错误。\n- 绘制系统架构图和流程图完全依靠人工手绘或使用独立绘图软件，无法随代码变更实时同步，文档迅速过时。\n- 编写 README 和技术规范时风格不统一，新人上手困难，团队需反复进行代码审查以纠正文档格式问题。\n\n### 使用 agent-toolkit 后\n- 调用 `backend-to-frontend-handoff-docs` 技能，AI 自动分析代码库并一键生成标准的 API 交接文档，将数小时工作压缩至分钟级。\n- 利用 `frontend-to-backend-requirements` 技能，自动生成结构清晰的需求对照表，确保前后端对字段定义的理解完全一致，大幅减少联调返工。\n- 通过 `c4-architecture` 和 `excalidraw` 技能，直接根据代码逻辑生成可编辑的 Mermaid 架构图和流程图，实现文档与代码的实时联动。\n- 借助 `crafting-effective-readmes` 技能，自动输出符合团队规范的高质量 README 文件，统一了文档风格，显著降低了新成员的学习成本。\n\nagent-toolkit 将原本碎片化、高成本的手工文档工作转化为自动化的标准流程，让开发者能专注于核心业务逻辑而非重复性的文书劳动。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsoftaworks_agent-toolkit_b3002aa4.png","softaworks","Softaworks","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsoftaworks_2fbc435e.jpg","A consulting software company. Surprise: it’s just me @leonardocouy enterprise mode.",null,"https:\u002F\u002Fsoftaworks.com\u002F","https:\u002F\u002Fgithub.com\u002Fsoftaworks",[82,86,90,94,98],{"name":83,"color":84,"percentage":85},"Python","#3572A5",67.2,{"name":87,"color":88,"percentage":89},"CSS","#663399",15.3,{"name":91,"color":92,"percentage":93},"Shell","#89e051",10.9,{"name":95,"color":96,"percentage":97},"TypeScript","#3178c6",5.1,{"name":99,"color":100,"percentage":101},"PLpgSQL","#336790",1.5,1574,123,"2026-04-18T15:02:21","MIT","未说明","无需求",{"notes":109,"python":106,"dependencies":110},"该工具并非独立运行的 AI 模型，而是一套专为 Claude Code 设计的技能（Skills）、代理（Agents）和命令（Commands）集合。安装和运行主要依赖 Node.js 环境（用于执行 npx 命令）以及 Anthropic 官方的 Claude Code CLI 工具。部分高级功能（如 codex 技能）需要用户拥有相应的 API 访问权限或订阅。无需配置本地 GPU、显存或特定的 Python 深度学习库。",[111,112],"Node.js (用于运行 npx)","Claude Code CLI",[13,15,14],[115,116,117,118,119,120,121],"agent-skills","ai","automation","claude","claude-code","coding-agent","development","2026-03-27T02:49:30.150509","2026-04-19T09:17:46.547458",[125,130,135,140,145,149],{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},41938,"为什么 Claude Code 无法自动发现或调用已安装的技能（Skills）？","这通常是因为 SKILL.md 文件缺少必需的 YAML frontmatter（元数据）。技能加载机制分为两个阶段：首先读取 name 和 description 进行索引，然后按需加载全文。如果没有 frontmatter，代理无法在启动时识别技能。\n\n请确保每个 SKILL.md 文件顶部包含以下格式的内容：\n\n```yaml\n---\nname: \"skill-name\"\ndescription: \"简要说明技能用途及何时使用它。\"\n---\n```\n\n此外，请检查文件目录结构是否正确。技能必须位于独立的子目录中（例如 `skills\u002Fmy-skill\u002FSKILL.md`），而不是直接放在 skills 目录下的单个 .md 文件中。","https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit\u002Fissues\u002F12",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},41939,"安装多个技能时出现大量重复文件，导致磁盘占用高和上下文窗口浪费，如何解决？","这是一个已知的缓存问题，会导致每个技能安装都复制整个仓库内容。解决方法如下：\n\n1. 从 Claude Code 中移除相关市场插件。\n2. 运行以下命令清除缓存：\n   ```bash\n   rm -rf ~\u002F.claude\u002Fplugins\u002Fcache\u002Fagent-toolkit\u002F\n   ```\n3. 重新安装技能。\n\n或者，推荐使用交互式安装方式以避免此问题：\n```bash\nnpx skills add softaworks\u002Fagent-toolkit\n```\n然后在提示中选择需要的技能。","https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit\u002Fissues\u002F3",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},41940,"在 Replit 环境中使用 npx 全局安装技能时报错\"Replit does not support global skill installation\"怎么办？","这是 Replit 环境的限制，因为它不允许对主目录进行持久化修改，所以不支持全局安装（-g 标志）。\n\n解决方案是在项目级别进行安装（不使用 -g 参数），这样会将技能安装到当前项目目录中，这在 Replit 上是可行的：\n\n```bash\nnpx skills add https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit --skill commit-work\n```\n\n请去掉任何全局安装标志即可正常运作。","https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit\u002Fissues\u002F10",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},41941,"技能文档中提到的参考文件（如 commit-message-template.md）缺失，是用户需要自己提供吗？","不是用户的问题，这通常是维护者遗漏提交导致的。如果发现技能文档（SKILL.md 或 README）中引用的文件不存在，通常是因为该文件未被检入仓库。\n\n在这种情况下，维护者会补交缺失的文件。例如，`commit-work` 技能缺失的 `reference\u002Fcommit-message-template.md` 文件已被补全。如果您遇到类似情况，可以查看最新的 commit 记录确认文件是否已修复，或者暂时根据文档描述自行创建模板文件。","https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit\u002Fissues\u002F1",{"id":146,"question_zh":147,"answer_zh":148,"source_url":129},41942,"如何验证技能文件的目录结构和元数据是否符合规范？","可以通过以下步骤在本地开发流程中进行验证：\n\n1. **检查目录结构**：运行 `ls -R skills\u002F` 确认每个技能都在其独立的子目录中（格式应为 `skills\u002F\u003Cskill-name>\u002FSKILL.md`）。\n\n2. **批量检查 Frontmatter**：运行以下脚本检查所有 SKILL.md 文件是否以 `---` 开头（即包含 YAML 元数据）：\n   ```bash\n   for f in $(find skills -name \"SKILL.md\" | sort); do\n     head -1 \"$f\" | grep -q \"^---\" && echo \"OK: $f\" || echo \"MISSING: $f\"\n   done\n   ```\n   如果输出均为 \"OK\"，则说明格式正确；如果有 \"MISSING\"，则需要为该文件添加 name 和 description 字段。",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},41943,"我想将 agent-toolkit 的技能发布到其他市场或作为独立包分发，有什么建议？","目前的技能结构设计为需要特定的文件夹格式和元数据才能被 Agent 正确发现。如果您希望将技能作为可安装的包分发以触达更多开发者，需要确保：\n\n1. 遵循标准的目录结构（`skill-name\u002FSKILL.md`）。\n2. 包含完整的 YAML frontmatter。\n3. 确保没有依赖整个仓库的冗余文件（避免安装时的重复复制问题）。\n\n目前社区也在探索类似 \"Skill Market\" 的平台，允许创作者将工具包作为可安装的技能包发布，从而实现被动收入并扩大受众。您可以关注相关的技能市场平台获取最新的分发渠道。","https:\u002F\u002Fgithub.com\u002Fsoftaworks\u002Fagent-toolkit\u002Fissues\u002F13",[]]