> 中文 — dev-cycle 官方中文版本。

开发周期 (Dev Cycle) (中文)

> 目标： 从功能需求到已验证系统的结构化流程。 > 每一个开发工作都经历这8个阶段。

概述与目的

  +--------------------------------------------------------------+
  |                    DEVELOPMENT CYCLE                         |
  +--------------------------------------------------------------+
  |                                                              |
  |  Phase 1   Feature Requests (functional requirements)        |
  |     |                                                        |
  |     v                                                        |
  |  Phase 2   Check Current State (What already exists?)        |
  |     |                                                        |
  |     v                                                        |
  |  Phase 3   Functional Planning                               |
  |            (Workflows, Agents, Experts, Skills, Services)    |
  |     |                                                        |
  |     v                                                        |
  |  Phase 4   Implement Functional Frontend                     |
  |            (Skill files, workflow markdown, agent profiles)   |
  |     |                                                        |
  |     v                                                        |
  |  Phase 5   Plan and Align Backend                            |
  |            (CLI handlers, DB schema, API endpoints)          |
  |     |                                                        |
  |     v                                                        |
  |  Phase 6   Implement Backend Tasks                           |
  |            (Python code, tools, DB migrations)               |
  |     |                                                        |
  |     v                                                        |
  |  Phase 7   Technical Tests and Bugfixes                      |
  |            (B/O/E tests, bugfix protocol)                    |
  |     |                                                        |
  |     v                                                        |
  |  Phase 8   Functional and Feature Test: USE CASES            |
  |            (End-to-end validation from user perspective)      |
  |                                                              |
  +--------------------------------------------------------------+

  Core principles throughout:
  - Functional description first (before code)
  - CLI First (everything controllable via terminal)
  - Clear separation of user data and system data

阶段 1：功能需求 (Feature Requests / Functional Requirements)

内容： 收集并制定功能需求。

输入：

• 用户愿望、想法和问题
• 合作伙伴建议（LLM 助手）
• 来自用例的见解（反馈循环！）

输出：

• 任务系统中的任务（例如作为 Issue、Ticket 或 TODO 列表）
• 需求描述要什么 (WHAT)，而不是怎么做 (HOW)

规则：

• 始终以功能化方式描述需求（“用户可以执行 X”）
• 切勿以技术化方式描述（“为 X 实现 REST 端点”）
• 将用例作为需求来源（阶段 8 -> 阶段 1）

阶段 2：检查现状 (Check Current State)

内容： 清点现有功能。

检查清单：

  [ ] Search existing tools/scripts
  [ ] Check documentation/help on the topic
  [ ] Check existing skills/agents/services
  [ ] Check DB schema (if relevant)
  [ ] Check use cases - has something similar been tested?

输出：

• 记录已有内容、缺失内容以及需要扩展的内容
• 避免重复工作

阶段 3：功能规划 (Functional Planning)

内容： 在功能层面进行规划 —— 请勿立即编写代码。

规划层级：

| 层级 | 问题 | 产物 | |-------|----------|----------| | Workflow | 何时/如何进行协调？ | workflows/.md | | Agent | 由谁执行？ | agents/.txt | | Expert | 谁拥有领域知识？ | experts// | | Skill | 做什么？ | skills/.md | | Service | 技术上如何实现？ | services// |

规则：

• 先从功能角度思考，再从技术角度思考
• 工作流描述流程，而非实现细节
• 每个 Agent 都需要明确的配置文件
• Service 必须能在没有用户数据的情况下工作

阶段 4：实现功能前端 (Implement Functional Frontend)

内容： 创建 Skill 文件、工作流 Markdown 和 Agent 配置文件。

这里的“前端”是指功能描述层：

• 工作流文件 (.md)
• Agent 配置文件 (.txt)
• 专家知识
• 服务描述
• 帮助文件

输出：

• 所有功能描述均已存在
• LLM 合作伙伴能够阅读并理解工作流
• 功能层已被充分文档化

阶段 5：规划与对齐后端 (Plan and Align Backend)

