技能更新与维护管理助手

此 SKILL 帮助您对已存在的 Agent Skills 进行内容更新与维护管理，支持业务流程文档的标准化生成与更新。

何时使用此 SKILL

当您需要进行以下操作时使用此 SKILL：

• •更新或维护现有的 SKILL 内容
• •基于代码和业务逻辑生成标准化的业务流程文档（workflow）
• •将业务流程文档整合到现有 SKILL 结构中
• •审查和优化 SKILL 的结构与内容

Quick Start

用户需求 → 定位目标 SKILL → 阅读相关源码 → 参考模板生成文档 → 整合到 SKILL

示例操作：

• •"帮我生成登录流程的 workflow 文档" → 读取登录相关代码 → 生成 login-workflow.md
• •"更新字典管理的业务文档" → 读取最新代码 → 更新 frontend-dict-workflow.md

Instructions

核心工作流程

1. •

   确认目标 SKILL

   • •确定需要更新或维护的 SKILL 路径
   • •确认 SKILL 的模块结构（是否有 workflows/ 目录）
2. •

   阅读业务源码

   • •完整读取指定业务流程涉及的主要关联文件
   • •包括：后端 Controller、Service、Entity、Mapper
   • •包括：前端 API、Store、Hooks、组件
3. •

   参考标准模板

   • •使用 templates/business_flows_template.md 作为格式参考
   • •确保生成的文档符合模板结构
4. •

   生成业务流程文档

   • •基于读取的内容和模板格式撰写标准化 md 文件
   • •确保包含：流程概览、时序步骤、能力关联、数据结构、接口清单、问题建议、变更记录
5. •

   整合到 SKILL 结构

   • •将生成的 workflow 文档放入目标 SKILL 的 workflows/ 目录
   • •更新相关 SKILL.md 的引用

业务流程文档结构要求

每个业务流程文档必须包含以下章节：

## 1. 流程概览
- 流程名称、所属领域、涉及模块、目标说明

## 2. 流程步骤（时序）
- 时序图/流程图（使用 mermaid）
- 关键步骤拆解（5-10 步）

## 3. 与 cde-base 能力的关联
- 权限控制、多租户、幂等、缓存等框架能力映射

## 4. 关键数据结构与接口
- 主要实体/DTO/VO
- 关键接口列表

## 5. 常见问题与整改建议
- 常见问题及解决方案

## 6. 版本与变更记录
- 文档创建和更新历史

文件命名规范

• •业务流程文档：{业务名称}-workflow.md
• •示例：frontend-dict-workflow.md、login-workflow.md、order-create-workflow.md

Examples

示例 1：生成新的业务流程文档

用户请求：帮我生成用户登录流程的 workflow 文档

执行步骤：

1. •读取后端登录相关代码：
   • •cde-admin/src/main/java/.../SysLoginController.java
   • •cde-system/.../SysLoginService.java
   • •cde-common-satoken/.../LoginHelper.java
2. •读取前端登录相关代码：
   • •plus-ui/src/api/login.ts
   • •plus-ui/src/views/login/index.vue
   • •plus-ui/src/store/modules/user.ts
3. •参考 templates/business_flows_template.md 模板
4. •生成 login-workflow.md
5. •放入 modules/auth-system/workflows/ 目录

示例 2：更新现有业务流程文档

用户请求：更新字典管理的 workflow 文档，添加后端缓存机制说明

执行步骤：

1. •读取现有文档：workflows/frontend-dict-workflow.md
2. •读取后端缓存相关代码
3. •在"与 cde-base 能力的关联"章节添加缓存说明
4. •更新版本变更记录

Best Practices

1. •先读后写：在生成文档前，务必完整阅读所有相关源码
2. •遵循模板：严格按照模板结构组织内容，确保一致性
3. •时序图优先：使用 mermaid 绘制时序图，直观展示流程
4. •代码引用：文档中引用关键类名、方法名、接口路径，便于追溯
5. •增量更新：更新文档时，保留原有内容，仅修改变更部分
6. •记录变更：每次更新都要在"版本与变更记录"中添加记录

Requirements

• •熟悉目标 SKILL 的模块结构
• •能够访问和读取相关源代码文件
• •了解 mermaid 语法（用于绘制时序图）

Advanced Usage

批量生成 workflow 文档

当需要为整个模块生成所有业务流程文档时：

1. •列出模块下所有 Controller
2. •分析每个 Controller 的核心业务流程
3. •按优先级逐个生成 workflow 文档
4. •更新模块 SKILL.md 的导航引用

与 skill-writer 协作

• •如需创建全新的 SKILL 结构，请使用 skill-writer SKILL
• •本 SKILL 专注于已存在 SKILL 的内容更新与维护

验证检查清单

生成业务流程文档后，请验证：

• • 包含所有 6 个必需章节
• • 时序图使用 mermaid 语法且能正确渲染
• • 涉及的后端/前端模块路径准确
• • 接口路径与实际代码一致
• • 数据结构字段说明完整
• • 常见问题来自真实场景
• • 变更记录包含当前日期
• • 文件命名符合 {业务名称}-workflow.md 规范
• • 已整合到目标 SKILL 的 workflows/ 目录