pdlc-retro SKILL.md skillA

pdlc-retro 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-retro@git:20261012.c93411b

Pins git:20261012.c93411b 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-retro/SKILL.md
Versions recorded
9
Latest version
git:20261012.c93411b, committed Oct 12, 2026
First version recorded
May 7, 2026
Size
17,394 bytes
Repository stars
18
License
MIT

迭代复盘——读状态机历史出趋势报告.

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

# PDLC 迭代复盘

读取 `docs/.pdlc-state/` 下的状态机历史,按时间范围聚合,生成趋势复盘报告。

<!-- @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/state-read.md(已内联于下方,无需另读) -->
## 读状态机之前:先做契约体检

`docs/.pdlc-state/*.json` 不一定都是 `/pdlc-*` 命令写出来的——手写的、旧版本写的、照着格式仿写的
都可能混在里面。字段对不上契约时,**不许边猜边算、再把猜出来的东西当结论**。先体检,再计算;
体检发现的每一处偏差,都必须出现在输出的**最前面**。

### 1. 跑体检

体检脚本随本 skill 一起分发,就在本 skill 目录下:`scripts/pdlc-state-lint.sh`(运行时会告知本 skill 的
所在目录)。它与正在运行的 skill 同一版本,体检规则——合法阶段名、偏差代码——与下方 §2 一致。

在项目根执行 `bash <本 skill 目录>/scripts/pdlc-state-lint.sh .`。stdout 每行一条偏差:`文件<TAB>代码<TAB>说明`。退出码三态:

- `0` 已体检、全部合契约 → 照常出结论,不输出体检块
- `1` 已体检、有偏差 → 照常计算,但输出最前面必须先放「输入契约体检」块(见 §3)
- `2` 无法体检(缺 jq / 无状态目录)→ 体检块写「无法体检:<原因>」,**不得当成合契约**

体检脚本不可用时(找不到,或当前平台没有随 skill 分发它),按 §2 的规则逐条人工核对,
体检块首行注明「体检脚本不可用,以下为人工核对」。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanfu-panda/pdlc-skills/pdlc-retro@sha256:dc1b2c284189e521

The line at the top of this page pins the label git:20261012.c93411b, 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_ryxhgpo44ne4y7ba.svg)](https://markdownregistry.com/a/art_ryxhgpo44ne4y7ba)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261012.c93411b latest2026-10-12 c93411b 17,394 BA view · diff
git:20261012.035af0d2026-10-12 035af0d 16,141 BA view · diff
git:20261008.f5462072026-10-08 f546207 16,139 BA view · diff
git:20261008.ba3006e2026-10-08 ba3006e 16,586 BA view · diff
git:20261007.7eb3b9d2026-10-07 7eb3b9d 15,839 BA view · diff
git:20260923.3cd2f022026-09-23 3cd2f02 15,520 BA view · diff
git:20260923.6b876962026-09-23 6b87696 15,347 BA view · diff
git:20260911.c7dfbe72026-09-11 c7dfbe7 4,720 BA view · diff
git:20260507.ba956b72026-05-07 ba956b7 3,034 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 (17394 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_ryxhgpo44ne4y7ba
GET https://markdownregistry.com/api/v1/resolve?ref=kanfu-panda/pdlc-skills/pdlc-retro
GET https://markdownregistry.com/api/v1/blob/dc1b2c284189e521cc80083fd5f1289b89807027b438e88d1a0da621de68c070

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-arch SKILL.md skill
kanfu-panda/pdlc-skills · skills/pdlc-arch/SKILL.md · 架构分析(生成/更新 docs/ARCHITECTURE.md 系统架构总览 · surface 型)
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

Every file in kanfu-panda/pdlc-skills

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