pacp-stylepack —— 风格包资产中心
> 风格包是「项目特有表单风格知识」的 md 资产。本 skill 是风格包的仓库、清单与规范中心——只管资产,不生成表单(生成归 pacp-build-form)。
>
> 设计依据:生成/管理/加载统一在一处(无迁移理解成本),预留未来经验记录逻辑。
定位与边界
| 做 | 不做 |
|---|---|
| 风格包仓库管理(存放、命名) | 表单生成(归 pacp-build-form) |
| 风格包清单维护(独立提供,避免扫描) | 字段绑定、组件属性推断 |
| 风格包结构规范定义 | 远程 API 调用 |
| 新增/维护风格包流程 | — |
| 未来:经验记录逻辑(自动归纳/校验) | — |
仓库结构
pacp-stylepack/
SKILL.md ← 本文档(规范 + 清单 + 流程)
pacp-stylepacks/ ← 风格包仓库
{业务域}-{范式}.md
命名规范
{业务域}-{范式}.md,风格名 = 文件名去 .md:
执法处罚-表格→ 类excel 网格范式执法处罚-文书→ 类word 公文范式
风格包清单(独立提供)
> pacp-build-form 读本清单定位风格包,不扫描目录。新增风格包必须更新此清单。
| 风格名 | 范式 | 适用业务域 | 文件 | 状态 |
|---|---|---|---|---|
| 执法处罚-表格 | 类excel 网格 | 行政处罚审批表/审查表(广西版) | pacp-stylepacks/执法处罚-表格.md | ✅ 已就绪 |
| 执法处罚-文书 | 类word 公文 | 行政处罚决定书/调查报告(山东版) | pacp-stylepacks/执法处罚-文书.md | ✅ 已迁入(类word激活待验证) |
风格包结构规范
一份风格包 md 应含以下章节(从实证表单归纳):
- frontmatter 自描述:风格名 / 范式 / 适用业务域 / 来源实证表单
- 核心范式特征:本风格的根本布局模式(类excel=网格 vs 类word=纵向流水)
- 组件用法:该范式用哪些组件、各自用途(TABLE_ELEMENT / CUSTOM_HTML / ...)
- 布局规则:网格/流水怎么搭(TABLE_JSON 结构、子元素挂载方式、行列合并)
- 公共样式骨架:全局 CSS + 标题 HTML
- 单元格/段落标题惯例:title-box 等手法
- 通用属性:CZAN / 主键 / 数据源 等约定
- 数据类型约定:字段精确类型(colspan 字符串、hide null/对象等)
新增风格包流程
- 找实证源:从已上线的、风格鲜明的表单
getFormConfig导出配置 - 归纳成 md:按上述结构规范写风格包 md
- 命名入仓:
{业务域}-{范式}.md放入pacp-stylepacks/ - 注册清单:更新本 SKILL.md 的「风格包清单」表
- frontmatter 自描述:风格包 md 顶部声明风格名 / 范式 / 适用域
与 pacp-build-form 的协作(模式B · 软依赖)
pacp-build-form 软依赖本 skill:
- pacp-build-form 收到风格名 → 在 available_skills 探测 pacp-stylepack
- 读本 SKILL.md 的「风格包清单」→ 按风格名定位文件
read pacp-stylepacks/{风格名}.md→ 应用约定生成
> pacp-stylepack 不在 available_skills 时,pacp-build-form 降级默认生成(向后兼容,零影响)。
>
> 主 agent 只负责激活 pacp-build-form,不搬运风格包内容(避免退化成手工注入)。
未来:经验记录逻辑(占位)
- 自动从表单使用经验归纳/更新风格包
- 风格包结构校验(对照实证源)
- 风格包版本管理
关联
- 设计方案:项目
pacp-stylepack设计方案.md - PoC 验证:
PoC结论.md(可消费)、PoC-B结论.md(可激活)