Skip to content

YuShenLiu06/PCHSystem / .claude/skills/service-claude-md

service-claude-md

Unverified

HTCMC PCHSystem 专用 skill——为各子服务目录生成与更新「分布式 CLAUDE.md」(提炼该服务的雷点、关键要素、文档索引)。当新建子服务、子服务架构发生变更、或需要补齐/更新某个服务的 CLAUDE.md 时使用。传入服务名(mcdr-plugin / user-service / project-service / scoring-service / title-service / wiki-service / alert-service / frontend),本 skill 自动读取对应架构文档,按统一模板生成或增量更新该服务目录下的 CLAUDE.md。在 PCHSystem 项目内,只要用户提到「子服务 CLAUDE.md」「为某服务生成/更新 CLAUDE.md」「补齐服务雷点」「服务记忆文件」,或正在新增/改动某个服务目录,就应使用本 skill——禁止手写子服务 CLAUDE.md。

FileKindSize
SKILL.mdskill md7.1 KB
templates/service-claude-md.template.mdmarkdown3.0 KB

templates/service-claude-md.template.md

View on GitHub
# {服务中文名} · 子服务 CLAUDE.md

> 本文件由 `service-claude-md` skill 生成 / 维护,**禁止手写**。
> 全局统一规范见根 [`CLAUDE.md`]({ROOT}/CLAUDE.md);本服务完整架构见架构文档。

<!--
  占位符约定(生成时由 service-claude-md skill 替换):
    {ROOT}        = 回到项目根的相对路径(顶层服务目录用 .. ;Backend/xxx_service/ 用 ../.. )
    {服务名}      = 形如 user-service / mcdr-plugin / frontend
    {架构文档路径} = Docs/architecture/services/{服务名}.md  或  Docs/architecture/frontend.md
    {schema}      = 该服务所属的数据 schema(如 scoring / projects / titles)
-->

---

## 1. 服务定位

{一句话说明该服务的职责与在三端架构中的位置。
 例:scoring-service 是后端积分引擎,负责材料提交入库、放置贡献记录、黄皮子积分计算与榜单更新。}

> 完整架构:[`{架构文档路径}`]({ROOT}/Docs/architecture/services/{服务名}.md)

---

## 2. 职责边界

| 管 | 不管 |
|---|---|
| {该服务负责的事 1} | {交给别的服务 / 端的事 1} |
| {该服务负责的事 2} | {交给别的服务 / 端的事 2} |

---

## 3. 雷点·红线(服务特有)

> 全局红线见根 CLAUDE.md §3(R-1~R-12)。此处只列**本服务特有**或对本服务**特别需要强调**的约束。

| # | 红线 | 说明 |
|---|---|---|
| **RS-1** | {服务特有约束} | {为什么 / 违反后果} |
| **RS-2** | {服务特有约束} | {为什么 / 违反后果} |

<!-- 对全局红线在本服务的具体化,用「遵守 R-x:…」写法,例如:
| **RS-3** | 遵守 R-3 清箱时序 | 本服务(MCDR)必须在 POST /submissions 返回成功后才执行 `data merge block {Items:[]}`;失败绝不清箱。 |
-->

---

## 4. 关键要素

### 核心实体 / 数据表
- `{表名}`({schema} schema):{一句说明}
- `{表名}`({schema} schema):{一句说明}

> 完整 DDL 与约束见 [`Docs/architecture/data-model.md`]({ROOT}/Docs/architecture/data-model.md)。

### 对外接口
| 接口 / 命令 | 说明 |
|---|---|
| {接口或游戏内命令} | {用途} |

### 依赖的其他服务
- **{服务名}**:{依赖关系 / 调用方向}

---

## 5. 文档索引

| 文档 | 路径 | 说明 |
|---|---|---|
| 本服务架构 | `{ROOT}/Docs/architecture/services/{服务名}.md` | 完整职责 / 接口 / 流程 |
| 数据模型 | `{ROOT}/Docs/architecture/data-model.md` | 相关表与约束 |
| 工程总览 | `{ROOT}/Docs/architecture.md` | 三端架构与跨服务流程 |
| 根规范 | `{ROOT}/CLAUDE.md` | 统一命名 / 红线 / 索引 |

---

## 6. 与根规范的关系

- 遵守根 [`CLAUDE.md`]({ROOT}/CLAUDE.md) 的命名分层(§1)与全局红线(§3 R-1~R-12)。
- 本文件的 RS-x 红线是**服务特有**补充,不覆写全局红线。
- 命名 / 全局红线 / 技术栈若有冲突,以根 CLAUDE.md 为准并修正本文件。

---

*最后更新:{YYYY-MM-DD}(由 service-claude-md skill 维护)*
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall