project-patch-templatelisted
Install: claude install-skill BackToCimaCoppi/Praxis
# 项目级补丁模板(填空即用)
> 这是一份**空白模板**。Praxis 的用户级 skill 是"通用引擎",项目独有的路径、域、死亡线、审查人等不写进引擎,而是由**每个项目自己的补丁 skill**声明。本模板把引擎暴露的所有挂载点收在一处,你照着填即可。
## 怎么用这份模板
1. 把本目录复制到你项目仓库的 `.claude/skills/<你的项目>-patch/`
2. 把 frontmatter 的 `name` 改成 `<你的项目>-patch`,`description` 写清它服务哪些引擎 skill
3. 逐节填下面的「填空区」——**没有的项就显式写「本项目不适用」**,不要留空(留空会让引擎以为你忘了声明)
4. 填完后,引擎 skill(如 doc-layer-system)运行时会读取本补丁,把通用规则叠加上你项目的特例
> 下文每个 `〔填空〕` 都给了一个**中性示例**仅作格式参考,务必替换成你项目的真实值。
---
## 0. 治理模式、授权角色与环境占用策略(全流程通用)
Praxis 不默认“任务发起人 = 业务裁决人 = 环境所有者 = 发布授权人 = 候选验收人”。个人项目可以由一人兼任全部角色;团队或受监管项目应按实际职责拆开,并声明是否要求职责分离。
| 挂载点 | 你的值(示例) |
|--------|--------------|
| 协作模式 | 〔填空〕 示例:单一负责人 / 多角色团队 / 受监管团队 |
| 任务发起人 | 〔填空〕 示例:需求负责人 |
| 业务决策负责人 | 〔填空〕 示例:产品 Owner |
| 环境所有者 | 〔填空〕 示例:测试环境管理员 |
| 发布授权人 | 〔填空〕 示例:值班发布负责人 |
| 候选验收人 | 〔填空〕 示例:未参与施工的技术负责人 |
| 职责分离要求 | 〔填空〕 示例:生产发布人与候选验收人不得是同一人 / 本项目不要求分离 |
未声明角色时,**不得**推定任务发起人自动拥有业务裁决、环境抢占、生产发布或最终验收权限。一个人兼任多角色也必须由项目治理规则明确,而不是由执行体猜测。
如项目存在共享环境、部署账本、租约或占用登记,再填写:
| 环境 | 占用机制 | 有效期 / 失效判据 | 可抢占角色 | 冲突处置 | 登记位置 |
|------|----------|------------------|------------|----------|----------|
| 〔填空〕 | 〔填空〕 | 〔填空〕 | 〔填空〕 | 〔填空〕 | 〔填空〕 |
| 示例:集成测试环境 | 示例:带 TTL 的租约 | 示例:到期或原持有人释放 | 示例:环境所有者 | 示例:等待 / 换隔离环境 / 明确授权后抢��� | 示例:运行资产中的部署账本 |
没有声明失效判据或抢占权限时,执行体不得仅因新任务启动就把现有占用判为过期;应优先使用隔离环境,无法继续则交付可恢复的操作性阻塞断点。环境配置、账号和凭据仍放项目受控配置中,不写进本补丁。
## 1. 项目形态(doc-layer-system)
声明本项目的文档分层形态,引擎据此裁剪可选层(L2 前端交互、L5 端到端流程可省略)。
```
项目形态:〔填空〕 # 示例:纯后端服务(省略 L2、L5)/ 全栈(七层齐全)/ CLI 工具
```
## 2. 业务域 / 功能模块列表(doc-layer-system