项目级补丁模板
给「AI 驱动开发」立规矩的 Claude Code skill 方法论库：七层文档治理 · 对抗评审 · 任务总控三驾马车，外加老代码考古、施工蓝图等共 16 个 skill —— 让 AI 写代码又快又不失控。
npx -y skills add BackToCimaCoppi/Praxis --skill 项目级补丁模板Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
【模板·复制后改名】项目级补丁 skill 模板。Praxis 里的用户级 skill（doc-layer-system / construction-blueprint / lightweight-design / docs-from-code 等）只含通用引擎与"留白挂载点"，不硬编码任何项目特定值。本模板把所有挂载点列成填空区——复制到你项目的 .claude/skills/ 下、改名为 <你的项目>-patch、逐项填上你项目的真实值，引擎即可挂载运行。触发词：由你按需声明。
SKILL.md
6.4 KB, as published. Nobody here has run it
项目级补丁模板（填空即用）
这是一份空白模板。Praxis 的用户级 skill 是"通用引擎"，项目独有的路径、域、死亡线、审查人等不写进引擎，而是由每个项目自己的补丁 skill声明。本模板把引擎暴露的所有挂载点收在一处，你照着填即可。
怎么用这份模板
- 把本目录复制到你项目仓库的
.claude/skills/<你的项目>-patch/ - 把 frontmatter 的
name改成<你的项目>-patch，description写清它服务哪些引擎 skill - 逐节填下面的「填空区」——没有的项就显式写「本项目不适用」，不要留空（留空会让引擎以为你忘了声明）
- 填完后，引擎 skill（如 doc-layer-system）运行时会读取本补丁，把通用规则叠加上你项目的特例
下文每个
〔填空〕都给了一个中性示例仅作格式参考，务必替换成你项目的真实值。
1. 项目形态（doc-layer-system）
声明本项目的文档分层形态，引擎据此裁剪可选层（L2 前端交互、L5 端到端流程可省略）。
项目形态：〔填空〕 # 示例：纯后端服务（省略 L2、L5）／ 全栈（七层齐全）／ CLI 工具
2. 业务域 / 功能模块列表（doc-layer-system）
声明本项目的域划分，引擎按域组织文档与拆分。
域列表：〔填空〕 # 示例：账户域、订单域、营销域、结算域
3. 目录路径（doc-layer-system）
引擎不知道你的文档放哪，这里钉死。
| 挂载点 | 你的值（示例） |
|---|---|
文档根目录 docs_root | 〔填空〕 示例：docs/ |
| 运行资产归属路径 | 〔填空〕 示例：docs/06-运行资产/ |
| 任务总控目录 | 〔填空〕 示例：docs/00-任务总控/ |
4. 单文档行数软上限（doc-layer-system / long-doc-governance）
超过即触发 long-doc-governance 拆分流程。
单文档行数软上限：〔填空〕 # 示例：800 行（不声明则默认 ≤800）
5. 死亡线区域清单（doc-layer-system，最高优先级）
引擎已内置通用兜底死亡线（鉴权 / 支付 / 用户数据删除 / 权限校验等），无需你声明即生效。 本节是在兜底之上叠加你项目特有的死亡线区域，只能加不能减。
| 死亡线区域 | 代码位置（示例） | 审查要点（示例） |
|---|---|---|
| 〔填空〕 | 〔填空〕 | 〔填空〕 |
| 示例：积分计算 | 示例：score/CalcService | 示例：倍率与封顶规则不得 AI 自改 |
6. 死亡线审查人绑定（doc-layer-system）
死亡线区域的任何变更必须由真人审查，这里把"能力要求"绑定到具体角色/岗位。
| 能力 | 审查人/岗位（示例） | 缺失时的降级方案（示例） |
|---|---|---|
| 〔填空〕 | 〔填空〕 | 〔填空〕 |
| 示例：L4 数据模型主审 | 示例：后端负责人 | 示例：由架构师兼任 |
7. 金标准领域清单（doc-layer-system L7）
声明本项目必须有金标准测试用例覆盖的核心领域。
金标准领域：〔填空〕 # 示例：核心算法、积分、等级、结算金额
8. L3 接口规范（doc-layer-system §L3 挂载点）
HTTP 方法约束：〔填空〕 # 示例：仅 GET / POST
参数规范：〔填空〕 # 示例：POST 参数放 body
翻页规则：〔填空〕 # 示例：游标分页
响应包装格式：〔填空〕 # 示例：统一 { code, msg, data }
鉴权方案：〔填空〕 # 示例：JWT Bearer
9. L4 数据规范（doc-layer-system §L4 挂载点）
ID 生成策略：〔填空〕 # 示例：Snowflake
必填公共字段：〔填空〕 # 示例：create_time、update_time
ORM 映射规范：〔填空〕 # 示例：下划线转驼峰
跨域引用约束：〔填空〕 # 示例：禁止跨域外键，只存 ID
10. 测试用例 ID 与命名规范（doc-layer-system L7）
测试用例 ID 格式：〔填空〕 # 示例：TC-<域>-<编号>，CI 可解析
测试用例命名规范：〔填空〕 # 示例：<域>_<场景>_<预期>
11. 协作 skill 名称映射（doc-layer-system §协作表）
引擎只描述"需要哪类协作 skill"，具体 skill 名由你声明。
| 引擎期望的协作类型 | 你项目里的 skill 名（示例） |
|---|---|
| 文档编写指南 | 〔填空〕 示例：docs-writing-guide |
| 接口/后端构件 | 〔填空〕 示例：create-api-endpoint |
| 数据库构件 | 〔填空〕 示例：create-db-table |
| 数据库探查 | 〔填空〕 示例：inspect-db-schema |
| 测试与金标准 | 〔填空〕 示例：test-and-goldens |
12. 文档头元数据注入脚本（doc-layer-system，可选）
推断脚本：〔填空 / 本项目不适用〕 # 示例：scripts/inject-doc-meta.sh（从 Git 元数据注入文档头）
13. construction-blueprint 挂载点
分层方向 / 域边界 / 工程红线清单：〔填空〕 # 施工蓝图自检时逐条打勾的项目红线
评审强度升级条件：〔填空〕 # 示例：触碰死亡线 / 跨 3 个以上域 → 升到强档
14. lightweight-design 挂载点
本项目轻量设计需引用的补丁项：〔填空〕 # 示例：复用本补丁 §3 路径、§5 死亡线清单
填写自检（提交补丁前逐条打勾）
- 每个
〔填空〕都已替换为真实值，或显式写「本项目不适用」 - 死亡线清单只在通用兜底之上叠加，未删减兜底项
- 死亡线审查人是真人角色，没有写「AI 自审」
- 协作 skill 名与你项目
.claude/skills/下的真实目录名一致 - 本补丁不含任何密钥 / 凭证（凭证归项目级配置，不进文档补丁）