@specpow/framework 0.5.9 → 0.5.10

package/.specpow/agents/ops/deploy-agent.md

@@ -1,181 +0,0 @@
-# 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/.specpow/agents/planning/db-designer-agent.md

@@ -1,30 +0,0 @@
-# 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/.specpow/agents/planning/prd-agent.md

@@ -1,31 +0,0 @@
-# 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/.specpow/agents/quality/review-agent.md

@@ -1,36 +0,0 @@
-# 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/.specpow/agents/quality/test-agent.md

@@ -1,33 +0,0 @@
-# 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/.specpow/hooks/hooks.json

@@ -1,30 +0,0 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
-            "shell": "bash",
-            "async": false
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" workflow-state",
-            "shell": "bash",
-            "async": false
-          }
-        ]
-      }
-    ]
-  }
-}

package/.specpow/hooks/run-hook.cmd

@@ -1,19 +0,0 @@
-@echo off
-REM SpecPow Hook Runner for Windows
-REM Usage: run-hook.cmd <hook-name>
-REM
-REM P2-11: 支持 SessionStart 和 WorkflowState 两种 Hook
-
-set HOOK_NAME=%1
-set SCRIPT_DIR=%~dp0
-
-if "%HOOK_NAME%"=="session-start" (
-    bash "%SCRIPT_DIR%session-start"
-) else if "%HOOK_NAME%"=="workflow-state" (
-    REM WorkflowState Hook: 注入当前工作流状态
-    REM 通过 Node.js 调用 TypeScript Hook 模块
-    node -e "import('file:///%SCRIPT_DIR:~0,-1%/../dist/core/hooks/index.js').then(m => m.executeUserPromptSubmit(process.cwd(), '', 'claude').then(c => { if(c) console.log(JSON.stringify({hookSpecificOutput:{hookEventName:'UserPromptSubmit',additionalContext:c}})); else process.exit(0); }))"
-) else (
-    echo Unknown hook: %HOOK_NAME%
-    exit /b 1
-)

package/.specpow/hooks/session-start

@@ -1,62 +0,0 @@
-#!/usr/bin/env bash
-# SpecPow Session Start Hook
-# 
-# 在每次会话开始时注入 using-skills 技能内容到 AI 代理上下文
-# 兼容 Claude Code、Cursor、Copilot CLI 等平台
-
-set -euo pipefail
-
-# Determine plugin root directory
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
-
-# Read using-skills content
-using_skills_content=$(cat "${PLUGIN_ROOT}/skills/meta-using-skills/SKILL.md" 2>&1 || echo "Error reading using-skills skill")
-
-# Escape string for JSON embedding
-escape_for_json() {
-    local s="$1"
-    s="${s//\\/\\\\}"
-    s="${s//\"/\\\"}"
-    s="${s//$'\n'/\\n}"
-    s="${s//$'\r'/\\r}"
-    s="${s//$'\t'/\\t}"
-    printf '%s' "$s"
-}
-
-using_skills_escaped=$(escape_for_json "$using_skills_content")
-
-# Check for OpenSpec context
-openspec_context=""
-if [ -f "${PLUGIN_ROOT}/../openspec/specs" ] 2>/dev/null || [ -d "${PLUGIN_ROOT}/../openspec/specs" ] 2>/dev/null; then
-  # Detect active changes
-  active_changes=""
-  if [ -d "${PLUGIN_ROOT}/../openspec/changes" ] 2>/dev/null; then
-    changes_count=$(find "${PLUGIN_ROOT}/../openspec/changes" -maxdepth 1 -mindepth 1 -type d ! -name 'archive' 2>/dev/null | wc -l | tr -d ' ')
-    if [ "$changes_count" -gt 0 ] 2>/dev/null; then
-      active_changes_list=$(find "${PLUGIN_ROOT}/../openspec/changes" -maxdepth 1 -mindepth 1 -type d ! -name 'archive' 2>/dev/null | while read d; do basename "$d"; done | tr '\n' ', ' | sed 's/, $//')
-      active_changes="\nActive changes (${changes_count}): ${active_changes_list}\nUse 'specpow status' to inspect."
-    fi
-  fi
-
-  openspec_context="\nOpenSpec structure detected in this project. Follow the spec-driven workflow:\n1. Explore → planning-explore skill\n2. Propose → planning-propose skill\n3. Write Specs/Design/Tasks → planning-write-* skills\n4. Implement → execution-* skills (SDD engine)\n5. Verify → execution-verification-before-completion\n6. Archive → specpow archive\n${active_changes}\n"
-fi
-
-session_context="<EXTREMELY_IMPORTANT>\nYou have specpow — a spec-powered AI development framework. It combines OpenSpec's spec-driven planning with Superpowers' subagent-driven execution.\n\n**Below is the full content of your 'specpow:meta-using-skills' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_skills_escaped}\n\n${openspec_context}\n\nAvailable skill categories:\n- Planning: planning-explore, planning-propose, planning-write-plans, planning-write-specs, planning-write-design\n- Execution: planning-apply-change, execution-subagent-driven-dev, execution-tdd, execution-systematic-debugging, execution-parallel-agents\n- Quality: execution-requesting-review, execution-receiving-review, execution-verification-before-completion, planning-verify-change\n- Business: business-java-codegen, business-ui-codegen, business-test-gen, business-code-review, business-db-design, business-prd-writer, business-deploy-check\n- CLI Router: cli-router — maps user intent to SpecPow CLI commands\n\nSpecPow CLI quick reference (execute via Bash tool):\n| Command | Purpose |\n|---------|----------|\n| specpow status | View current change status |\n| specpow explore \"<topic>\" | Socratic requirement exploration (interactive, run in terminal) |\n| specpow propose <name> | Create change proposal |\n| specpow apply | Execute implementation |\n| specpow verify | Verify changes |\n| specpow archive | Archive changes |\n| specpow debug \"<desc>\" | Systematic debugging |\n| specpow doctor | Project diagnostics |\n\nUsers can also use slash commands: /specpow-explore, /specpow-propose, /specpow-apply, /specpow-verify, /specpow-archive, /specpow-status\n\nRemember: Check for relevant skills BEFORE any action.\n</EXTREMELY_IMPORTANT>"
-
-# Output context injection as JSON
-# Cursor hooks expect additional_context (snake_case)
-# Claude Code hooks expect hookSpecificOutput.additionalContext (nested)
-# Copilot CLI (v1.0.11+) and others expect additionalContext (top-level, SDK standard)
-if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
-  # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
-  printf '{\n  "additional_context": "%s"\n}\n' "$session_context" | cat
-elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
-  # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI
-  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context" | cat
-else
-  # Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
-  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context" | cat
-fi
-
-exit 0

