Softaworks 代理技能

由 @leonardocouy 分享的一系列实用技能，旨在通过 Claude Code 提升日常工作效率。这些技能是以封装好的指令和脚本形式提供的，能够扩展代理在开发、文档编写、项目规划及各类专业工作流中的能力。

技能遵循 Agent Skills 的格式。

---

🧭 快速导航

🚀 安装 • 📚 可用技能 • 🤖 代理与命令 • 📖 技能结构 • 🤝 贡献 • 📄 许可证 • 🔗 链接

---

🚀 安装

快速安装（推荐）

npx skills add softaworks/agent-toolkit

此方法适用于多种 AI 编程代理（Claude Code、Codex、Cursor、AdaL 等）。

注册为插件市场

在 Claude Code 中运行以下命令：

/plugin marketplace add softaworks/agent-toolkit
/plugin

安装插件

选项 1：通过浏览界面

1. 切换到 Marketplaces 选项卡（使用方向键或 Tab 键）
2. 选择 agent-toolkit，按 Enter 键
3. 浏览并选择您想要安装的插件
4. 选择 Install now

选项 2：直接安装

# 安装特定技能
/plugin install codex@agent-toolkit
/plugin install humanizer@agent-toolkit

# 安装特定代理
/plugin install agent-codebase-pattern-finder@agent-toolkit

# 安装特定命令
/plugin install command-codex-plan@agent-toolkit

选项 3：询问代理

只需告诉 Claude Code：

请从 github.com/softaworks/agent-toolkit 安装技能

可用插件

每个技能、代理和命令都是可以单独安装的独立插件：

• 技能 → 请参阅 可用技能 获取完整列表
• 代理 → 请参阅 代理（以 agent-<name>@agent-toolkit 格式安装）
• 命令 → 请参阅 斜杠命令（以 command-<name>@agent-toolkit 格式安装）

更新插件

要将插件更新到最新版本：

1. 在 Claude Code 中运行 /plugin
2. 切换到 Marketplaces 选项卡
3. 选择 agent-toolkit
4. 选择 Update marketplace

您还可以 启用自动更新，以便自动获取最新版本。

手动安装

针对 Claude Code（手动） — 仅限技能

cp -r skills/<skill-name> ~/.claude/skills/

针对 claude.ai — 仅限技能

将技能添加到项目知识库中，或将 SKILL.md 内容粘贴到对话中。

---

📚 可用技能

类别	技能	描述
🤖 AI 工具	codex	使用 GPT-5.2 进行高级代码分析
🤖 AI 工具	gemini	大规模审查（超过 20 万上下文）
🤖 AI 工具	perplexity	网络搜索与研究
🔮 元	agent-md-refactor	重构臃肿的代理指令文件
🔮 元	command-creator	创建 Claude Code 斜杠命令
🔮 元	plugin-forge	构建 Claude Code 插件及清单文件
🔮 元	skill-judge	评估技能设计质量
📝 文档	backend-to-frontend-handoff-docs	前端 API 交接文档
📝 文档	c4-architecture	使用 Mermaid 绘制 C4 架构图
📝 文档	crafting-effective-readmes	撰写高效的 README 文件
📝 文档	draw-io	创建并编辑 draw.io 图表
📝 文档	excalidraw	使用 Excalidraw 图表工作
📝 文档	frontend-to-backend-requirements	记录 API 需求
📝 文档	marp-slide	专业演示文稿幻灯片
📝 文档	mermaid-diagrams	使用 Mermaid 绘制软件架构图
📝 文档	writing-clearly-and-concisely	清晰、专业的写作
🎨 设计与前端	design-system-starter	创建设计系统
🎨 设计与前端	mui	Material-UI v7 模式
🎨 设计与前端	openapi-to-typescript	将 OpenAPI 转换为 TypeScript
🎨 设计与前端	react-dev	使用 TypeScript 的类型安全 React 18-19 版本
🎨 设计与前端	react-useeffect	React useEffect 最佳实践
🛠️ 开发	database-schema-designer	设计健壮的数据库模式
🛠️ 开发	dependency-updater	智能依赖管理
🛠️ 开发	naming-analyzer	提供建议，改进变量/函数命名
🛠️ 开发	lesson-learned	从最近的代码变更中提取 SE 经验教训
🛠️ 开发	reducing-entropy	最小化代码库大小
🛠️ 开发	session-handoff	无缝切换 AI 会话
👔 专业	daily-meeting-update	交互式每日站会生成器
👔 专业	difficult-workplace-conversations	应对困难的工作场所对话
👔 专业	feedback-mastery	提供建设性反馈
👔 专业	professional-communication	技术沟通指南
🧪 测试	qa-test-planner	全面的 QA 测试计划
📦 Git	commit-work	高质量的 git 提交
🔧 实用工具	datadog-cli	使用 Datadog 日志和指标进行调试
🔧 实用工具	domain-name-brainstormer	生成并检查域名
🔧 实用工具	humanizer	去除 AI 写作痕迹
🔧 实用工具	meme-factory	使用 API 生成表情包
🔧 实用工具	jira	自然语言与 Jira 交互
🔧 实用工具	web-to-markdown	将网页转换为 Markdown

