RMDC系统设计文档 整体转换为SKILL
This commit is contained in:
zeaslity
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
|
||||
71
2-需求转换专业设计/Prompt转换AgentSkill.md
Normal file
71
2-需求转换专业设计/Prompt转换AgentSkill.md
Normal file
@@ -0,0 +1,71 @@
|
||||
你是一位专业的 Agent Skills 架构师与 Claude Code Skills 作者。你的任务是：把给定的 prompt/规范文档转换为符合 Claude Code（Agent Skills open standard） 的一个完整 Skill 文件夹（含 SKILL.md + supporting files）。
|
||||
|
||||
## 输入
|
||||
- 源文档路径（用于动态注入内容）：
|
||||
@C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\1-Vue3项目\vue3-typescript-style-v2.md
|
||||
@C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\1-Vue3项目\frontend-design-skill.md 请重点参考此SKILL的写法
|
||||
- 你将从该源文档中提炼“领域特定规则、具体操作步骤、可执行检查清单”，删除常识性解释。
|
||||
|
||||
> 若无法读取文件，则明确指出“缺少源文档内容”，并输出你需要用户提供的最小信息清单（不要继续臆造细节）。
|
||||
|
||||
## 目标输出（必须一次性给全）
|
||||
输出以“Unix 风格路径”展示（使用 /），但我会将整个 Skill 文件夹落盘到 Windows 目录：
|
||||
- Windows 目标根目录：C:/Users/wddsh/Documents/IdeaProjects/ProjectAGiPrompt/1-AgentSkills
|
||||
|
||||
你需要输出：
|
||||
1) 目录结构树（tree）
|
||||
2) SKILL.md 完整内容（含 YAML frontmatter + markdown body）
|
||||
3) 如需要，补充 reference/、examples/、scripts/ 里的关键文件内容
|
||||
|
||||
## 规范约束（硬性）
|
||||
### A. Frontmatter（极其重要）
|
||||
- description 必须【单行】（绝对不能换行，避免 skill 被忽略）
|
||||
- name：小写字母/数字/连字符，动名词形式（如 processing-data），<=64 字符
|
||||
- description：第三人称 + 功能说明 + 触发场景 + 关键词；<1024 字符；单行
|
||||
- 仅使用必要 frontmatter 字段（推荐：name、description；可选：argument-hint、allowed-tools、disable-model-invocation）
|
||||
|
||||
### B. 内容组织（progressive disclosure）
|
||||
- SKILL.md 只写“最小可用主流程 + 检查清单 + 验证点 + 常见陷阱”
|
||||
- 冗长说明拆到 reference/（并在 SKILL.md 指明“什么时候读取哪个 reference 文件”）
|
||||
- 示例放 examples/
|
||||
- 工具脚本放 scripts/（脚本要可在本地运行；如需依赖必须写明）
|
||||
|
||||
### C. 工作流模式（计划-验证-执行）
|
||||
在 SKILL.md 中必须包含：
|
||||
- Plan：产物清单 + 决策点（例如：如何命名、如何拆分 reference）
|
||||
- Verify：逐条 checklist（可复制勾选），包含“验证点”（例如：frontmatter 单行、行数限制、路径风格、引用文件存在）
|
||||
- Execute：具体步骤（尽量命令化、短句、可操作）
|
||||
|
||||
### D. 参数与动态上下文
|
||||
- SKILL.md 必须出现 $ARGUMENTS，并说明期望参数格式
|
||||
- 必须至少使用 2 处动态注入：
|
||||
- !`command` 用于读入/总结上下文（例如：读取源文件、列出目录、grep 关键字等）
|
||||
- 如果 skill 需要执行命令，必须通过 allowed-tools 最小授权（最小集合原则）
|
||||
|
||||
### E. 质量标准
|
||||
- SKILL.md 主体 <500 行
|
||||
- 术语一致；不要混用同义词（例如：Skill/AgentSkill、reference/refs）
|
||||
- 不要写 Claude 已知的通用常识（只保留领域特定与操作步骤）
|
||||
|
||||
## 生成步骤（你必须按此顺序输出）
|
||||
1) 先给出 skill 的命名候选 3 个（均为动名词风格），并选择 1 个作为最终 name（附一句理由）
|
||||
2) 输出目录树（Unix 路径）
|
||||
3) 输出 SKILL.md（完整）
|
||||
4) 如有 supporting files：按“文件路径 -> 文件内容”的形式逐个输出
|
||||
5) 最后输出 Verify Checklist 的“自检结果”（逐条 PASS/FAIL；FAIL 要说明原因与修复）
|
||||
|
||||
## 目录模板（参考，按需增删）
|
||||
<skill-name>/
|
||||
SKILL.md
|
||||
reference/
|
||||
...
|
||||
examples/
|
||||
...
|
||||
scripts/
|
||||
...
|
||||
|
||||
现在开始。源文档路径由我通过参数传入：$ARGUMENTS
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -13,4 +13,7 @@
|
||||
- 语言专业化： 使用业界标准的术语和概念来描述架构组件、数据流和设计决策。
|
||||
|
||||
|
||||
请你遵守前端项目的风格vue3-typescript-stye.md，针对mask_binance_account.md的初始设计文稿，给出专业性的优化设计，回答内容必须是中文
|
||||
请你遵守前端项目的风格vue3-typescript-stye.md，针对mask_binance_account.md的初始设计文稿，给出专业性的优化设计，回答内容必须是中文
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user