Project Patch Template

项目级补丁模板（填空即用）

> 这是一份空白模板。Praxis 的用户级 skill 是"通用引擎"，项目独有的路径、域、死亡线、审查人等不写进引擎，而是由每个项目自己的补丁 skill声明。本模板把引擎暴露的所有挂载点收在一处，你照着填即可。

怎么用这份模板

1. 把本目录复制到你项目仓库的 .claude/skills/-patch/
2. 把 frontmatter 的 name 改成 -patch，description 写清它服务哪些引擎 skill
3. 逐节填下面的「填空区」——没有的项就显式写「本项目不适用」，不要留空（留空会让引擎以为你忘了声明）
4. 填完后，引擎 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/ 下的真实目录名一致
• [ ] 本补丁不含任何密钥 / 凭证（凭证归项目级配置，不进文档补丁）

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: BackToCimaCoppi
• Source: BackToCimaCoppi/Praxis
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.