---

🤖 代理与命令

需要 Claude Code CLI — 这些代理和命令仅限 Claude Code 用户使用。

若要获得完整访问权限，请添加市场并安装插件：

/plugin marketplace add softaworks/agent-toolkit
/plugin install codex@agent-toolkit

代理

Claude Code 可以委派任务的专用子代理：

代理	描述
ascii-ui-mockup-generator	通过 ASCII 模拟图可视化 UI 概念
codebase-pattern-finder	查找相似的实现和模式
communication-excellence-coach	邮件优化、语气校准、角色扮演
general-purpose	复杂多步骤任务的默认代理
mermaid-diagram-specialist	创建流程图、序列图、ERD
ui-ux-designer	基于研究的 UI/UX 设计反馈

斜杠命令

通过 /command-name 调用的可重用工作流：

命令	描述
/codex-plan	使用 Codex 5.2 创建实施计划
/compose-email	撰写专业电子邮件
/explain-changes-mental-model	构建代码变更的心理模型
/explain-pr-changes	生成 PR 摘要
/sync-branch	将功能分支与主分支同步
/sync-skills-readme	更新 README 中的技能表格
/viral-tweet	优化推文创意以提高 X 平台的互动率

---

📖 技能结构

每个技能包含：

• SKILL.md - 代理的详细说明（带有 YAML 前置内容）
• README.md - 包含示例的用户友好型文档
• scripts/ - 用于自动化的辅助脚本（可选）
• references/ - 支持性文档（可选）

---

🤝 贡献

欢迎贡献！添加新技能时：

1. 遵循 Agent Skills 格式
2. 同时包含 SKILL.md（面向代理）和 README.md（面向用户）
3. 在 SKILL.md 中添加 YAML 前置内容，包括 name: 和 description: 字段
4. 更新此 README.md，添加指向您技能的链接

---

📄 许可证

MIT

---

🔗 链接

• Agent Skills 格式
• Claude Code 文档
• GitHub 仓库

agent-toolkit 快速上手指南

agent-toolkit 是一套专为提升日常开发效率设计的 AI 技能包（Skills），适用于 Claude Code、Codex、Cursor 等 AI 编程助手。它提供了从代码分析、文档生成到项目规划的专业指令集。

环境准备

• 系统要求：支持 macOS、Linux 或 Windows (WSL)。
• 前置依赖：
  • 已安装 Node.js (推荐 LTS 版本)。
  • 已安装并配置好 Claude Code CLI (npm install -g @anthropic-ai/claude-code) 或其他支持的 AI Agent 工具。
  • 确保终端可以访问 GitHub 和 npm 源（如遇网络问题，请配置国内镜像源）。

安装步骤

推荐使用 npx 进行一键安装，该方法兼容多种 AI 编程助手。

方法一：快速安装（推荐）

在终端中运行以下命令：

npx skills add softaworks/agent-toolkit

方法二：在 Claude Code 中注册插件市场

如果你主要使用 Claude Code，可以通过以下命令将 toolkit 注册为插件市场：

/plugin marketplace add softaworks/agent-toolkit
/plugin

随后在交互界面中：

1. 切换到 Marketplaces 标签页。
2. 选择 agent-toolkit 并按回车。
3. 浏览并选择需要的技能插件，点击 Install now。

方法三：直接安装特定技能

你也可以直接安装单个技能、Agent 或命令：

# 安装特定技能 (例如: codex, humanizer)
/plugin install codex@agent-toolkit
/plugin install humanizer@agent-toolkit

# 安装特定 Agent
/plugin install agent-codebase-pattern-finder@agent-toolkit

# 安装特定斜杠命令
/plugin install command-codex-plan@agent-toolkit

基本使用

安装完成后，技能将自动增强你的 AI 助手能力。以下是几种典型的使用方式：

1. 自然语言调用技能

直接在对话中描述需求，AI 会自动匹配已安装的技能。例如，告诉 Claude Code：

"Please use the codex skill to analyze this codebase." "Help me write a professional README using the crafting-effective-readmes skill."

或者针对中文用户，可以直接用中文描述任务（取决于底层模型的语言能力）：

"请使用 codex 技能分析这段代码。" "帮我写一份专业的 README 文档。"

2. 使用专用 Agent

对于复杂任务，可以指派专门的子 Agent 处理。例如调用 UI 设计专家：

"@ui-ux-designer Please review this component design."

3. 使用斜杠命令 (Slash Commands)

通过 / 触发预定义的工作流：

/codex-plan          # 使用 Codex 5.2 创建实施计划
/compose-email       # 起草专业邮件
/explain-pr-changes  # 生成 PR 变更摘要
/sync-branch         # 同步功能分支到主分支

4. 手动安装（可选）

如果自动安装失败，可手动复制技能文件：

cp -r skills/<skill-name> ~/.claude/skills/

提示：完整技能列表涵盖 AI 工具、文档编写、前端设计、开发辅助、测试规划及职场沟通等多个类别，可根据实际需求按需安装。