SuperAPI AI 工具集

peach-gen-spec

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:peach-gen-spec 是 Peach Harness 中的 Spec 生成技能,把新功能需求分析与 ui-proto 画面原型整理为单一 Spec 文件,作为实现基准的 Source of Truth。目标流程为 peach-team-ui-proto → peach-gen-spec proto=<ui-proto 태스크 경로> → peach-gen-db spec=<경로> → peach-team-dev spec=<경로> → peach-team-e2e spec=<경로> [proto=<경로>]。\n\n主要能力:判定 DB 类型(读取 api/src/environments/env.local.yml 的 DATABASE_URL,区分 PostgreSQL/MySQL 并映射类型);采集 ui-proto 的 _task-meta.ts、overview/pages/overview.vue、pages/.vue、mock/.mock.ts、store/.store.ts、type/.ts;确认功能范围、画面/动作基准、DB 模式、API 契约、TEST_ID 需求矩阵与验证等级、Backend TDD 基准、Store/Contract 基准、UI 实现基准、E2E 场景;在 §5.5 明确系统安全性(标识符策略、数据归属边界、禁止交叉匹配、回归风险标记);分 A/B 两段输出,Spec 目标篇幅 250~450 行。\n\n使用方式:/peach-gen-spec proto=<ui-proto 태스크 경로>(推荐);/peach-gen-spec proto=<경로> schema=<schema 或 DDL 경로>;/peach-gen-spec feature-docs=<기능별설명 폴더>;无参数时走自然语言/对话模式;用户要求「修改前讨论」时进入讨论/确认模式,不直接改文档。输出文件为 docs/spec/{年}/{月}/[개발자아이디]-[YYMMDD]-[한글기능명].md,开发者 ID 优先 whoami,失败则用 git config user.name。\n\n限制:不创建 PRD 追踪表与 4 轴状态矩阵;不生成 FK,引用完整性由应用处理;不写测试代码、selector、fixture、suite 内部实现;TDD/E2E 只写验证基准与场景;未确定项标记 DECISION_REQUIRED 或 DB_DECISION_REQUIRED。