# BA SKILL **Repository Path**: fxsunstar/ba-skill ## Basic Information - **Project Name**: BA SKILL - **Description**: 一套自建的基于claude-code的BA工作流水线skill - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-07-29 - **Last Updated**: 2026-08-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # BA Workflow Skill Suite 一套面向业务分析(BA)场景的 Claude Code Skill 套装,覆盖 **需求文档 → 交互原型 → 功能需求方案 → 测试用例** 完整流水线。 > ⚠️ **模型要求**:本套装需要 **claude-opus-4-8** 模型。如你的环境无此模型,需修改每个 skill 文件 frontmatter 中的 `model:` 字段为可用模型(如 `claude-sonnet-4-5`)。 ## 技能清单 | Skill | 文件 | 功能 | |-------|------|------| | **ba-workflow** | `.claude/skills/ba-workflow.md` | 🎯 流水线调度器:10 种管道模式、模式检测、Gate 校验、级联更新、对抗性验证(`--adv`) | | **req-doc-generator** | `.claude/skills/req-doc-generator.md` | 📝 PRD 需求方案生成:10 章 Template Lock、6 维完整度评估、T1-T4 + C1-C4 + S1-S6 自检 | | **req-to-html** | `.claude/skills/req-to-html.md` | 🖥️ HTML 交互原型生成:DOM Template Lock、审批状态机、角色切换、13 项质量闸门 | | **req-to-excel** | `.claude/skills/req-to-excel.md` | 📊 功能需求方案生成:双格式输出(.xlsx + .md)、双模式(PRD 解析/直接生成) | | **testcase-generator** | `.claude/skills/testcase-generator.md` | 🧪 测试用例生成:Template Lock(3 Sheet 列序固定)、4 档复杂度自适应、双向追溯、场景套件 | ## 配套文件 | 文件 | 用途 | |------|------| | `.claude/references/gate-manifest.json` | 24 道 Schema 校验闸门定义(PRD 8 道 + HTML 13 道 + Testcase 3 道),🛑 硬阻断 + ⚠️ 告警两级 | | `.claude/references/failure-patterns.md` | ⭐ 跨项目失败模式库(7 个模式),自动注入预防提示降低已知失败概率 | | `.claude/references/pipeline-schema-validation.md` | 流水线 Schema 校验规则说明 | | `.claude/references/prd-consumer-contract.md` | PRD 下游消费契约映射表 | | `.claude/references/solution-review-checklist.md` | T4 方案审视清单(S1-S6) | | `.claude/references/design-system.md` | Ant Design 5.x Token 参考(原型 CSS 变量) | | `.claude/references/prototype-base.css` | 原型基类 CSS(CHECKPOINT_CLASSES 锚点) | | `.claude/scripts/log-metrics.js` | 度量日志统一写入脚本 | | `.claude/scripts/validate-xlsx.js` | 测试用例 Excel 校验脚本(支持 4 档复杂度判定) | | `.claude/scripts/gen-testcases-excel.js` | testcase-generator 固定生成模板 | | `.claude/scripts/gen-func-spec-excel.js` | req-to-excel 双格式生成脚本 | | `.claude/scripts/validate-pipeline.sh` | 流水线 Shell 校验脚本 | ## 安装 ### 前置条件 ```bash # 1. Node.js ≥ 18 node -v # 2. 安装 exceljs(生成 Excel 必需) npm install exceljs # 3. 验证 node -e "require('exceljs')" ``` ### 安装 Skill 文件 将本仓库克隆到你的 Claude Code 工作目录,或将 `.claude/` 文件夹复制到你项目的根目录: ```bash # 方式一:克隆(推荐) git clone https://gitee.com/fxsunstar/ba-skill.git /path/to/your/project # 方式二:仅复制 skill 文件(目标目录不存在时) mkdir -p /path/to/your/project/.claude cp -r .claude/skills/* /path/to/your/project/.claude/skills/ cp -r .claude/references/* /path/to/your/project/.claude/references/ cp -r .claude/scripts/* /path/to/your/project/.claude/scripts/ ``` ### 权限配置 将以下权限规则添加到项目的 `.claude/settings.json`,避免首次运行被大量权限提示打断: ```json { "permissions": { "allow": [ "Bash(node:*)", "Bash(grep:*)", "Bash(npm:*)", "Bash(npx:*)", "Read", "Write", "Glob", "Grep" ] } } ``` ### 首次运行 不带参数启动 `/ba-workflow` 会进入 **Guided 模式**——系统通过 3 道交互式选择题帮你确定管道模式、项目名称和移动端配置。首次使用建议走一遍 Guided 模式了解流程,后续可用 `--quick` 跳过交互直接执行。 ## 快速开始 ```bash # 全流程:从零生成需求方案 + 原型 + 测试用例 /ba-workflow --mode=full --name=你的项目名 # 全流程 + 功能需求 Excel + 对抗性验证(推荐正式交付) /ba-workflow --mode=full --name=你的项目名 --with-excel --adv # 仅生成 PRD /ba-workflow --mode=prd-only --name=你的项目名 # 从已有 PRD 继续生成原型 + 用例 /ba-workflow --mode=from-prd # 全自动模式(跳过所有确认闸门) /ba-workflow --mode=full --name=你的项目名 --quick ``` ## 流水线架构 ``` 用户需求描述 │ ▼ ┌──────────────────────────────────────────────────────────────┐ │ ba-workflow(调度层) │ │ 模式检测 → 预防提示注入 → Smoke 测试 → Gate 校验 → 级联更新 │ │ ┌── --adv 启用时 ──┐ │ │ └─ 对抗性验证(PRD) ┘ │ └──────┬──────────┬───────────────┬────────────────┬───────────┘ │ │ │ │ ▼ ▼ ▼ ▼ req-doc- req-to-html req-to-excel testcase- generator (功能需求方案) generator ┌───────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ .md │ │ .html │ │ .xlsx │ │ .xlsx │ │ 10章 │ │ + matrix │ │ + .md │ │ 3 Sheet │ │ F/N-ID│ │ approval │ │ 6类Sheet │ │ 场景套件 │ └───────┘ └──────────┘ └──────────┘ └──────────┘ ``` ## V2.2 防幻觉机制(新) | 机制 | 做什么 | 默认 | 成本 | |------|--------|:--:|:---:| | **gate-manifest.json** | 24 道 grep/node 结构校验,🛑 硬阻断 | 始终 | 极低 | | **failure-patterns** | 7 个已知失败模式 → 自动注入预防提示 | 始终 | ~2K tokens | | **SMOKE_TESTS** | 5 个 Skill × 3 条关键锚点断言 | 始终 | ~200 tokens | | **对抗性验证 (`--adv`)** | 异模型 Agent 审计 PRD 内容正确性(5 攻击维度),`--adv=double` 双审计取并集 | 关闭 | +45K tokens(≈0.05元) | ## testcase-generator 核心特性 ### 4 档复杂度自适应 | 复杂度 | 判定条件 | 最低用例数 | P0 占比 | P0+P1 占比 | |--------|----------|:----------:|:------:|:--------:| | **简单** | ≤2 实体 + 无流程 | ≥ 15 | ≥ 20% | ≥ 60% | | **工作流** | 1-2 实体 + 流程非审批 | ≥ 20 | ≥ 25% | ≥ 65% | | **中等** | 3-5 实体 或 含审批 | ≥ 25 | ≥ 20% | ≥ 65% | | **复杂** | ≥6 实体 或 ≥3级审批 / ≥4角色 | ≥ 35 | ≥ 15% | ≥ 60% | 子表 +5 / A 级移动端 +3 / 外部系统对接 +2 ### 12 项质量机制 - ✅ 业务场景具体化(禁止泛词填充) - ✅ 4 种字段校验模板(必填/条件必填/联动/格式) - ✅ 权限双向验证(正向 + 反向各 1 条) - ✅ 状态×角色操作矩阵全覆盖 - ✅ 场景套件自动组装(P0 用例串联为端到端链路) - ✅ 固定代码模板生成(消除手工 exceljs 索引 Bug) - ✅ 3 级降级策略(L1 跳 P2 / L2 P1 减半 / L3 仅 P0+引用) - ✅ 分章节覆盖率文本输出 - ✅ 复杂度判定优先级链(审批级别→角色数→实体数→流程类型) - ✅ 比率冲突处理(先砍 P2 → 合并 P1 → 不降 P0) - ✅ 脚本失败自动降级 Markdown - ✅ permission-matrix.md 路径自动匹配 ## 复杂度支持 | 复杂度 | 用例数 | 示例场景 | |--------|:------:|----------| | 简单 | ≥15 | 单实体 CRUD | | 工作流 | ≥20 | 1-2 实体,流程非审批(如报修→接单→维修→确认) | | 中等 | ≥25 | 3-5 实体,含审批流程(通过/驳回/会签) | | 复杂 | ≥35 | ≥6 实体,或 ≥3 级审批,或 ≥4 角色,含子表 | ## 依赖 - Node.js ≥ 18 - npm 包:`exceljs`(testcase-generator / req-to-excel 使用,需手动安装 `npm install exceljs`) ## 版本历史 | 版本 | 日期 | 变更 | |------|------|------| | **V2.2** | 2026-08 | 对抗性验证(`--adv`) + failure-patterns 模式库 + SMOKE_TESTS 烟雾测试 + gate-manifest 增强(PRD 6→8 / HTML 6→13) | | V2.1 | 2026-07 | req-to-excel Skill + --with-excel 管道 + Guided 模式 + Template Lock 机制 | | V2.0 | 2026-06 | gate-manifest.json 闸门外置 + Pipeline Manifest + 统一协调器降级 | | V1.x | 2026-05 | 初版:三 Skill + ba-workflow 调度 + 6 种管道模式 | ## License MIT