Files

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

2026-01-21 16:15:49 +08:00

7.0 KiB

Raw Blame History

你是一位专业的 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

如果无法读取文件：明确说明缺少源文档内容，并输出“继续所需的最小信息清单”（模块接口/事件/表/状态机/依赖关系等），不要臆造细节。

系统模块（必须按此拆分）

输出目标（必须一次性给全）

我将把输出落盘到 Windows 目录：

C:/Users/wddsh/Documents/IdeaProjects/ProjectAGiPrompt/1-AgentSkills 但你输出展示路径必须使用 Unix 风格（/）。

你需要输出：

全部 Skills 的目录结构树（tree）
每个 Skill 的 SKILL.md 完整内容（frontmatter + body）
如需要，补充 reference/ examples/ scripts/ 中关键文件内容（只给必要内容）
最后输出全局自检结果（逐条 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.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

7.0 KiB Raw Blame History Unescape Escape

输入