Home / kanfu-panda / pdlc-skills · GitHub

pdlc-status SKILL.md skillA

pdlc-status 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-status@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-status/SKILL.md
Versions recorded
10
Latest version
git:20261012.035af0d, committed Oct 12, 2026
First version recorded
May 7, 2026
Size
12,680 bytes
Repository stars
18
License
MIT

查看项目 PDLC 状态总览（读 docs/.pdlc-state/ 输出进度）.

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/` 目录下所有状态机文件，输出项目当前的 PDLC 进度、阶段分布、待办建议。

<!-- @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 的规则逐条人工核对，
体检块首行注明「体检脚本不可用，以下为人工核对」。

### 2. 体检规则（偏差代码）

读侧跳过 `_` 前缀的索引文件（如 `_relations.json`）与 `statusline.json`，它们不是功能状态机。

<!-- finding-codes:start -->
| 代码 | 判定 | 读侧怎么处理 |
|---|---|---|
| `json-invalid` | 文件不是合法 JSON | 跳过该文件，列入体检块 |
| `missing-field` | 缺 `feature_id` / `current_stage` / `history` / `next_step` / `created_at` 之一 | 用到该字段的指标，对这份文件记「不可判」 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanfu-panda/pdlc-skills/pdlc-status@sha256:2ad96861922515c1

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_ektxwfjvzll4fpvs.svg)](https://markdownregistry.com/a/art_ektxwfjvzll4fpvs)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261012.035af0d latest2026-10-12 035af0d 12,680 BA view · diff
git:20261008.ba3006e2026-10-08 ba3006e 12,678 BA view · diff
git:20261007.7eb3b9d2026-10-07 7eb3b9d 11,931 BA view · diff
git:20260923.1207e762026-09-23 1207e76 11,612 BA view · diff
git:20260923.3cd2f022026-09-23 3cd2f02 10,384 BA view · diff
git:20260923.6b876962026-09-23 6b87696 10,210 BA view · diff
git:20260911.c7dfbe72026-09-11 c7dfbe7 3,204 BA view · diff
git:20260718.42454d52026-07-18 42454d5 2,571 BA view · diff
git:20260606.4b10e8d2026-06-06 4b10e8d 2,535 BA view · diff
git:20260507.ba956b72026-05-07 ba956b7 1,809 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 (12680 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_ektxwfjvzll4fpvs
GET https://markdownregistry.com/api/v1/resolve?ref=kanfu-panda/pdlc-skills/pdlc-status
GET https://markdownregistry.com/api/v1/blob/2ad96861922515c133defc9be847e00ec17c0c3f43acc475d1b29ae4ae10ceae

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

Other files named pdlc-status

pdlc-status SKILL.md skill
tomzx/agents · skills/pdlc/skills/pdlc-status/SKILL.md · Display a progress dashboard for product initiatives from .pdlc/ directory data, without modifying any artifacts.
git:20261007.b35fc4b · audit A · 16 stars

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