agent-skills/skills/g3fo-docs/SKILL.md

name, description

name	description
g3fo-docs	g3fo 系统相关文档。管理业务流程说明、服务职责定义、中间件标准部署、系统初始化规范，以及跨环境（Dev/UAT）和多客户的资产清单。支持差异化配置查询与业务逻辑问答。

g3fo 系统相关文档 (g3fo-docs)

本 Skill 采用“标准模板 + 客户清单”的架构，并整合了业务流程与服务职责，旨在帮助 AI 快速理解并回答复杂的系统业务问题。

1. 查找指南

• 查业务流程：查阅 references/business_flows/ (如订单生命周期、用户入金等跨服务流程)。
• 查服务职责：查阅 references/services/ (如 g3fo-trade-service.md 定义的具体功能)。
• 查架构概览：查阅 references/architecture/domain_overview.md。
• 分析测试流程：参考 references/business_flows/_TEST_FLOW_TEMPLATE.md。
• 查标准运维流程：去 references/middleware/ 或 references/system-init/。
• 查具体环境/客户资产：
  • 内部环境（Dev/UAT）：查阅 references/inventory/internal.md。
  • 外部客户（客户A、B等）：查阅 references/inventory/clients/[客户名].md。

2. 问答逻辑 (AI 引导)

A. 业务逻辑问答

1. 识别范围：判断用户问题涉及哪些业务流程 or 服务。
2. 加载文档：
   • 优先查找 business_flows/ 下的相关流程文档。
   • 结合 services/ 下涉及的服务文档，深入了解具体职责。
3. 关联分析：
   • 使用流程文档中的 Mermaid 时序图理解服务间的交互。
   • 如果用户问及“某个功能由谁负责”，查阅 architecture/domain_overview.md 确认所属域。
4. 回答准则：
   • 基于事实：仅根据已有的 Markdown 文档回答。
   • 明确边界：如果文档中没有相关说明，必须回答：“根据现有文档，我无法确定 [具体业务点] 的实现细节，建议查阅代码或询问开发人员。”

B. 运维配置生成

1. 识别主体：确定用户问的是哪个环境或哪个客户。
2. 组合信息：
   • 读取资产变量：优先读取客户专属文件（如 clients/client_a.md）或内部清单（internal.md）中的“变量定义”表格。
   • 读取部署模版：读取 middleware/ 下的标准部署文档（如 keepalived/deploy.md）。
   • 变量替换：将部署文档中的 ${VARIABLE_NAME} 占位符替换为资产清单中对应的值。
3. 输出要求：
   • 环境标注：在提供客户配置时，必须明确标注该配置适用于哪个特定环境，防止误操作。
   • 完整配置：如果用户要求生成特定节点的配置文件，请直接输出替换后的完整配置内容。
   • MySQL 命令规范：
     • 强制包含 Host：所有 docker exec 执行的 mysql 命令必须显式包含 -h127.0.0.1 参数，以确保在容器内连接成功。
     • 双格式输出：当提供 SQL 修复或查询脚本时，必须同时提供以下两种格式：
       • 格式 A (Docker 模式)：完整的 docker exec -it mysql mysql -uroot -pafe123456 -h127.0.0.1 -e "SQL_CONTENT"。
       • 格式 B (纯 SQL 模式)：仅包含 SQL 语句本身，方便在 GUI 工具中执行。

C. 测试流程分析 (New)

1. 需求解析：识别用户提出的业务关键词（如“下单”、“撤单”、“充值”）。
2. 文档检索：
   • 查找 business_flows/ 下的业务流程文档。
   • 查找 services/ 下涉及的服务定义。
3. 代码溯源：
   • 根据文档中提到的服务，在项目中搜索对应的 Controller、Service 或核心逻辑代码。
   • 重点搜索路径：
     • REST 接口：com.afe.g3fo.*.controller 或 com.afe.g3fo.*.api。
     • Dubbo 接口：com.afe.g3fo.*.facade（定义）及 com.afe.g3fo.*.facade.impl（实现）。
   • 重点搜索注解：@RequestMapping, @PostMapping, @GetMapping, @Service, @DubboService 等。
4. 表格生成：汇总信息，输出包含“步骤”、“涉及服务”、“关键接口/代码逻辑”、“测试内容/预期结果”的表格。
   • 格式参考：references/business_flows/_TEST_FLOW_TEMPLATE.md。

3. 示例 Prompt (用户可参考)

• 业务咨询：
  • “我想测试下单业务流程，请分析代码并列出详细的测试步骤表格。”
  • “g3fo 系统中，一个订单从下单到成交会经过哪些服务？请结合 references/business_flows/ 下的相关文档回答。”
  • “g3fo-margin-service 负责哪些核心逻辑？它的上下游依赖是谁？”
• 部署配置：
  • “请结合 references/inventory/internal.md 中的 UAT 环境变量，参考 references/middleware/keepalived/deploy.md 部署文档，为我生成 Node A 的 keepalived.conf 配置文件。”
• 故障排查：
  • “我的 MySQL 出现了复制冲突，报错 Duplicate entry，请根据 references/middleware/mysql/fault-analysis.md 提供排查脚本 and 修复建议。”

4. 资源地图

• 业务与服务:
  • 服务职责: services/ (g3fo-trade-service, g3fo-margin-service 等)
  • 跨服务流程: business_flows/ (订单生命周期等)
  • 架构概览: architecture/domain_overview.md
• 中间件标准:
  • Keepalived: middleware/keepalived/
  • MySQL: middleware/mysql/
  • Redis: middleware/redis/
• 系统规范: 内核优化, 安全加固...
• 资产清单: 内部测试机, 客户生产环境...