RMDC系统设计文档 整体转换为SKILL
This commit is contained in:
115
2-需求转换专业设计/DDS转AgentSkill.md
Normal file
115
2-需求转换专业设计/DDS转AgentSkill.md
Normal file
@@ -0,0 +1,115 @@
|
||||
你是一位专业的 Agent Skills 架构师与 Claude Code Skills 作者。你的任务是:把给定的 RMDC 系统设计文档(DDS/PRD/架构说明)转换为一套可落地的 Claude Code Skills(系统级 Skill + 模块级 Skills + 横切 Skills),并输出完整目录树与每个 Skill 的 SKILL.md。
|
||||
|
||||
# 输入
|
||||
- 源文档路径由参数传入:$ARGUMENTS
|
||||
- 你必须使用动态注入读取输入内容(至少 2 处):
|
||||
- !`ls -la $(dirname "$ARGUMENTS")`
|
||||
- !`sed -n '1,200p' "$ARGUMENTS"`
|
||||
- (可选)!`grep -nE "模块|module|service|接口|API|事件|MQTT|topic|表|schema|RBAC|鉴权|状态机" "$ARGUMENTS" | head -n 50`
|
||||
|
||||
如果无法读取文件:明确说明缺少源文档内容,并输出“继续所需的最小信息清单”(模块接口/事件/表/状态机/依赖关系等),不要臆造细节。
|
||||
|
||||
# 系统模块(必须按此拆分)
|
||||
| 模块 | 职责 | 关键技术 |
|
||||
| rmdc-core | API Gateway、鉴权、路由 | Go + Gin |
|
||||
| rmdc-jenkins-branch-dac | Jenkins分支权限(DAC)、构建管理 | Jenkins API, MinIO |
|
||||
| rmdc-exchange-hub | MQTT消息网关、指令生命周期 | MQTT, PostgreSQL |
|
||||
| rmdc-watchdog | 边缘代理、K8S操作、二级授权 | K8S API, TOTP |
|
||||
| rmdc-project-management | 项目管理、一级授权中心 | PostgreSQL |
|
||||
| rmdc-work-procedure | 工单管理、工单流程、生命周期管理 | 状态机 |
|
||||
| rmdc-audit-log | 审计日志 | PostgreSQL |
|
||||
| rmdc-user-auth | 用户认证、权限管理 | JWT, RBAC |
|
||||
|
||||
# 输出目标(必须一次性给全)
|
||||
我将把输出落盘到 Windows 目录:
|
||||
- C:/Users/wddsh/Documents/IdeaProjects/ProjectAGiPrompt/1-AgentSkills
|
||||
但你输出展示路径必须使用 Unix 风格(/)。
|
||||
|
||||
你需要输出:
|
||||
1) 全部 Skills 的目录结构树(tree)
|
||||
2) 每个 Skill 的 SKILL.md 完整内容(frontmatter + body)
|
||||
3) 如需要,补充 reference/ examples/ scripts/ 中关键文件内容(只给必要内容)
|
||||
4) 最后输出全局自检结果(逐条 PASS/FAIL + 修复建议)
|
||||
|
||||
# Skill 组织架构(必须遵守)
|
||||
生成以下 3 类 Skills:
|
||||
A) 系统级(1个):rmdc-system(跨模块一致性、依赖规则、版本/兼容策略、全局变更流程)
|
||||
B) 模块级(7个):每个模块 1 个 Skill(高频开发:实现步骤 + 依赖影响检查)
|
||||
C) 横切(至少3个):建议包含
|
||||
- designing-contracts(API/事件/Schema 契约、兼容策略、版本策略)
|
||||
- database-migrations(PostgreSQL迁移与回滚、字段演进)
|
||||
- observability-audit(日志/指标/trace/审计一致性;与 rmdc-audit-log 对齐)
|
||||
(你可按源文档内容增减,但不得少于 3 个横切 Skill)
|
||||
|
||||
# 规范约束(硬性)
|
||||
## 1. Frontmatter(极其重要)
|
||||
- name:小写字母/数字/连字符;动名词形式;<=64 字符
|
||||
- description:必须【单行】且 <1024 字符;第三人称;包含功能说明 + 触发场景 + 关键词
|
||||
- allowed-tools:最小授权原则(默认仅允许读取文件/执行本地命令/grep/sed;除非源文档明确需要网络或外部工具)
|
||||
- 必须出现 argument-hint(提示 $ARGUMENTS 的格式)
|
||||
|
||||
## 2. 内容精简与拆分
|
||||
- 删除 Claude 已知常识,只保留领域特定知识与具体操作步骤
|
||||
- 删除现有系统提示词prompt中多余的部分
|
||||
- 代码规范要求已经存在单独的SKILL,可以删除
|
||||
- 有重复说明设计内容,请去除不必要的重复内容
|
||||
- 冗长内容拆分进 reference/(例如:模块依赖、状态机、事件topic列表、表结构、错误码)拆分需要合理,能够获取到必要设计信息,不会获取过多无关信息
|
||||
- 示例代码放 examples/(只放与模块职责强相关的骨架示例)
|
||||
- 工具脚本放 scripts/(提供至少 1 个 verify 脚本:用于检查契约/迁移/编译或 lint;脚本要可运行,写明依赖)
|
||||
|
||||
## 3. 工作流(计划-验证-执行)
|
||||
每个 SKILL.md 必须包含以下结构:
|
||||
- Plan:产物清单 + 决策点(例如:涉及哪些模块、改动边界、是否影响契约/事件/表)
|
||||
- Verify:Checklist(可勾选),并明确“验证点”(例如:契约兼容、topic/事件字段一致、DB migration 可回滚、RBAC 不破坏)
|
||||
- Execute:可操作步骤(命令化短句,按顺序)
|
||||
- Pitfalls:3~8 条常见坑(必须与该模块/横切主题相关)
|
||||
|
||||
## 4. 参数与动态上下文
|
||||
- 每个 Skill 必须使用 $ARGUMENTS(例如:模块名、变更类型、输入文档路径、目标目录等)
|
||||
- 每个 Skill 必须至少包含 2 处 !`command` 动态注入示例(用于:读取仓库结构、查找接口/事件/表、运行测试)
|
||||
- 所有示例命令需在类 Unix shell 下可执行;避免 OS 特定路径
|
||||
|
||||
## 5. 质量标准
|
||||
- 每个 SKILL.md 主体 <500 行
|
||||
- 术语一致:模块名、契约、事件、topic、授权层级(一级/二级)、DAC、RBAC、JWT、审计
|
||||
- 输出必须“可落地”:能指导真实开发或文档对齐/审查
|
||||
|
||||
# 目录模板(必须套用)
|
||||
<skill-name>/
|
||||
SKILL.md
|
||||
reference/
|
||||
examples/
|
||||
scripts/
|
||||
|
||||
# 生成步骤(你必须按此顺序输出)
|
||||
步骤1:先给出 Skills 清单(系统级/模块级/横切),并为每个 Skill 提供 2~3 个 name 候选,最终选择 1 个 name(附一句理由)
|
||||
步骤2:输出总目录树(Unix 路径)
|
||||
步骤3:依次输出每个 Skill 的 SKILL.md(完整内容)
|
||||
步骤4:如有 supporting files:按“文件路径 -> 文件内容”逐个输出(只给关键必要文件)
|
||||
步骤5:输出全局 Verify Checklist 自检结果(逐条 PASS/FAIL + 修复建议)
|
||||
|
||||
# 特殊要求(与模块强相关)
|
||||
- rmdc-core:必须包含鉴权/路由变更对下游接口的影响检查(API契约、错误码、JWT claims)
|
||||
- rmdc-jenkins-branch-dac:必须包含 DAC 规则变更的回归检查与最小权限策略;涉及 Jenkins API 与 MinIO 访问的验证点
|
||||
- rmdc-exchange-hub:必须包含 MQTT topic/指令生命周期 的契约检查与幂等处理验证点
|
||||
- rmdc-watchdog:必须包含 K8S API 操作的安全边界与 TOTP 二级授权的验证点
|
||||
- rmdc-project-management:必须包含一级授权中心的字段/状态变更影响检查
|
||||
- rmdc-audit-log:必须包含审计不可篡改/字段完整性/写入链路的验证点
|
||||
- rmdc-user-auth:必须包含 RBAC/JWT/会话安全变更的兼容与回归验证点
|
||||
|
||||
现在开始生成。源文档路径由我通过 $ARGUMENTS 传入。
|
||||
|
||||
|
||||
### RMDC-系统
|
||||
|
||||
### claude name命名 rmdc-project-management-skill
|
||||
项目管理系统的设计说明见目录 C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\8-CMII-RMDC\4-rmdc-project-management
|
||||
请将详细系统设计转换为单独的SKILL
|
||||
|
||||
### claude name命名 rmdc-work-procedure-skill
|
||||
工单系统模块的设计文档说明见目录 C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\8-CMII-RMDC\7-rmdc-work-procedure
|
||||
请将详细系统设计转换为单独的SKILL
|
||||
|
||||
### claude name命名 rmdc-watchdog-skill
|
||||
watchdog模块的设计文档说明见目录 C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\8-CMII-RMDC\6-rmdc-watchdog
|
||||
请将详细系统设计转换为单独的SKILL
|
||||
Reference in New Issue
Block a user