Agent Skills
返回列表
PACP 业务规格协调器

PACP 业务规格协调器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 生成前后端代码,并依赖全局验证报告确认编译与运行时无报错。

适合人员

  • 全栈工程师:需要将复杂原型与需求转化为可执行的前后端代码,且要保证字段与组件不偏离原型设计。
  • 架构师:需要统一团队的数据模型与命名规范,管控多批次需求迭代的规格一致性与跨会话恢复。
  • 业务分析师:需要将非结构化的原型截图和文档转化为结构化的模块规格,确保需求字段无遗漏并可追溯。