| name | project-patch-template |
| description | 【模板·复制后改名】项目级补丁 skill 模板。Praxis 里的用户级 skill（doc-layer-system / construction-blueprint / lightweight-design / docs-from-code 等）只含通用引擎与"留白挂载点"，不硬编码任何项目特定值。本模板把所有挂载点列成填空区——复制到你项目的 .claude/skills/ 下、改名为 <你的项目>-patch、逐项填上你项目的真实值，引擎即可挂载运行。触发词：由你按需声明。 |
项目级补丁模板（填空即用）
这是一份空白模板。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 死亡线清单
填写自检（提交补丁前逐条打勾）
