pdlc-arch SKILL.md skillA

pdlc-arch from kanfu-panda/pdlc-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kanfu-panda/pdlc-skills/pdlc-arch@git:20261012.035af0d

Pins git:20261012.035af0d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kanfu-panda/pdlc-skills
Path
skills/pdlc-arch/SKILL.md
Versions recorded
6
Latest version
git:20261012.035af0d, committed Oct 12, 2026
First version recorded
May 7, 2026
Size
8,231 bytes
Repository stars
18
License
MIT

架构分析(生成/更新 docs/ARCHITECTURE.md 系统架构总览 · surface 型).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 架构分析

<!-- @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 -->

对当前项目架构进行全面分析,输出架构评估报告。

## 分析维度

### 1. 服务拆分合理性
- 各微服务的职责边界是否清晰
- 是否存在循环依赖
- 服务粒度是否合适(过大/过小)
- 数据归属是否明确

### 2. 通信机制
- 服务间通信方式(同步REST/gRPC、异步消息队列)
- 是否存在分布式事务问题
- 接口版本管理策略
- 错误传播和容错机制

### 3. 数据架构
- 数据库拆分策略(每服务独立数据库 vs 共享)
- 数据一致性方案
- 缓存策略
- 数据备份与恢复

### 4. 可观测性
- 日志规范(结构化日志、链路追踪ID)
- 监控指标(RED指标:Rate/Errors/Duration)
- 告警策略
- 分布式追踪

### 5. 可扩展性
- 水平扩展能力
- 负载均衡策略
- 容量规划

<!-- @include templates/prompts/layout-detect.md(已内联于下方,无需另读) -->
## 先探测项目布局(不要套用写死的目录)

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

1. **monorepo 标志**:`pnpm-workspace.yaml`、`turbo.json`、`nx.json`、`lerna.json`、`package.json` 的 `workspaces`、
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanfu-panda/pdlc-skills/pdlc-arch@sha256:587abf42de696263

The line at the top of this page pins the label git:20261012.035af0d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jywhqr75lxp4ehqv.svg)](https://markdownregistry.com/a/art_jywhqr75lxp4ehqv)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between May 7, 2026 and Oct 12, 2026, about one every 32 days.

versioncommittedcommitsizeaudit
git:20261012.035af0d latest2026-10-12 035af0d 8,231 BA view · diff
git:20261008.f5462072026-10-08 f546207 8,229 BA view · diff
git:20261008.72fb7f72026-10-08 72fb7f7 8,676 BA view · diff
git:20260923.6b876962026-09-23 6b87696 7,154 BA view · diff
git:20260606.4b10e8d2026-06-06 4b10e8d 3,411 BA view · diff
git:20260507.ba956b72026-05-07 ba956b7 2,318 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8231 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kanfu-panda/pdlc-skills · 18 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jywhqr75lxp4ehqv
GET https://markdownregistry.com/api/v1/resolve?ref=kanfu-panda/pdlc-skills/pdlc-arch
GET https://markdownregistry.com/api/v1/blob/587abf42de696263f4ebb3d80de620b05bad7838816e81c0942dcaa777b0e93f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kanfu-panda/pdlc-skills

CLAUDE.md CLAUDE.md file
kanfu-panda/pdlc-skills · CLAUDE.md
git:20261013.ef05bf2 · audit A · 18 stars
pdlc-add-app SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-add-app/SKILL.md · 在已有项目里加一个前端应用(先探测布局,跟随现有目录与技术栈);新项目一次性初始化用 /pdlc-bootstrap
git:20261012.035af0d · audit A · 18 stars
pdlc-add-service SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-add-service/SKILL.md · 在已有项目里加一个后端服务(先探测布局,跟随现有目录与技术栈);新项目一次性初始化用 /pdlc-bootstrap
git:20261012.035af0d · audit A · 18 stars
pdlc-adopt SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-adopt/SKILL.md · 已有代码、还没有 PDLC 文档的老项目接入——只读扫描后逆向生成基线文档并做健康检查,不改代码;空目录新项目用 /pdlc-bootstrap
git:20261012.035af0d · audit A · 18 stars
pdlc-api-mock SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-api-mock/SKILL.md · 按 API 设计文档生成 Mock 数据与 Mock 服务配置,供前端联调
git:20261012.035af0d · audit A · 18 stars
pdlc-bootstrap SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-bootstrap/SKILL.md · 空目录从一句话描述初始化新项目(服务 / 应用拆分、技术栈、目录骨架与 PDLC 文档目录);已有代码的项目用 /pdlc-adopt
git:20261012.035af0d · audit A · 18 stars
pdlc-changelog SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-changelog/SKILL.md · 未发版时按 git 记录手动刷新 CHANGELOG 的 [未发布] 段;正式发版由 /pdlc-ship 一并处理
git:20261012.035af0d · audit A · 18 stars
pdlc-code-gen SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-code-gen/SKILL.md · 在已有服务 / 应用里按设计文档生成模块代码骨架(分层、接口、模型);加新服务用 /pdlc-add-service
git:20261012.035af0d · audit A · 18 stars
pdlc-db-design SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-db-design/SKILL.md · 按 PRD 设计数据库表结构、索引与 ER 图,产出 docs/02_design/database/ 设计文档;生成迁移脚本用 /pdlc-db-migrate
git:20261012.035af0d · audit A · 18 stars
pdlc-db-migrate SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-db-migrate/SKILL.md · 按数据库设计生成与管理迁移脚本(先沿用项目已有的迁移工具),不直接连库执行 SQL
git:20261012.035af0d · audit A · 18 stars
pdlc-deploy SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-deploy/SKILL.md · 按已评审的功能或发布版本写部署手册(docs/05_deployment/guides/),不执行真实部署;要发布版本先用 /pdlc-ship
git:20261012.48d119f · audit A · 18 stars
pdlc-design SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-design/SKILL.md · 创建技术设计文档(自动生成 + 自检 + handoff)
git:20261012.18be267 · audit A · 18 stars

Every file in kanfu-panda/pdlc-skills

Browse by kind, by grade A, or by owner.