spec code | Notion

规范驱动的“计划与执行”（Plan & Execute）开发模式

requirements.md - 更加贴合实际需求的用户故事
design.md - 考虑到业务场景复杂性的系统架构
tasks.md - 包含必要技术细节的实现计划

graph LR
    A[用户想法] --> B[Kiro分析]
    B --> C[requirements.md\\n需求文档]
    B --> D[design.md\\n技术设计]
    B --> E[tasks.md\\n任务列表]
    C --> F[AI智能体执行]
    D --> F
    E --> F
    F --> G[高质量代码]

flowchart LR
    %% 项目初始化模块（左上）
    subgraph Init [项目初始化<br/>Steering Architect Mode]
        direction TB
        Init1[分析现有代码库]
        Init2[生成项目规则文件]
        Init3[产品愿景、技术栈、结构]
        Init4[创建项目级别规则]
    end

    %% 规划阶段模块（中上，分三列）
    subgraph Planner [规划阶段 - Planner Mode]
        direction LR

        subgraph Tas [Phase 3: Tasks]
            direction TB
            T1[任务分解]
            T2[依赖关系排序]
            T3[执行清单]
            T4[测试验证]
            T5[tasks.md]
        end
        
        
        subgraph Des [Phase 2: Design]
            direction TB
            D1[技术架构设计]
            D2[组件结构]
            D3[API接口设计]
            D4[Mermaid图表]
            D5[design.md]
        end

        
        subgraph Req [Phase 1: Requirements]
            direction TB
            R1[功能需求定义]
            R2[用户故事分解]
            R3[EARS语法标准]
            R4[验收标准]
            R5[requirements.md]
        end
        
    end

    %% 右侧 specs 模块（右上）
    subgraph Spec [specs/feature-name/]
        direction TB
        S1[requirements.md]
        S2[design.md]
        S3[tasks.md]
        S4[交互式流程:<br/>用户审查批准<br/>逐步完善规范<br/>确保理解一致]
    end

    %% 执行阶段模块（中下，纵向任务循环）
    subgraph Exec [执行阶段 - Executor Mode]
        direction TB
        E1[一次执行一个任务的循环]
        E2["1.读取 tasks.md 找未完成任务 [ ]"]
        E3["2.基于 requirements/design.md 理解任务"]
        E4["3.按规范执行代码修改"]
        E5["4.更新 tasks.md 标记完成 [x] 判断是否继续循环"]
        E1 --> E2 --> E3 --> E4 --> E5
    end

    %% 项目代码库模块（右下）
    subgraph Code [项目代码库]
        direction TB
        C1[实际代码修改]
        C2[文件创建/更新]
        C3[测试执行]
        C4[功能实现]
        C5[特点:<br/>文档化代码<br/>可维护性]
    end

    %% 连接关系
    Init --> Planner
    Planner --> Exec
    Planner --> Spec
    Exec --> Code

    %% 样式优化（可选，增强可视化）
    style Init fill:#FF5722,stroke:#E64A19,stroke-width:2,color:#fff
    style Planner fill:#673AB7,stroke:#5E35B1,stroke-width:2,color:#fff
    style Spec fill:#C8E6C9,stroke:#A5D6A7,stroke-width:2
    style Exec fill:#81C784,stroke:#66BB6A,stroke-width:2,color:#fff
    style Code fill:#F8BBD0,stroke:#F48FB1,stroke-width:2,color:#000