89088414/16gagent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

🎉 init: 小龙的工作空间

Browse Source
This commit is contained in:
大海
2026-06-06 10:40:48 +08:00
commit a188ee1426
3201 changed files with 231817 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/factories/sf-01-product-strategy.md
+218
View File
@@ -0,0 +1,218 @@
# SF-01 Product Strategy Factory
> **PR-36 的下游 Factory**：第一款 AI Software Factory。
> 输入一句话产品想法，输出完整 Product Strategy Package。
---
## Factory Purpose
SF-01 让系统拥有**专业产品经理 + 创业顾问 + 市场分析师**能力。
在软件开发开始前完成三项判断：
1. **市场判断** — 这个市场值不值得进？
2. **商业判断** — 这个产品怎么赚钱？
3. **产品判断** — 这个产品值不值得做？
**约束：** SF-01 只负责策略层判断，不涉及编码、需求拆解、架构设计、UI 设计。
---
## Workflow
```
Product Idea (自然语言)
│
├─ 1. Idea Analysis → 10 维度创意评分
│ ├─ 用户痛点 / 需求 / 市场规模
│ ├─ 行业阶段 / 市场成熟度
│ ├─ 替代方案 / 付费意愿
│ └─ 产品壁垒 / 技术门槛 / 竞争门槛
│
├─ 2. Market Analysis → TAM/SAM/SOM + 趋势 + 机会
│
├─ 3. Competitor Analysis → 直接竞品 / 间接竞品 / 替代方案
│
├─ 4. Business Model → 7 种模式推荐 + LTV/CAC + 现金流
│
├─ 5. Viability Scoring → 6 维度 0-100 评分
│
├─ 6. Prioritization → P0-P3 优先级
│
├─ 7. Vision Generation → Vision / Mission / North Star
│
├─ 8. GTM Strategy → 进入策略 / 获客 / 品牌 / 增长
│
├─ 9. Roadmap → MVP → V3 → Enterprise → Global
│
└─ 10. Strategy Package → 统一输出（14 个组成部分）
```
---
## Domain Model
13 个战略类型：
| 类型 | 作用 | 关键字段 |
|------|------|----------|
| `ProductIdea` | 原始创意 | raw, keywords, category |
| `ProductVision` | 产品愿景 | vision, mission, northStarMetric, coreValues |
| `TargetMarket` | 目标市场 | tam, sam, som, growthRate, maturity, aiImpact |
| `TargetCustomer` | 目标客户 | segment, persona, painPoints, willingnessToPay |
| `ProblemStatement` | 问题陈述 | who, what, why, severity, evidence |
| `ValueProposition` | 价值主张 | statement, benefits, differentiators, uniqueness |
| `CompetitiveLandscape` | 竞争格局 | direct/indirect competitors, intensity, barriers |
| `BusinessModel` | 商业模式 | type (7 种), revenueStreams, LTV/CAC, margins |
| `RevenueModel` | 收入模型 | primaryModel, streams, ARPU, year1/3/5 revenue |
| `GoToMarketStrategy` | GTM 策略 | entryStrategy, channels, coldStart, brand, growth |
| `RiskAssessment` | 风险评估 | 5 类风险评分 + 缓解措施 |
| `SuccessMetric` | 成功指标 | northStar, KPIs, milestones |
| `Roadmap` | 路线图 | 6 阶段 (MVP→Global) + 预算 + 团队 |
---
## Artifact Model
7 种战略产物：
| Artifact | 类型 | 内容 |
|----------|------|------|
| `product-strategy-package` | requirement | 完整策略包 (Executive Summary) |
| `market-analysis-report` | report | TAM/SAM/SOM + 趋势 + 机会 |
| `competitor-report` | report | 竞品全景 + 策略建议 |
| `business-model-report` | report | 商业模式 + 财务指标 |
| `gtm-report` | report | 市场进入策略 |
| `roadmap-report` | report | MVP→V3→Enterprise→Global |
| `viability-report` | report | 可行性评分 + 维度拆解 |
---
## Scoring System
### Viability Score (0-100)
| 维度 | 权重 | 评估内容 |
|------|------|----------|
| Market | 25% | 市场吸引力（规模 + 增长 + 阶段） |
| Technical | 15% | 技术可行性（壁垒 + 门槛） |
| Competition | 20% | 竞争优势（强度 + 护城河 + 壁垒） |
| Monetization | 20% | 变现能力（毛利 + LTV/CAC + 付费意愿） |
| Execution | 10% | 执行可行性 |
| Risk | 10% | 风险可控性 |
### Verdict
| 分数 | 判定 | 含义 |
|------|------|------|
| ≥ 80 | `STRONG_GO` | 全力推进 |
| 65-79 | `GO` | 可以推进 |
| 50-64 | `CONDITIONAL_GO` | 有条件推进 |
| 35-49 | `HIGH_RISK` | 高风险，需验证 |
| < 35 | `NO_GO` | 不建议 |
### Priority Level
| 分数 | 级别 | 含义 |
|------|------|------|
| ≥ 75 | P0 | 立即执行 |
| 60-74 | P1 | 尽快执行 |
| 45-59 | P2 | 计划执行 |
| < 45 | P3 | 未来考虑 |
---
## Integration Flow
```
PR-35 Runtime (Task/Pipeline)
│
▼
PR-36 Factory Core (Registry/Workflow/ArtifactGraph)
│
▼
SF-01 Factory (this)
│
├─ registerSF01(registry) → 注册到 Registry
├─ sf01ProductStrategyFactory() → Factory Contract 实现
│
├─ creates 7 artifacts → ArtifactGraph 可追踪
├─ produces 7+ metrics → FactoryMetric
└─ outputs FactoryOutput → Registry.execute()
```
---
## Examples
### Basic: Analyze an idea
```javascript
import { sf01ProductStrategyFactory } from './src/sf-01-product-strategy/index.mjs';
const output = sf01ProductStrategyFactory({
parameters: { idea: "开发一个AI Agent平台" },
});
console.log(output.status); // "passed" or "blocked"
console.log(output.artifacts[0].content); // Executive Summary
```
### Full Integration with PR-36
```javascript
import { createFactoryRegistry } from './src/software-factory-core/index.mjs';
import { registerSF01 } from './src/sf-01-product-strategy/index.mjs';
const registry = createFactoryRegistry();
registerSF01(registry);
const input = createFactoryInput({
factoryId: "SF-01",
parameters: { idea: "开发一个工业MES系统" },
});
const output = registry.execute("SF-01", input);
```
### Individual Engine Usage
```javascript
import { analyzeProductIdea } from './src/sf-01-product-strategy/idea-analysis.mjs';
import { analyzeMarket } from './src/sf-01-product-strategy/market-analysis.mjs';
import { evaluateViability } from './src/sf-01-product-strategy/viability.mjs';
const idea = analyzeProductIdea("开发一个跨境电商工具");
const market = analyzeMarket(idea);
const viability = evaluateViability(idea, market);
console.log(`Viability: ${viability.overall}/100 — ${viability.verdict}`);
```
---
## 与 PR-35/PR-36 兼容性
- ✅ 不修改 `src/agent-runtime/` 任何文件（PR-35）
- ✅ 不修改 `src/software-factory-core/` 任何文件（PR-36）
- ✅ 通过 `FactoryInput/FactoryOutput` 与 PR-36 通信
- ✅ 产物通过 `createFactoryArtifact` 创建，兼容 PR-36 ArtifactGraph
- ✅ 指标通过 `createFactoryMetric` 创建，兼容 PR-36 FactoryReport
- ✅ 工厂通过 `registerSF01(registry)` 注入 PR-36 Registry
- ✅ 独立目录 `src/sf-01-product-strategy/`
---
## 下一步：SF-02 建议
SF-02 Requirement Engineering Factory 的实现建议：
1. **输入来源：** SF-01 的 `product-strategy-package` artifact
2. **核心能力：** 将 Product Strategy 拆解为结构化需求（Epic → User Story → Acceptance Criteria）
3. **依赖关系：** SF-02 依赖 SF-01 (data dependency)
4. **产物类型：** `requirement` artifacts（PRD、User Stories、Acceptance Criteria）
5. **与 SF-01 的协作：** SF-02 读取 SF-01 的 Target Customer / Problem Statement / Roadmap MVP 阶段，生成对应的需求文档
---
*SF-01 — 全自动软件公司的战略大脑。*
docs/factories/sf-02-requirement-engineering.md
+264
View File
@@ -0,0 +1,264 @@
# SF-02 Requirement Engineering Factory
> **Status:** ✅ Active
> **Domain:** requirement-engineering
> **Dependency:** SF-01 Product Strategy Factory
## Purpose
SF-02 Requirement Engineering Factory 将 SF-01 产出的 Product Strategy Package 自动转换为完整的 Requirement Package。
SF-02 是 SF-01（战略）→ SF-03（设计）之间的关键桥梁。它把模糊的战略意图转化为结构化、可验证、可追踪的需求体系。
**SF-02 只负责需求工程，不生成代码、不设计数据库、不设计架构、不设计 UI。**
## Domain Model
SF-02 建立了统一的需求领域模型，包含 15 个核心概念：
| # | 概念 | 类型 | 说明 |
|---|------|------|------|
| 1 | RequirementPackage | 容器 | 顶层需求包，包含全部需求产物 |
| 2 | Epic | 需求 | 史诗级需求，可分解为 Feature |
| 3 | Feature | 需求 | 功能需求，属于某个 Epic |
| 4 | UserStory | 需求 | 用户故事，As a/I want/So that 格式 |
| 5 | AcceptanceCriteria | 验证 | Given/When/Then 格式验收标准 |
| 6 | BusinessRule | 规则 | 业务约束、流程规则、审批规则等 |
| 7 | Constraint | 约束 | 技术/业务/合规/资源/时间约束 |
| 8 | NonFunctionalRequirement | NFR | 性能/安全/可靠性/可扩展性等 |
| 9 | PermissionRequirement | 权限 | RBAC/ABAC/Hybrid 权限模型 |
| 10 | IntegrationRequirement | 集成 | 支付/短信/邮件/AI等集成需求 |
| 11 | DataRequirement | 数据 | 实体需求（不设计数据库） |
| 12 | RiskRequirement | 风险 | 需求相关风险识别与管理 |
| 13 | TraceabilityLink | 追踪 | 需求元素间可追溯关系 |
| 14 | Priority | 优先级 | MoSCoW/RICE/WSJF 优先级 |
| 15 | Dependency | 依赖 | 需求间依赖关系 |
| 16 | RequirementVersion | 版本 | 需求变更版本追踪 |
## Workflow
```
SF-01 Product Strategy Package
│
▼
┌─────────────────────────────────────────────────┐
│ SF-02 Factory Pipeline │
│ │
│ 1. 接收 SF-01 Strategy Package │
│ 2. Strategy → Requirement Conversion │
│ 3. Epic Generation (Part C) │
│ 4. Feature Generation (Part D) │
│ 5. User Story Generation (Part E) │
│ 6. Acceptance Criteria Generation (Part F) │
│ 7. Business Rules Generation (Part G) │
│ 8. Permission Requirements (Part H) │
│ 9. NFR Generation (Part I) │
│ 10. Integration Requirements (Part J) │
│ 11. Data Requirements (Part K) │
│ 12. Dependency Graph (Part L) │
│ 13. Priority Matrix (Part M) │
│ 14. MVP Scope (Part N) │
│ 15. Traceability Matrix (Part O) │
│ 16. Requiremente Package Assembly │
└─────────────────────────────────────────────────┘
│
▼
SF-03 Product Design Factory
```
## Artifact Model
SF-02 产出 14 种 Artifact：
| # | Artifact | Kind | 说明 |
|---|----------|------|------|
| 1 | requirement-package | requirement | 完整需求包（Markdown 报告） |
| 2 | epic-catalog | requirement | Epic 目录（JSON） |
| 3 | feature-catalog | requirement | Feature 目录（JSON） |
| 4 | user-story-catalog | requirement | User Story 目录（JSON） |
| 5 | acceptance-criteria-package | requirement | 验收标准包（JSON） |
| 6 | business-rules-catalog | requirement | 业务规则目录（JSON） |
| 7 | permission-requirements | requirement | 权限需求（JSON） |
| 8 | nfr-package | requirement | 非功能需求包（JSON） |
| 9 | integration-requirements | requirement | 集成需求（JSON） |
| 10 | data-requirements | requirement | 数据需求（JSON） |
| 11 | dependency-graph | requirement | 依赖图（JSON） |
| 12 | priority-matrix | requirement | 优先级矩阵（JSON） |
| 13 | mvp-scope | requirement | MVP 范围定义（JSON） |
| 14 | traceability-matrix | requirement | 追踪矩阵（JSON） |
## Priority Model
SF-02 支持三种优先级方法：
### MoSCoW
- **Must Have** (30%): MVP 核心功能
- **Should Have** (30%): V1 重要功能
- **Could Have** (25%): V2 增强功能
- **Won't Have** (15%): 远期规划
### RICE
```
Score = Reach × Impact × Confidence / Effort
```
### WSJF
```
Score = (Business Value + Time Criticality + Risk Reduction) / Job Duration
```
## Traceability Model
建立完整的需求追踪链：
```
SF-01 Strategy
│
▼ (strategy→epic)
Epic
│
▼ (epic→feature)
Feature
│
▼ (feature→story)
User Story
│
├── (story→ac) ──► Acceptance Criteria
├── (story→business-rule) ──► Business Rules
├── (story→nfr) ──► NFRs
└── (story→data) ──► Data Requirements
Epic → Permission Requirements (epic→permission)
Epic → Integration Requirements (epic→integration)
```
每条需求都可以从 Strategy 追溯到最终的 Acceptance Criteria。
## Conversion Logic
### Epic 生成
从产品分类（AI平台/企业SaaS/电商平台/教育平台/通用）匹配领域模板，自动生成 5~12 个 Epic。
例如：**AI客服平台** → 8 个 Epic：
| Epic | Category | Objective |
|------|----------|-----------|
| 用户管理 | 用户管理 | 建立完整的用户身份体系 |
| 知识库管理 | 内容管理 | 构建高质量可检索的知识体系 |
| Agent管理 | 智能/AI | 实现 Agent 全生命周期管理 |
| 对话管理 | 业务流程 | 提供流畅的 AI 对话体验 |
| 权限管理 | 安全合规 | 保证系统安全性 |
| 运营分析 | 运营分析 | 数据驱动的产品优化 |
| 系统设置 | 系统设置 | 灵活的系统管理能力 |
| 集成对接 | 集成对接 | 开放生态集成能力 |
### Feature 生成
每个 Epic 按标题匹配 Feature 模板。例如**知识库管理** → 7 个 Feature：
- 知识库创建 (CRUD)
- 文档上传 (CRUD)
- 文档解析 (workflow)
- 知识编辑 (CRUD)
- 索引构建 (workflow)
- 版本管理 (CRUD)
- 知识分类 (configuration)
### User Story 生成
根据 Feature 类型（CRUD/workflow/analytics/configuration/integration/notification/search）自动生成标准格式的 User Story。
例如：**文档上传 (CRUD)** → 6 个 Story：
```
As a 用户, I want 浏览文档管理列表, so that 查找所需的知识库信息. (Must Have)
As a 用户, I want 查看文档管理详情, so that 了解知识库的完整信息. (Should Have)
As a 用户, I want 创建新的文档, so that 添加新的知识库条目. (Should Have)
As a 用户, I want 编辑已有文档, so that 保持知识库信息准确. (Could Have)
As a 管理员, I want 删除文档, so that 清理无效的知识库数据. (Could Have)
As a 管理员, I want 批量管理文档管理, so that 高效处理大量知识库数据. (Could Have)
```
### Acceptance Criteria 生成
每个 Story 自动生成 6~10 条 AC，覆盖：
1. 正常流程
2. 数据展示
3. 空数据状态
4. 数据验证
5. 权限控制
6. 并发处理
7. 故事特定场景（创建重复/删除确认/搜索/导出等）
## Files
| File | Purpose |
|------|---------|
| `src/sf-02-requirement-engineering/domain-model.mjs` | 需求领域模型（15 个类型） |
| `src/sf-02-requirement-engineering/strategy-to-requirement.mjs` | 策略→需求转换引擎 |
| `src/sf-02-requirement-engineering/dependency-engine.mjs` | 依赖/优先级/MVP/追踪引擎 |
| `src/sf-02-requirement-engineering/index.mjs` | Factory 入口 + 注册 + 报告 |
| `test/sf-02-requirement-engineering.test.mjs` | 89 项测试 |
| `docs/factories/sf-02-requirement-engineering.md` | 本文档 |
## Integration Flow
### With SF-01
```
SF-01.analyze("AI Agent平台")
→ FactoryInput { factoryId: "SF-01" }
→ FactoryOutput { artifacts: [StrategyPackage, ...] }
→ FactoryInput { factoryId: "SF-02", upstreamArtifacts: [...] }
→ FactoryOutput { artifacts: [RequirementPackage, ...] }
```
### With PR-36 Factory Registry
```javascript
const registry = createFactoryRegistry();
registerSF01(registry);
registerSF02(registry);
const sf01Out = registry.execute("SF-01", input);
const sf02Out = registry.execute("SF-02", { upstreamArtifacts: sf01Out.artifacts });
// sf02Out.status === "passed"
// sf02Out.artifacts.length === 14
```
### With PR-35 Runtime
```javascript
const task = createTask({ id: "T-001", title: "Req Engineering" });
// Execute within runtime context...
```
## Examples
### AI 客服平台完整转换
输入：SF-01 分析的 "AI客服平台"
输出：
- **8 Epics**: 用户管理/知识库管理/Agent管理/对话管理/权限管理/运营分析/系统设置/集成对接
- **40+ Features**: 每个 Epic 3~7 个 Feature
- **120+ User Stories**: 标准 As a/I want/So that 格式
- **240+ Acceptance Criteria**: Given/When/Then 格式
- **7 Business Rules**: 验证/约束/流程/审批/状态机
- **10 NFRs**: 性能/安全/可靠性/扩展性/可观测性/国际化/兼容性
- **6 Integration Reqs**: AI模型/邮件/短信/对象存储/搜索引擎/第三方登录
- **5 Data Reqs**: 用户/角色权限/知识库/对话记录/操作日志
- **100+ Dependencies**: Epic/Feature/Story 三级依赖
- **400+ Traceability Links**: 全链追踪
## Next Step: SF-03
SF-03 Product Design Factory 将以 SF-02 的 Requirement Package 为输入，产出：
- 信息架构
- 交互流程
- 页面结构
- 原型设计
SF-02 产出的所有 Artifact 都是 SF-03 的 `upstreamArtifacts` 输入。
---
_Generated by SF-02 Requirement Engineering Factory | 2026-06-05_