cc-devflow 4.3.0 → 4.5.0

package/.claude/hooks/types/team-types.d.ts

@@ -1,238 +0,0 @@
-/**
- * [INPUT]: 无外部依赖
- * [OUTPUT]: 对外提供 Claude Team 集成的 TypeScript 类型定义
- * [POS]: hooks/types/ 的 Team 状态类型，被 teammate-idle-hook.ts 和 task-completed-hook.ts 消费
- * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
- */
-
-// =============================================================================
-// Teammate 状态类型
-// =============================================================================
-
-export type TeammateStatus = 'idle' | 'working' | 'blocked' | 'completed' | 'error';
-
-export interface TeammateState {
-  /** Teammate 唯一标识 (e.g., "dev-analyst", "spec-analyst") */
-  id: string;
-
-  /** Teammate 角色 (e.g., "developer", "analyst", "reviewer") */
-  role: string;
-
-  /** 当前状态 */
-  status: TeammateStatus;
-
-  /** 当前正在执行的任务 ID (e.g., "T001") */
-  currentTask: string | null;
-
-  /** 已完成的任务 ID 列表 */
-  completedTasks: string[];
-
-  /** 最后活跃时间 (ISO 8601) */
-  lastActiveAt: string;
-
-  /** 错误信息 (仅当 status === 'error') */
-  errorMessage?: string;
-}
-
-// =============================================================================
-// Team 状态类型
-// =============================================================================
-
-export type TeamMode = 'sequential' | 'parallel';
-
-export interface TeamState {
-  /** Team 执行模式 */
-  mode: TeamMode;
-
-  /** Team Lead 标识 */
-  lead: string;
-
-  /** 所有 Teammates 状态 */
-  teammates: TeammateState[];
-
-  /** 任务分配映射 (taskId -> teammateId) */
-  taskAssignments: Record<string, string>;
-
-  /** Team 创建时间 */
-  createdAt: string;
-
-  /** Team 最后更新时间 */
-  updatedAt: string;
-}
-
-// =============================================================================
-// Ralph Loop Team 模式类型
-// =============================================================================
-
-export interface TeammateRalphState {
-  /** 当前迭代次数 */
-  iteration: number;
-
-  /** 最后验证结果 */
-  lastVerifyResult: 'passed' | 'failed' | 'skipped';
-
-  /** 最后验证时间 */
-  lastVerifyAt?: string;
-
-  /** 最后失败记录 */
-  lastFailures?: FailureRecord[];
-}
-
-export interface FailureRecord {
-  command: string;
-  output: string;
-  timestamp: string;
-}
-
-export interface RalphLoopTeamState {
-  /** 是否启用 Ralph Loop */
-  enabled: boolean;
-
-  /** 每个 Teammate 的 Ralph 状态 */
-  teammates: Record<string, TeammateRalphState>;
-
-  /** 全局迭代次数 */
-  globalIteration: number;
-
-  /** 最大迭代次数 */
-  maxIterations: number;
-
-  /** 开始时间 */
-  startedAt: string;
-}
-
-// =============================================================================
-// 扩展的 orchestration_status.json 类型
-// =============================================================================
-
-export interface OrchestrationStatus {
-  /** 需求 ID */
-  reqId: string;
-
-  /** 需求标题 */
-  title?: string;
-
-  /** 当前状态 */
-  status: string;
-
-  /** 当前阶段 */
-  phase: string;
-
-  /** 已完成的步骤 */
-  completedSteps?: string[];
-
-  /** Git 分支名 */
-  branch?: string;
-
-  /** 创建时间 */
-  createdAt: string;
-
-  /** 更新时间 */
-  updatedAt: string;
-
-  // =========================================================================
-  // v4.7 新增: Team 状态
-  // =========================================================================
-
-  /** Team 状态 (仅在 Team 模式下存在) */
-  team?: TeamState;
-
-  /** Ralph Loop 状态 (支持多 Teammate) */
-  ralphLoop?: RalphLoopTeamState;
-
-  // =========================================================================
-  // 归档相关字段
-  // =========================================================================
-
-  /** 归档原因 */
-  archivedReason?: string;
-
-  /** 归档时间 */
-  archivedAt?: string;
-
-  /** 归档位置 */
-  archiveLocation?: string;
-
-  /** 归档前状态 */
-  statusBeforeArchive?: string;
-
-  /** Delta 数量 */
-  deltaCount?: number;
-}
-
-// =============================================================================
-// Hook 输入/输出类型
-// =============================================================================
-
-export interface TeammateIdleInput {
-  hook_event_name: 'TeammateIdle';
-  teammate_id: string;
-  teammate_role: string;
-  last_task_id?: string;
-  idle_reason: 'task_complete' | 'waiting_dependency' | 'no_tasks' | 'error';
-  cwd: string;
-  session_id: string;
-}
-
-export interface TeammateIdleOutput {
-  action: 'assign_task' | 'wait' | 'shutdown';
-  task_id?: string;
-  message?: string;
-}
-
-export interface TaskCompletedInput {
-  hook_event_name: 'TaskCompleted';
-  task_id: string;
-  task_subject: string;
-  completed_by: string;
-  completion_time: string;
-  cwd: string;
-  session_id: string;
-}
-
-export interface TaskCompletedOutput {
-  decision: 'accept' | 'reject';
-  reason: string;
-  next_actions?: string[];
-}
-
-// =============================================================================
-// quality-gates.yml Team 模式配置类型
-// =============================================================================
-
-export interface TeammateIdleConfig {
-  idle_checks?: VerifyCommand[];
-  assignment_strategy?: 'priority_first' | 'round_robin' | 'skill_match';
-  idle_timeout?: number;
-}
-
-export interface TaskCompletedConfig {
-  verify?: VerifyCommand[];
-  block_on_failure?: boolean;
-  max_retries?: number;
-}
-
-export interface RalphLoopTeamConfig {
-  enabled?: boolean;
-  scope?: 'teammate' | 'global';
-  teammate_verify?: Record<string, string[]>;
-  global_verify?: string[];
-  max_iterations_per_teammate?: number;
-  max_global_iterations?: number;
-}
-
-export interface VerifyCommand {
-  name?: string;
-  command: string;
-  required?: boolean;
-}
-
-export interface QualityGatesTeamConfig {
-  teammate_idle?: TeammateIdleConfig;
-  task_completed?: TaskCompletedConfig;
-  ralph_loop?: {
-    team_mode?: RalphLoopTeamConfig;
-    max_iterations?: number;
-    timeout_minutes?: number;
-  };
-}

