RMDC系统设计文档 整体转换为SKILL

This commit is contained in:
zeaslity
2026-01-21 16:15:49 +08:00
parent fc72a7312e
commit 631cce9e1e
163 changed files with 37099 additions and 114 deletions

View 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-contractsAPI/事件/Schema 契约、兼容策略、版本策略)
- database-migrationsPostgreSQL迁移与回滚、字段演进
- 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产物清单 + 决策点例如涉及哪些模块改动边界是否影响契约/事件/
- VerifyChecklist可勾选并明确验证点”(例如契约兼容topic/事件字段一致DB migration 可回滚RBAC 不破坏
- Execute可操作步骤命令化短句按顺序
- Pitfalls3~8 条常见坑必须与该模块/横切主题相关
## 4. 参数与动态上下文
- 每个 Skill 必须使用 $ARGUMENTS例如模块名变更类型输入文档路径目标目录等
- 每个 Skill 必须至少包含 2 !`command` 动态注入示例用于读取仓库结构查找接口/事件/运行测试
- 所有示例命令需在类 Unix shell 下可执行避免 OS 特定路径
## 5. 质量标准
- 每个 SKILL.md 主体 <500
- 术语一致模块名契约事件topic授权层级一级/二级)、DACRBACJWT审计
- 输出必须可落地”:能指导真实开发或文档对齐/审查
# 目录模板(必须套用)
<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