pdlc-add-service

添加新的微服务

SKILL.md

GitHub

添加新的微服务

<!-- @include templates/prompts/iron-law-tool.md(已内联于下方,无需另读) -->

⛔ IRON LAW · 不可违反的硬门禁(工具型命令)

本命令不是主链路上的阶段:不追加 history,不改 current_stage / next_step / last_phase_result,也不为此分配功能ID。以下规则不可协商:

  1. 文件必须落盘:正文要求创建的文件必须作为实际文件写入磁盘,不可仅在对话中输出(只要求在对话里输出的,照正文办)。
  2. 自检必须执行:产出后按本命令的自检项逐项核对,不得以"已经很好了"为由跳过。
  3. 防循环:修复只做一次,不递归。修不了的问题记进报告,继续往下走。

违反任一条 = 立即中止当前命令,输出违规详情,等待人工介入。

<!-- @include-end templates/prompts/iron-law-tool.md -->

在项目中添加一个新的后端微服务,并生成完整的目录结构和初始文档。

<!-- @include templates/prompts/layout-detect.md(已内联于下方,无需另读) -->

先探测项目布局(不要套用写死的目录)

下文出现的 backend/services/、frontend/web/ 等路径只是空项目时的默认布局。动手创建或扫描目录之前,先看项目实际长什么样:

  1. monorepo 标志:pnpm-workspace.yaml、turbo.json、nx.json、lerna.json、package.json 的 workspaces、 go.work、Cargo.toml 的 [workspace]、settings.gradle(.kts) 的 include → 按其中声明的目录(如 apps/、packages/、services/、crates/)理解布局
  2. 已有单元的位置:在 backend/services/、services/、apps/、packages/、cmd/、crates/ 下找已存在的服务 / 应用,新单元放在同级,命名与目录结构照着已有的来
  3. 单体与全栈框架:只有一个 src/,或是框架默认结构(manage.py + 各 app、Rails 的 app/、Next.js 的 app/ / pages/、Spring Boot 单模块)→ 按框架约定放,不要新建 services/ 一类平行目录
  4. 空项目或判断不了 → 才用下文的默认布局;执行前把将要创建的路径列给用户确认(--autonomous 下记入 auto_decisions[])

把探测结论写进本次报告:布局类型 + 依据的文件 + 新内容的落点。判断错了的代价是在用户仓库里长出一套平行目录,比多问一句贵得多。

<!-- @include-end templates/prompts/layout-detect.md -->

工作流程

  1. 项目有 Makefile 且含创建服务的 target 时用它;否则直接在 backend/services/ 下创建服务目录
  2. 根据技术栈生成标准目录结构
  3. 创建服务的 README.md、CHANGELOG.md
  4. 在 backend/services/<服务名>/docs/ 下创建 api-design.md 初始文档
  5. 更新项目 CLAUDE.md 中的服务列表(如需要)

支持的技术栈

  • java/spring: Maven + Spring Boot 标准结构
  • go: Go 标准项目布局(cmd/internal/pkg)
  • python: FastAPI/Flask 项目结构
  • node: Express/NestJS 项目结构

要求

<!-- @include templates/prompts/output-language.md(已内联于下方,无需另读) -->

🌐 Output language for generated artifacts

All generated artifacts (PRDs, design docs, code comments, review reports, test plans, deployment manuals, changelog entries, etc.) follow this policy:

  1. Default — match the conversation language exactly:

    • 用户用中文与 Claude 对话 → 产中文文档、中文代码注释、中文报告
    • User talks to Claude in English → produce English artifacts
    • User talks in another language → produce artifacts in that language
    • Never silently default to a fixed language regardless of the user's input.
  2. Explicit override always wins: when the user specifies a language for an artifact (e.g. "write the PRD in English", "用英文写 API 设计文档", "output the deploy doc in Japanese"), use that language for that artifact, regardless of conversation language.

  3. Mixed-language requirements: if the user wants some artifacts in one language and others in a different language (common: Chinese PRD + English API docs for partners), honour each per-artifact instruction.

  4. Uncertain: if you cannot reliably detect the conversation language, ask once before producing the first artifact.

This policy applies to content (prose, comments, headings). It does not override technical conventions like English variable names, English git commit subjects, or English error codes when the project's conventions require them.

<!-- @include-end templates/prompts/output-language.md -->
  • 服务名使用小写英文 + 连字符(如 user-service)
  • 创建完成后提示用户下一步编写 API 设计文档

$ARGUMENTS

<!-- @include templates/prompts/handoff.md(已内联于下方,无需另读) -->

段四:交接(Handoff)

命令完成后必须输出以下格式的最终消息:

✅ <阶段名> 完成:<主要产出物路径>
📊 自检:<通过数>/<总数> 通过(若有未通过,附要点)
📦 状态快照:docs/.pdlc-state/<feature-id>.json
👉 下一步:/pdlc-<next_step>
   (如果有分叉)或 /pdlc-<alt>(条件:<选择依据>)

规则:

  • 主流程命令(写状态机的命令;下一跳见正文里「本命令的状态机取值」)必须显式输出"下一步",不可省略
  • 工具型命令(Layer 3)可以没有 next_step,此时输出 👉 下一步:(本次流程结束,无后续)
  • 分叉场景必须说明选择条件,例如"若需补充测试用例 → /pdlc-tdd;若测试已齐 → /pdlc-review"<!-- @include-end templates/prompts/handoff.md -->

本命令的 handoff 输出:

✅ 新微服务 完成
📦 产出:backend/services/<service-name>/
👉 下一步:(本次流程结束,无后续)