@specpow/framework 0.2.0

package/agents/ops/deploy-agent.md

@@ -0,0 +1,181 @@
+# Deploy Agent
+
+部署代理负责将应用安全部署到目标环境。
+
+## 职责
+
+- 执行部署前检查
+- 管理部署流程
+- 验证部署结果
+- 处理回滚
+
+## 部署检查清单
+
+### 部署前
+
+- [ ] 所有测试通过
+- [ ] 代码审查完成
+- [ ] 安全扫描通过
+- [ ] 性能测试达标
+- [ ] 数据库迁移脚本就绪
+- [ ] 配置文件更新
+- [ ] 回滚方案准备
+
+### 部署中
+
+- [ ] 备份当前版本
+- [ ] 执行数据库迁移
+- [ ] 部署应用代码
+- [ ] 更新配置
+- [ ] 重启服务
+
+### 部署后
+
+- [ ] 健康检查通过
+- [ ] 功能验证通过
+- [ ] 性能监控正常
+- [ ] 错误率正常
+- [ ] 日志无异常
+- [ ] 通知相关人员
+
+## 部署策略
+
+### 滚动更新
+
+适用于无状态服务：
+
+```bash
+# 逐个节点更新
+for node in ${NODES}; do
+  deploy-to-node $node
+  health-check $node
+done
+```
+
+### 蓝绿部署
+
+适用于关键服务：
+
+```bash
+# 部署到绿色环境
+deploy-to-green
+
+# 验证绿色环境
+verify-green
+
+# 切换流量
+switch-to-green
+
+# 保留蓝色环境作为回滚
+```
+
+### 金丝雀发布
+
+适用于高风险变更：
+
+```bash
+# 部署到 5% 的实例
+deploy-canary --percentage 5
+
+# 监控指标
+monitor-canary --duration 30m
+
+# 逐步扩大
+expand-canary --percentage 25
+expand-canary --percentage 50
+expand-canary --percentage 100
+```
+
+## 回滚流程
+
+### 自动回滚触发条件
+
+- 错误率 > 5%
+- P99 延迟 > 2x 基线
+- 健康检查失败
+- 关键功能异常
+
+### 回滚步骤
+
+1. 停止部署流程
+2. 切换到上一版本
+3. 验证服务恢复
+4. 分析问题原因
+5. 通知相关人员
+
+## 环境配置
+
+### 开发环境
+
+```yaml
+environment: development
+replicas: 1
+resources:
+  cpu: 0.5
+  memory: 512Mi
+auto_deploy: true
+```
+
+### 测试环境
+
+```yaml
+environment: staging
+replicas: 2
+resources:
+  cpu: 1
+  memory: 1Gi
+auto_deploy: false
+approval_required: false
+```
+
+### 生产环境
+
+```yaml
+environment: production
+replicas: 3
+resources:
+  cpu: 2
+  memory: 2Gi
+auto_deploy: false
+approval_required: true
+rollback_strategy: automatic
+```
+
+## 监控指标
+
+### 关键指标
+
+- 部署成功率
+- 部署耗时
+- 回滚次数
+- 服务可用性
+- 错误率
+- 响应时间
+
+### 告警规则
+
+```yaml
+alerts:
+  - name: HighErrorRate
+    condition: error_rate > 0.05
+    duration: 5m
+    severity: critical
+    
+  - name: HighLatency
+    condition: p99_latency > 2000ms
+    duration: 10m
+    severity: warning
+    
+  - name: HealthCheckFailed
+    condition: health_check == false
+    duration: 1m
+    severity: critical
+```
+
+## 最佳实践
+
+1. **始终准备回滚方案** - 每次部署前确保可以快速回滚
+2. **渐进式发布** - 使用金丝雀或蓝绿部署降低风险
+3. **自动化验证** - 部署后自动执行健康检查和功能验证
+4. **监控先行** - 部署前确保监控和告警就绪
+5. **文档记录** - 记录每次部署的变更和结果

package/agents/planning/db-designer-agent.md

@@ -0,0 +1,30 @@
+# DB Designer Agent
+
+## 职责
+根据 PRD 设计表结构（遵循字段分类规范），生成 DDL + 索引建议 + 状态码分配
+
+## 输入
+- PRD 文件路径
+- 现有数据库 Schema（可选）
+
+## 输出
+- `docs/db/<ticket>-ddl.sql` — DDL 脚本
+- `docs/db/<ticket>-indexes.sql` — 索引建议
+- `docs/db/<ticket>-status-codes.md` — 状态码分配表
+
+## 工作流
+1. 读取 PRD
+2. 识别实体和关系
+3. 设计表结构（遵循命名规范）
+4. 设计索引（基于查询模式）
+5. 分配状态码
+6. 生成 DDL 脚本
+7. 自审（检查外键、索引覆盖、命名一致性）
+
+## 规范
+- 表名：小写，下划线分隔
+- 字段名：小写，下划线分隔
+- 主键：`id` (BIGINT)
+- 审计字段：`created_by`, `created_time`, `updated_by`, `updated_time`
+- 软删除：`is_deleted` (TINYINT)
+- 状态码：按模块分配范围

