pdlc-standard

Solid

管理 00_standards 规范型 surface 产物(add/edit/archive/index)

AI & Automation 10 stars 2 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
35
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
90
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# 规范文档管理(surface 型) <!-- @include templates/prompts/iron-law.md --> 管理 `docs/00_standards/` 下的团队规范(编码约定 / API 约定 / 命名规则等)。这类产物是 **surface 型**——描述"当前规范是什么"的状态快照,**就地编辑**而非 ledger 累积。 ## ⛔ surface 铁律(不���违反) 1. **不允许版��化文件名**:禁止 `coding-style-v2.md` / `coding-style-2026-Q1.md` 这类 ledger 绕路。一个主题永远一个文件,就地改。 2. **就地编辑 + `_changelog.md`**:每次修改在同目录 `_changelog.md` 追加一条(日期 / 命令 / 变更摘要)。 3. **git log 是真实审计链**:演进历史靠 `git log <file>` 看,不靠多份文件。 4. **归档不删除**:废弃的规范用 `archive` 子命令移到 `docs/.archive/standards/`(与 `/pdlc-arch` 共用统一 archive 根 `docs/.archive/`),留 stub 指向新位置。 ## 段一:执行子命令 从 `$ARGUMENTS` 解析: ### `add <category>/<name>` 新建规范。`category` 如 `coding` / `api` / `naming`。 1. 在 `docs/00_standards/<category>/<name>.md` 创建(**确认不存在同名 v2 变体**) 2. 文件顶部加 `<!-- artifact_type: surface -->` 标记 3. 同目录 `_changelog.md` 追加创建记录 4. 更新 `docs/00_standards/_index.md` ### `edit <path> <change>` 就地编辑已有规范。改完在 `_changelog.md` 追加变更摘要。**禁止**另存为新版本文件。 ### `archive <path>` 移到 `docs/.archive/standards/`,原位置留 stub(一行指向新位置 + 废弃原因)。 ### `index` 扫描 `docs/00_standards/**`,重新生成 `_index.md`(按 category 分组列出所有规范 + 一句话摘要)。 ## 段二:自检(强制) <!-- @include templates/prompts/self-audit.md --> ### 规范管理自检清单 - [ ] 无版本化文件名泄漏(`*-v[0-9]` / `*-20[0-9][0-9]*` 模式不存在) - [ ] 本次涉及的 `_changelog.md` 已追加记录 - [ ] 新建/修改的规范文件含 `artifact_type: surface` 头标记 - [ ] `_index.md` 与实际文件一致(无遗漏 / 无悬空条目) ## 段三:修复(单次,不递归) <!-- @include templates/prompts/loop-prevention.md --> - 可自动修复(漏更 `_changelog.md` / `_index.md` 不一致)→ 直接补 - 发现版本化文件名 → 提示用户合并到...

Details

Author
kanfu-panda
Repository
kanfu-panda/pdlc-skills
Created
3 months ago
Last Updated
1 weeks ago
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

DevOps & Infrastructure Listed

06-

部署和运维规范 + 发布记录铁律。Use when: 项目上线 / 发布 / 部署 / 回滚 / CI-CD 配置 / 环境变量管理时触发;部署后必须写发布记录 (CHANGELOG + docs/releases/,跑 ./scripts/record-release.sh)。包含各平台部署流程(Vercel/Cloudflare/Docker/小程序)+ env 管理 + 部署前后检查清单 + 踩坑记录(详见 body)。SKIP: 监控接入·告警系统设计 → 12 / 安全设计规范 → 04 / 定期体检·审计 → 13 / 发布前 Go-No-Go 决策 → 22 / 项目部署地址·档案查询(非部署动作) → 08 / 对外开源 publish 发布 → 16。

2 Updated 2 weeks ago
xcodethink
Code & Development Listed

01-

通用开发规范细则手册(按需查阅,非常驻铁律,18 项细则各有独立子文档)。Use when: 新功能开发启动、技术选型 / AI 模型选型 (Tier 分级 / Fallback 链 / 成本估算)、API 设计、代码迁移和重写、垂直切片规划、产品思维分析时触发。18 细则:代码完整性 / 产品思维 / 一次做到位 / 自验证 / API 健壮性 / 版本管理 / 错误处理 / 依赖管理 / 回滚应急 / 代码 / 数据库 / 安全 / 国际化等(详见 body)。SKIP: 通用铁律(代码完整性 / 不能私自降级 / 问题分析 / Git 回滚 / 硬刹车)已在 CLAUDE.md 常驻,不需触发本 skill 也默认套用。

2 Updated 2 weeks ago
xcodethink
AI & Automation Listed

doc-compact

文档整理与压缩。核心职责是在不丢行为信息的前提下压缩冗余文档——删复述、删死链、删历史沿革、收敛重复提醒;配套完成结构整理(纠正文档放置、重建根 AGENTS.md 索引、补 inline 指针、规范 CLAUDE.md 为单行 @*.md、判定并拆分过大项目的二级索引)和全局文档管理规范的检查/安装。当文档冗余膨胀、索引失效、AGENTS.md 膨胀、CLAUDE.md 混入杂质,或需要确认全局规范是否写清文档管理模式时使用。

1 Updated today
x0c