package/.claude/rules/devflow-conventions.md

@@ -1,286 +0,0 @@
-# CC-DevFlow 工作流约定
-
-> **类型**: 工作流约定 (Workflow Conventions)
-> **适用**: CC-DevFlow 需求开发流程
-> **层级**: Rules Layer (具体约定和格式)
-> **前置**: 遵循 Constitution 和 Core Patterns
-
----
-
-## 🎯 核心约定
-
-### REQ-ID 格式规范
-- **格式**: `REQ-\d+` (例如: REQ-123, REQ-001)
-- **唯一性**: 在当前仓库范围内必须唯一
-- **禁止**: 重复使用已存在的 REQ-ID
-
-### 命令参数格式
-```bash
-# 标准格式
-/flow-new "REQ-123|支持用户下单|https://plan.example.com/Q1"
-
-# 多文档格式
-/flow-new "REQ-124|权限管理|https://spec.doc,https://api.doc"
-
-# 无外部文档
-/flow-new "REQ-125|数据导出"
-```
-
----
-
-## 📁 文件组织约定
-
-### 目录结构
-```text
-devflow/requirements/${reqId}/
-├── PRD.md                      # 产品需求文档
-├── UI_PROTOTYPE.html           # UI原型 ⚡️ 条件生成 (仅UI需求)
-├── EPIC.md                     # Epic 规划
-├── TASKS.md                    # 任务分解 (单文件管理所有任务)
-├── tasks/                      # 任务执行文档
-│   └── IMPLEMENTATION_PLAN.md  # dev-implementer 输出
-├── research/                   # 研究资料
-│   ├── ${reqId}_plan_1.md
-│   ├── ${reqId}_plan_2.md
-│   └── ui_design_strategy.md   # UI设计策略 (可选)
-├── TEST_PLAN.md                # 测试计划
-├── TEST_REPORT.md              # 测试报告
-├── SECURITY_PLAN.md            # 安全计划
-├── SECURITY_REPORT.md          # 安全报告
-├── RELEASE_PLAN.md             # 发布计划
-└── EXECUTION_LOG.md            # 执行日志
-```
-
-### 文档命名约定
-- **PRD 文件**: `PRD.md`
-- **Epic 文件**: `EPIC.md`
-- **Tasks 文件**: `TASKS.md` (所有任务集中在一个文件，通过 checkbox 标记完成状态)
-- **研究文件**: `${reqId}_plan_{序号}.md`
-- **测试报告**: `TEST_REPORT.md`
-- **执行日志**: `EXECUTION_LOG.md`
-
----
-
-## 🌿 Git 约定
-
-> Git 分支、worktree、PR、合并由用户自行管理，DevFlow 不参与 Git 拓扑管理。
-
----
-
-## 💬 提交信息约定
-
-### 提交格式
-```text
-{type}({reqId}): {taskTitle}
-
-{详细描述}
-
-- 实现功能点1
-- 实现功能点2
-
-Co-authored-by: Claude <claude@anthropic.com>
-```
-
-### 提交类型
-- `feat(REQ-xxx)`: 新功能
-- `fix(REQ-xxx)`: 错误修复
-- `docs(REQ-xxx)`: 文档更新
-- `test(REQ-xxx)`: 测试添加/修改
-- `refactor(REQ-xxx)`: 重构
-- `chore(REQ-xxx)`: 构建、配置等杂务
-
----
-
-## 🤖 子代理调用约定
-
-### 调用顺序 (7个阶段)
-```text
-1. flow-init      → 初始化需求结构
-   ↓
-2. flow-prd       → prd-writer (研究型) → PRD.md
-   ↓
-2.5 flow-ui       → ui-designer (研究型) → UI_PROTOTYPE.html ⚡️ 条件触发
-   ↓              仅在检测到UI需求时自动执行
-3. flow-epic      → planner (研究型) → EPIC.md + TASKS.md
-   ↓              如存在UI_PROTOTYPE.html, 自动集成UI上下文
-4. flow-dev       → dev-implementer (研究型, 每个任务) → IMPLEMENTATION_PLAN.md
-                  → main-agent (执行型) → 代码实现
-   ↓              前端任务会引用UI_PROTOTYPE.html
-5. flow-qa        → qa-tester (研究型) → TEST_PLAN.md
-                  → security-reviewer (研究型) → SECURITY_PLAN.md
-                  → main-agent (执行型) → 运行测试、安全扫描
-   ↓
-6. flow-release   → release-manager (研究型) → RELEASE_PLAN.md
-                  → main-agent (执行型) → 创建PR、合并
-```
-
-### 状态同步约定
-- 每个阶段完成后更新 `orchestration_status.json`
-- 每个任务完成后更新 `TASKS.md` 中的 checkbox (`- [ ]` → `- [x]`)
-- 所有重要操作记录到 `EXECUTION_LOG.md`
-
----
-
-## ⚠️ 错误处理约定
-
-### 错误分类
-1. **参数错误**: 命令格式、REQ-ID 格式等
-2. **环境错误**: Git状态、权限、依赖等
-3. **网络错误**: URL访问失败
-4. **质量闸错误**: 代码质量不达标
-5. **系统错误**: 子代理异常、文件操作失败
-
-### 错误恢复命令
-```bash
-# 从特定阶段继续
-/flow-restart "REQ-123" --from=prd
-/flow-restart "REQ-123" --from=dev
-/flow-restart "REQ-123" --from=qa
-```
-
-### 错误日志格式
-```yaml
----
-error_type: parameter_error
-timestamp: 2024-01-15T10:30:00Z
-req_id: REQ-123
-step: parameter_parsing
----
-
-# 错误详情
-参数格式不正确：缺少标题部分
-
-## 解决方案
-请使用正确格式：/flow-new "REQ-123|需求标题|计划URL"
-```
-
----
-
-## 📊 文档元数据约定
-
-### YAML Frontmatter 格式
-```yaml
----
-req_id: "REQ-123"
-title: "支持用户下单"
-created_at: "2024-01-15T10:00:00Z"
-updated_at: "2024-01-15T15:30:00Z"
-version: "1.0.0"
-status: "completed"
-author: "prd-writer"
----
-```
-
----
-
-## 🎯 性能指标约定
-
-### 时间要求
-- **整个流程**: 90% 情况下在 15 分钟内完成
-- **单个任务**: 实施时间不超过 5 分钟
-- **质量闸检查**: 不超过 2 分钟
-
-### 资源约束
-- **内存占用**: < 500MB (峰值)
-- **并发需求**: 支持 3 个并发需求
-- **文档数量**: 支持 1000 个需求文档
-
----
-
-## ⚙️ 配置约定
-
-### .claude/settings.json 配置项
-```json
-{
-  "devflow": {
-    "baseBranch": "main",
-    "autoApprove": false,
-    "qualityGate": {
-      "minCoverage": 80,
-      "strictMode": true
-    },
-    "templates": {
-      "customPrdTemplate": ".claude/templates/custom-prd.md"
-    }
-  }
-}
-```
-
-### 环境变量
-```bash
-# 调试模式
-export FLOW_DEBUG=1
-
-# 超时设置 (秒)
-export FLOW_TIMEOUT=300
-
-# 最小测试覆盖率
-export MIN_COVERAGE=80
-```
-
----
-
-## 🔧 工具集成约定
-
-### 钩子脚本
-- `pre-push-guard.sh`: 推送前质量检查
-- `markdown_formatter.py`: 文档格式化
-- `auto-progress-update.py`: 进度自动更新
-
-### 测试脚本
-- `.claude/tests/run-all-tests.sh`: 运行所有测试
-- `.claude/tests/scripts/test_*.sh`: 单个测试套件
-
----
-
-## 🛠️ 故障排除约定
-
-### 环境检查
-```bash
-# 检查 Git 状态
-git status
-
-# 检查 GitHub CLI
-gh auth status
-
-# 检查 npm 脚本
-npm run --silent
-
-# 检查权限
-ls -la .claude/
-```
-
-### 日志查看
-```bash
-# 查看执行日志
-tail -f devflow/requirements/REQ-123/EXECUTION_LOG.md
-
-# 查看错误日志
-tail -f .claude/logs/flow-*.log
-```
-
----
-
-## 📋 最佳实践清单
-
-### 开始新需求前
-- [ ] 确认 REQ-ID 唯一性
-- [ ] 准备完整的需求输入 (标题 + 可选URL)
-- [ ] 确保 Git 工作目录干净
-- [ ] 在 main 分支上启动
-
-### 开发过程中
-- [ ] 遵循 TDD 顺序 (Tests First → Implementation)
-- [ ] 每个任务完成后立即提交
-- [ ] 定期同步主分支
-- [ ] 及时更新文档
-
-### 发布前检查
-- [ ] 所有测试通过
-- [ ] 测试覆盖率 ≥ 80%
-- [ ] 安全扫描无高危问题
-- [ ] 文档完整且格式正确
-
----
-
-**重要提示**: 所有约定都是强制性的。这些约定确保 CC-DevFlow 工作流的一致性和可预测性。