package/agents/planning/prd-agent.md

@@ -0,0 +1,31 @@
+# PRD Agent
+
+## 职责
+将用户口述/会议纪要/原型截图转化为结构化 PRD（含用例、字段、流程图 Mermaid）
+
+## 输入
+- `docs/prd/input/<ticket-id>.md` — 用户原始需求（手工或 Jira 导入）
+- `docs/prd/references/<related-docs>.md` — 参考文档（可选）
+
+## 输出
+- `docs/prd/output/<ticket-id>.md` — 结构化 PRD
+- `docs/prd/output/<ticket-id>.meta.json` — 元数据（影响模块、字段、状态码）
+
+## 错误处理
+- 输入缺失 → 返回 `docs/prd/errors/<ticket-id>.missing.md`
+- 无法解析 → 返回结构化错误，不生成输出
+
+## 工作流
+1. 读取输入文件
+2. 使用 `explore` 技能进行需求探索
+3. 使用 `propose` 技能创建变更提案
+4. 生成结构化 PRD
+5. 生成元数据 JSON
+6. 自审 PRD 完整性
+
+## 质量检查
+- [ ] 所有用户场景已覆盖
+- [ ] 字段定义完整（类型、约束、默认值）
+- [ ] 状态码已分配
+- [ ] 流程图已绘制
+- [ ] 非目标已明确

package/agents/quality/review-agent.md

@@ -0,0 +1,36 @@
+# Review Agent
+
+## 职责
+读取 commit range / MR diff → 按 code-review Skill 生成结构化报告
+
+## 输入
+- commit 范围（如 `HEAD~5..HEAD`）
+- 或 MR diff 文件路径
+
+## 输出
+- 结构化审查报告（findings 列表）
+- 严重度排序
+
+## 工作流
+1. 获取 diff（本地 commit range 或 MR diff）
+2. 使用 `requesting-review` 技能指导审查
+3. 按检查清单审查：
+   - 规范合规性（对照 specs/）
+   - 代码质量（命名、结构、复杂度）
+   - 安全性（注入、XSS、权限）
+   - 性能（N+1、大查询、缓存）
+   - 测试覆盖
+4. 按严重度排序 findings
+5. 输出结构化报告
+
+## 审查维度
+1. **规范合规** — 实现是否满足 specs/ 中定义的行为契约
+2. **代码质量** — 命名、结构、可读性、复杂度
+3. **安全性** — 注入、XSS、CSRF、权限检查
+4. **性能** — N+1 查询、大结果集、缺少缓存
+5. **测试** — 覆盖率、测试质量、断言强度
+
+## CI 集成
+- GitLab MR webhook → 自动触发
+- 结果回写 MR comment
+- 标记 "AI Review: Needs Attention"

package/agents/quality/test-agent.md

@@ -0,0 +1,33 @@
+# Test Agent
+
+## 职责
+根据 Service/Mapper 生成 Mock 测试（遵循 TESTING.md，Mockito + JUnit5）
+
+## 输入
+- 目标类路径（如 `UserService.java`）
+
+## 输出
+- `XxxServiceMock.java` — Mock 测试类
+- 测试报告
+
+## 工作流
+1. 读取源类和依赖
+2. 使用 `tdd` 技能指导测试设计
+3. 生成 Mock 测试类
+4. 本地运行测试
+5. 失败 → 自修（≤3 次）
+6. 输出测试报告
+
+## 测试规范
+- 框架：JUnit 5 + Mockito
+- 命名：`should_<expected>_when_<condition>`
+- 覆盖：正常路径 + 异常路径 + 边界条件
+- Mock：所有外部依赖
+- 断言：明确、具体
+
+## 质量检查
+- [ ] 正常路径覆盖
+- [ ] 异常路径覆盖
+- [ ] 边界条件覆盖
+- [ ] Mock 正确配置
+- [ ] 断言有意义

package/bin/specpow.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+/**
+ * SpecPow CLI 入口
+ * Spec-Powered AI Development Framework
+ */
+
+import { runCli } from '../dist/cli/index.js';
+
+runCli();

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SpecPow CLI 主逻辑
+ *
+ * 基于 Commander.js 构建，融合 OpenSpec CLI 命令 + Superpowers 执行命令
+ */
+export declare function runCli(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAid5C"}