ken.li
3525aee49e
新增中间件相关文档包括 RocketMQ、Nacos、PowerJob 的部署指南和故障分析文档，完善 Keepalived 和 MySQL 的文档内容。新增内部通讯技能模板和示例文件，包括 3P更新、公司通讯、FAQ回答等格式指南。优化服务文档结构，补充 FIX 引擎高可用架构说明。新增中间件综合指南，详细说明高可用部署方案和灾备转换原理。 新增 RocketMQ 5.3.2 集群部署文档，包含 Controller 模式详解和详细配置说明。新增 Nacos 和 PowerJob 部署文档，补充服务依赖和关键配置。更新 MySQL 故障分析文档，优化复制冲突解决流程。新增内部通讯技能模板文件，规范公司内部通讯格式。 docs: 补充服务文档和中间件 TODO 列表 新增 g3fo-exchange-fix-engine-service 服务文档，详细说明服务职责和关键配置。新增中间件 TODO 列表，跟踪待补充的文档内容。更新 Keepalived 部署文档，新增主库抢占前置检查脚本和配置说明。优化中间件文档结构，补充常见问题和性能优化建议。 style: 统一文档格式和代码块样式 统一所有文档的代码块格式和标题层级。优化表格显示样式，增强可读性。规范环境变量和配置项的显示方式。调整文档结构，确保逻辑清晰。修复部分拼写错误和格式问题。 chore: 新增 LICENSE 文件 新增内部通讯技能的 Apache 2.0 LICENSE 文件。补充文档版权信息。更新文件头部的元数据描述。规范文件命名和目录结构。
Agent Skills
这是一个为 Cursor 和 Claude Agent 设计的“技能 (Skills)”集合仓库。
什么是 Agent Skills？
根据 Cursor 官方文档，Agent Skills 是 Agent 的动态能力：
- 按需加载：与始终加载的 Rules（规则）不同，Skills 仅在 Agent 认为与当前任务相关时才被调用。
- 结构化定义：每个 Skill 由一个
SKILL.md文件定义，通常包含：- Frontmatter：定义 Skill 的名称和触发描述。
- Markdown 指令：提供特定领域的知识或工作流。
- 附属资源：包括脚本 (
scripts/)、参考文档 (references/) 和素材 (assets/)。
- 扩展性：通过自定义命令 (
/command) 和钩子 (Hooks) 增强 Agent 的自动化能力。
提示：目前 Agent Skills 功能主要在 Cursor 的 Nightly/Beta 渠道中提供。
环境准备
本项目中的部分技能依赖本地 Python 环境执行自动化任务（如日志提取、配置分析等）。
1. 安装 Python
请确保您的系统中已安装 Python 3.8+：
- Windows: 从 Python 官网下载 并确保勾选 "Add Python to PATH"。
- 验证安装: 在终端运行
python --version。
2. 安装依赖
部分 Skill（如 g3fo-bug-finder）需要额外的库：
pip install paramiko
如何使用
本地同步
本项目提供了一个 skill-sync 技能，用于将项目内的 Skills 同步到 Claude 的全局目录。
- 同步命令 (Windows):
powershell -ExecutionPolicy Bypass -File skills/skill-sync/scripts/sync.ps1 - 全局路径: 同步后的 Skills 将存放在
~/.claude/skills(即C:\Users\<YourUser>\.claude\skills)。
触发技能
Agent 会根据您的请求内容自动识别并加载相关的技能。您也可以在对话中显式提及，例如：
- “使用
g3fo-bug-finder帮我看看 order-service 为什么报错。” - “根据
g3fo-docs生成 client_a 的部署配置。”
现有技能概览
本仓库核心技能 (Project Skills)
| 技能名称 | 作用说明 |
|---|---|
| g3fo-bug-finder | 故障排查专家：自动登录远程 Ubuntu 服务器，提取日志，结合 Nacos 配置与代码进行 Bug 诊断和修复。 |
| g3fo-docs | 系统百科全书：管理业务流程、服务职责、资产清单（Dev/UAT/客户）以及中间件标准部署规范。 |
| skill-creator | 技能创作指南：提供创建、初始化、打包新技能的标准工作流和设计模式。 |
| skill-sync | 同步工具：实现从项目到全局环境的技能同步，方便开发与调试。 |
常用系统/全局技能 (System Skills)
| 技能名称 | 作用说明 |
|---|---|
| canvas-design | 视觉艺术创作，生成 .png 或 .pdf 设计稿。 |
| docx / pdf / pptx | 专业的文档、PDF 及幻灯片处理与分析。 |
| create-rule | 创建 Cursor Rules (.mdc)，用于持久化的编码规范引导。 |
| create-subagent | 创建专门的子代理，用于代码审查、调试等特定任务。 |
| update-settings | 修改 Cursor/VSCode 的 settings.json 配置。 |
推荐技能资源
除了本项目内置的技能外，您还可以参考以下热门技能库：
- AgentSkills.so: 一个专门用于发现、分享和学习高质量 Agent 技能的社区平台。
- Anthropic Skills Library: Anthropic 官方维护的技能仓库，包含许多标准化的工作流示例。
- Awesome Claude Skills: 由 Composio 维护的精选技能清单，汇集了各种实用的第三方技能资源。
技能开发建议
如果您想创建新技能，请参考 skills/skill-creator/SKILL.md。核心步骤如下：
- 理解场景：确定技能要解决的具体重复性问题。
- 初始化：运行
python skills/skill-creator/scripts/init_skill.py <name>。 - 编写逻辑：在
SKILL.md中定义工作流，并在scripts/中编写辅助脚本。 - 打包与同步：完成开发后进行打包，并同步至全局环境测试。