内容： 将技术架构与功能前端对齐。

规划领域：

| 领域 | 问题 | 位置 | |------|----------|----------| | CLI Handlers | 哪些命令？ | handlers/.py | | DB Schema | 哪些表/列？ | schema/.sql | | API Endpoints | 哪些 GUI 端点？ | server.py | | Tools | 哪些 Python 脚本？ | tools/.py |

输出：

• 与功能前端对齐的技术方案
• 数据库 Schema 设计
• CLI 命令结构

阶段 6：实现后端任务 (Implement Backend Tasks)

内容： 编写 Python 代码、数据库迁移脚本、CLI 处理程序。

检查清单（每个任务）：

  [ ] Works without user data (empty DB)?
  [ ] CLI command available?
  [ ] Input can come from files/folders?
  [ ] Output goes to structured DB?
  [ ] Scan/import is repeatable (idempotent)?
  [ ] No hardcoded path?
  [ ] Tool registered and documented?
  [ ] Help file created?

阶段 7：技术测试与 Bug 修复 (Technical Tests and Bugfixes)

内容： 确保技术正确性。

测试类型 (B/O/E)：

| 类型 | 视角 | 描述 | |------|-------------|-------------| | B-Tests | 外部/自动化 | 自动化测试、CI/CD | | O-Tests | 功能性 (输入->输出) | 手动功能验证 | | E-Tests | 主观/体验 | UX 评估、易用性 |

关于 Bug：

• 应用 Bug 修复协议 (bugfix protocol)
• 遵守 20 分钟规则（20 分钟无进展则改变方法）
• 记录经验教训 (lessons learned)

阶段 8：功能与特性测试 —— 用例 (USE CASES)

内容： 从用户视角进行端到端 (End-to-end) 验证。

用例兼具以下两个目的：

1. 特性指标 —— 渴望什么功能？应该可以做到什么？
2. 测试场景 —— 从 A 到 Z 是否真正可行？

用例格式：

  USECASE_NNN: Short Title

  PRECONDITION: What must be in place?
  INPUT:        What does the user enter / what data?
  EXPECTED:     What should the result be?
  TESTS:        Which components are tested?

反馈循环 (Feedback Loop)：

• 失败的用例 -> 阶段 1 中的新任务
• 成功的用例 -> 已验证的特性
• 新的用例想法 -> 作为任务记录

总结：开发周期 (The Cycle)

  Phase 8 (Use Cases)
       |
       | New requirements / bugs
       v
  Phase 1 (Feature Requests)  -->  Phase 2 (Current State)
       ^                                    |
       |                                    v
  Phase 7 (Tests/Bugs)         Phase 3 (Functional Planning)
       ^                                    |
       |                                    v
  Phase 6 (Backend Code)       Phase 4 (Functional Frontend)
       ^                                    |
       |                                    v
       +──────────────────── Phase 5 (Backend Planning)

开发周期是一个循环：用例验证特性，同时也产生新的需求。

各阶段专用技能

| 阶段 | 专用技能 | 触发条件 | |-------|-------------------|---------| | 阶段 1-3 | Project bootstrapper（如果可用） | 创建新项目（全新开发 / greenfield） | | 阶段 2 | project-onboarding | 接管现有项目 | | 阶段 2-3 | docs-analysis | 根据代码核对需求文档 | | 阶段 5-6 | pipeline-optimizer | 重构/改造现有结构 | | 阶段 7 | bugfix-protocol | 系统化 6 阶段调试 | | 阶段 7-8 | bugsweep | 发布前的收敛性 Bug 排查 (Bug Sweep) |

如果你的技能集包含技能索引，请在其中搜索更多特定阶段的技能。

更新日志

1.1.0 (2026-06-13)

• 新增“各阶段专用技能”表格，其中包含 project-onboarding、docs-analysis、pipeline-optimizer、bugfix-protocol 以及 bugsweep 的引用

1.0.0 (2026-03-12)

• 从 BACH (dev-zyklus v1.0.0) 移植

创建时间：2026-01-28 | 移植时间：2026-03-12