- name
- golang-skills
- description
- >
- metadata
- label
- Golang SKILL 集合
Golang SKILL 集合
本文件夹包含两个标准化的独立 SKILL 文档，用于指导 Golang 开发实践。
一、SKILL 导航
| SKILL 文档 | 适用场景 | 核心内容 |
|---|---|---|
| SKILL-logging.md | 添加日志 | xlogging 规范、日志 Level 选择、代码示例、禁止事项 |
| SKILL-flow-analysis.md | 流程梳理 | API 运行流程、Mermaid 流程图、Golang 代码示例、通用模式 |
二、快速开始
场景 1：需要添加日志
→ 打开 SKILL-logging.md
// 标准错误日志
if err != nil {
xlogging.D().Error(fmt.Sprintf("operation failed: %+v", err))
return err
}场景 2：需要理解 API 流程
- 查看 Mermaid 流程图
- 参考 Golang 代码实现
- 了解错误处理和并发模式
三、通用原则
所有 Golang 开发必须遵守以下原则：
| 原则 | 说明 |
|---|---|
| 优先仿写 | 参考项目中现有 Golang 代码 |
| 强制规范 | 无法仿写时，严格遵循对应 SKILL 的规定形式 |
| 配置优先 | 必须先读取 mcp-config.json 获取服务地址 |
| 文档为准 | MCP 调用必须参考 references/tools/*.md |
| 完整日志 | 所有错误必须记录，禁止静默处理 |
四、相关资源
| 资源 | 路径 | 说明 |
|---|---|---|
| MCP 工具文档 | ../../supplier-sourcing-assistant/references/tools/ | 所有 MCP 工具接口定义 |
| MCP 配置 | ../../supplier-sourcing-assistant/mcp-config.json | 服务 URL 配置示例 |
| Python SKILL 参考 | ../../supplier-sourcing-assistant/SKILL.md | 业务流程参考 |
五、更新记录
| 日期 | 更新内容 |
|---|---|
| 2026/04/08 | 优化为标准 SKILL 格式（统一 front matter、规范结构、添加导航） |
提示：如需在实际 Golang 项目中应用、添加更多示例或修改具体部分，请提供具体场景。