PACP 业务规格协调器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指南,安装 @user_aeb36e80/pacp-spec 技能。
技能介绍
解决什么问题
- 复杂业务的输入常包含需求文字、HTML 原型、截图、文档和现有工程,字段、组件、字典、外键、依赖分散,人工拼接规格容易漏字段、组件漂移、编号不一致。
pacp-spec是协调者,不复制规则,通过Skill(pacp-rules, args="")引用唯一规则,把需求解析成可追溯、可恢复的模块规格,再驱动子技能生成前后端代码并验证。
核心能力与关键步骤
- Step 1:检测
mvn/pnpm,按pom.xml/package.json定位项目根目录,识别原型类型与数据库,拆分业务和模块。 - Step 2-3:引用
pacp-rules完成实体识别、表名命名和外键设计。 - Step 4:原型解析四阶段。先用 Glob/Grep 建页面基线;逐页做区域打勾和字段级枚举,按搜索区、表格区、表单区、按钮栏、统计图表区、跳转链接计数 S/T/F/B/C/L;再发现跳转;最后做页数、区域完成度、字段总数三重对账。字段枚举必须由工具或图片 MCP 完成,不能凭印象。布局冻结按原型保留位置、顺序、分组和页面类型,组件选型按平台规范绑定。含
canvas且id带Chart时,追踪 JS 解析 ECharts/Chart.js 配置。 - Step 5:仅当
phaseDVerified=true才生成规格。产出shared-dicts.spec.md与每模块 10 章spec.md;字段规格表的关键列决定子技能行为。功能矩阵实现方式必须写具体交互;字段关系约束、功能字段映射角色、模块依赖双向表、实体录入页面均必填。生成后执行 12 项自动一致性检查,含代码集编号、BvIdGenerator 三处一致、specFieldCount >= prototypeFieldCount。 - Step 6:调用子技能分批生成代码,并做编译与运行时验证。
适用边界与注意点
- 规则唯一归属
pacp-rules,本技能只引用不维护副本;规则变更必须落在pacp-rules。 .pacp/生成在项目根目录,不同项目天然隔离;同项目多批次用{batch-id}、manifest.json、index.json恢复。temp/pacp-temp-*.spec.md是pacp-coding临时规格,与批次目录互不干扰,且不得删除批次目录内容。- 图片 MCP 不可用、HTML 异常、原型缺失或图表 JS 解析失败时,按文字补充、截图降级、占位符或 CHECKPOINT 处理,并记录到
notes。 - 原型与平台标准冲突时平台标准优先,但需 CHECKPOINT 确认;未明确事项标注待澄清。代码集、全局搜索布局、组件选型、编号定义仍需用户确认。
- 该技能不能替代业务边界判断,也不能绕过环境依赖;
mvn/pnpm不可用时应先补齐工具链或中止。
使用场景
- 拿到包含多个 HTML 原型与文档的复杂业务,需拆解模块并生成标准 .spec.md,通过字段级枚举和三重对账防遗漏。
- 跨会话开发中断后,需读取 .pacp/index.json 恢复特定批次进度,继续完成剩余模块的规格生成与代码验证。
- 面对含 ECharts 图表与复杂表单的原型,需提取字段、图表配置及跳转关系,严格按原型冻结布局并生成模块规格。
- 多模块业务需按外键依赖分批调用子 Agent 生成前后端代码,并依赖全局验证报告确认编译与运行时无报错。
适合人员
- 全栈工程师:需要将复杂原型与需求转化为可执行的前后端代码,且要保证字段与组件不偏离原型设计。
- 架构师:需要统一团队的数据模型与命名规范,管控多批次需求迭代的规格一致性与跨会话恢复。
- 业务分析师:需要将非结构化的原型截图和文档转化为结构化的模块规格,确保需求字段无遗漏并可追溯。