package/.specpow/hooks/workflow-state

@@ -1,150 +0,0 @@
-#!/usr/bin/env bash
-# SpecPow Workflow State Hook
-#
-# 在用户提交提示时注入当前工作流状态
-# 兼容 Claude Code、Cursor、Copilot CLI 等平台
-
-set -euo pipefail
-
-# Determine plugin root directory
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
-PROJECT_ROOT="$(cd "${PLUGIN_ROOT}/.." 2>/dev/null && pwd || echo "${PLUGIN_ROOT}")"
-
-# Escape string for JSON embedding
-escape_for_json() {
-    local s="$1"
-    s="${s//\\/\\\\}"
-    s="${s//\"/\\\"}"
-    s="${s//$'\n'/\\n}"
-    s="${s//$'\r'/\\r}"
-    s="${s//$'\t'/\\t}"
-    printf '%s' "$s"
-}
-
-# Detect active change
-detect_active_change() {
-    local changes_dir="${PROJECT_ROOT}/openspec/changes"
-    if [ ! -d "$changes_dir" ]; then
-        echo ""
-        return
-    fi
-
-    # Find first active change (excluding archive)
-    local change_name=""
-    for dir in "$changes_dir"/*/; do
-        local basename=$(basename "$dir")
-        if [ "$basename" != "archive" ] && [ -d "$dir" ]; then
-            change_name="$basename"
-            break
-        fi
-    done
-
-    if [ -z "$change_name" ]; then
-        echo ""
-        return
-    fi
-
-    echo "$change_name"
-}
-
-# Infer workflow stage from change directory contents
-infer_stage() {
-    local change_name="$1"
-    local change_dir="${PROJECT_ROOT}/openspec/changes/${change_name}"
-
-    if [ ! -d "$change_dir" ]; then
-        echo "idle"
-        return
-    fi
-
-    # Check for verify/review files
-    if ls "$change_dir"/*verify* 2>/dev/null | head -1 > /dev/null || \
-       ls "$change_dir"/*review* 2>/dev/null | head -1 > /dev/null; then
-        echo "verify"
-        return
-    fi
-
-    # Check for tasks files
-    if ls "$change_dir"/*tasks* 2>/dev/null | head -1 > /dev/null; then
-        echo "apply"
-        return
-    fi
-
-    # Check for spec/design files
-    if ls "$change_dir"/*spec* 2>/dev/null | head -1 > /dev/null || \
-       ls "$change_dir"/*design* 2>/dev/null | head -1 > /dev/null; then
-        echo "propose"
-        return
-    fi
-
-    echo "explore"
-}
-
-# Main logic
-change_name=$(detect_active_change)
-
-if [ -z "$change_name" ]; then
-    # No active change, no context to inject
-    exit 0
-fi
-
-stage=$(infer_stage "$change_name")
-
-# Build workflow context
-workflow_context="<!-- workflow-state: ${stage} -->\n<!-- active-change: ${change_name} -->"
-
-# Add stage hint
-case "$stage" in
-    explore)
-        workflow_context="${workflow_context}\n🔍 当前阶段: EXPLORE — 使用 planning-explore 技能理解需求"
-        ;;
-    propose)
-        workflow_context="${workflow_context}\n📝 当前阶段: PROPOSE — 使用 planning-propose 创建变更提案"
-        ;;
-    apply)
-        workflow_context="${workflow_context}\n⚙️ 当前阶段: APPLY — 使用 planning-apply-change 执行实现"
-        ;;
-    verify)
-        workflow_context="${workflow_context}\n✅ 当前阶段: VERIFY — 使用 planning-verify-change 验证规范"
-        ;;
-    archive)
-        workflow_context="${workflow_context}\n📦 当前阶段: ARCHIVE — 运行 specpow archive 合并到主规范"
-        ;;
-esac
-
-# Check progress
-change_dir="${PROJECT_ROOT}/openspec/changes/${change_name}"
-progress=""
-if ls "$change_dir"/*proposal* 2>/dev/null | head -1 > /dev/null; then
-    progress="${progress}✓ proposal"
-fi
-if ls "$change_dir"/*spec* 2>/dev/null | head -1 > /dev/null; then
-    [ -n "$progress" ] && progress="${progress}, "
-    progress="${progress}✓ specs"
-fi
-if ls "$change_dir"/*tasks* 2>/dev/null | head -1 > /dev/null; then
-    [ -n "$progress" ] && progress="${progress}, "
-    progress="${progress}✓ tasks"
-fi
-
-if [ -n "$progress" ]; then
-    workflow_context="${workflow_context}\n进度: ${progress}"
-fi
-
-# Escape for JSON
-workflow_context_escaped=$(escape_for_json "$workflow_context")
-
-# Output based on platform
-if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
-    # Cursor format
-    printf '{\n  "additional_context": "%s"\n}\n' "$workflow_context_escaped" | cat
-elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
-    # Claude Code format
-    printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "UserPromptSubmit",\n    "additionalContext": "%s"\n  }\n}\n' "$workflow_context_escaped" | cat
-else
-    # Copilot CLI or unknown platform
-    printf '{\n  "additionalContext": "%s"\n}\n' "$workflow_context_escaped" | cat
-fi
-
-exit 0

package/.specpow/schemas/bug-fix/schema.yaml

@@ -1,64 +0,0 @@
-# Bug 修复 Schema
-# 用于快速定位和修复 Bug 的工件流
-
-name: bug-fix
-description: 系统化定位和修复 Bug
-
-apply:
-  requires:
-    - tasks
-
-artifacts:
-  - id: proposal
-    name: Bug 描述
-    description: 描述 Bug 现象和复现步骤
-    requires: []
-    template: proposal.md
-    instruction: |
-      记录 Bug 信息：
-      - Bug 标题
-      - 复现步骤（Step 1, 2, 3...）
-      - 预期行为
-      - 实际行为
-      - 环境信息
-      - 影响范围
-    output: proposal.md
-
-  - id: analysis
-    name: 根因分析
-    description: 分析 Bug 根因
-    requires: [proposal]
-    template: analysis.md
-    instruction: |
-      根因分析（4 阶段）：
-      1. 调查 — 收集日志、堆栈、复现
-      2. 模式分析 — 识别错误模式
-      3. 假设 — 提出根因假设
-      4. 验证 — 验证假设正确性
-    output: analysis.md
-
-  - id: fix-plan
-    name: 修复计划
-    description: 制定修复方案
-    requires: [analysis]
-    template: fix-plan.md
-    instruction: |
-      修复方案：
-      - 修复策略（热修复/正常修复/重构修复）
-      - 修改文件列表
-      - 回归测试计划
-    output: fix-plan.md
-
-  - id: tasks
-    name: 修复任务
-    description: 修复步骤拆分
-    requires: [fix-plan]
-    template: tasks.md
-    instruction: |
-      修复任务拆分：
-      1. 编写失败测试（复现 Bug）
-      2. 修复代码
-      3. 验证测试通过
-      4. 回归测试
-      5. 更新文档
-    output: tasks.md

package/.specpow/schemas/bug-fix/templates/analysis.md

@@ -1,43 +0,0 @@
-# 根因分析
-
-## 1. 调查
-
-### 错误日志
-```
-（关键错误日志）
-```
-
-### 堆栈跟踪
-```
-（关键堆栈）
-```
-
-### 复现结果
-- 是否可稳定复现: 是/否
-- 复现频率: 
-
-## 2. 模式分析
-
-### 错误模式
-- 错误类型: 
-- 涉及模块: 
-- 最近变更: 
-
-## 3. 假设
-
-### 假设 1: [描述]
-- 证据: 
-- 验证方法: 
-
-### 假设 2: [描述]
-- 证据: 
-- 验证方法: 
-
-## 4. 结论
-
-### 根因
-[确认的根因描述]
-
-### 影响分析
-- 直接影响: 
-- 间接影响: