vibe-coding-cn/workflow/AGENTS.md

Workflow 目录 Agent 指南

workflow/ 存放可复用的工作流模板：把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。

目录结构（当前）

workflow/
├── AGENTS.md                         # 本文件（目录级行为准则）
├── README.md                         # workflow 总览
├── auto-dev-loop/                    # 全自动开发闭环（五步状态机）
│   ├── README.md
│   ├── CHANGELOG.md
│   ├── step1_需求输入.jsonl
│   ├── step2_执行计划.jsonl
│   ├── step3_实施变更.jsonl
│   ├── step4_验证发布.jsonl
│   ├── step5_总控与循环.jsonl
│   ├── .kiro/                        # Kiro 集成配置
│   ├── workflow_engine/              # 轻量状态机引擎（state + hook）
│   └── workflow-orchestrator/        # 编排技能文档与规范
└── canvas-dev/                       # Canvas 白板驱动开发工作流
    ├── README.md
    ├── prompts/
    ├── templates/
    └── examples/

操作规范

允许

• 新增工作流模板（新建 <workflow-name>/ 子目录）
• 迭代现有工作流的 README.md、提示词/模板/脚本
• 为工作流补齐最小可运行路径（输入 → 执行 → 产物）

禁止 / 不推荐

• 破坏现有工作流的“入口约定”（例如把 README.md / 关键提示词文件移走）
• 在脚本中写死个人环境路径（优先相对路径或通过参数注入）

工作流落地标准（建议）

• 必有：README.md（一页讲清：目的、输入输出、如何运行、失败怎么排）
• 有状态机/脚本的工作流：必须明确 唯一状态入口文件（例如 state/current_step.json）与产物落盘目录（例如 artifacts/）