# opendevflow-skills

**Repository Path**: programmergary/opendevflow-skills

## Basic Information

- **Project Name**: opendevflow-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenDevFlow Skills

OpenDevFlow Skills 是 OpenDevFlow AI 交付工作流的标准 Skill 集合。

这套 Skill 既可以被 OpenDevFlow 平台调用，也可以脱离平台在本地 AI 编码工具中独立运行。平台负责需求、工作流、权限、产物、日志和审批；Skill 负责定义每个阶段的 AI 工作方法、输入输出和质量门禁。

## Skill 体系

| Skill | 角色 | 阶段 |
| --- | --- | --- |
| `opendevflow-guide` | 流程引导 | 全流程 |
| `product-discovery` | 产品 | 需求规划 |
| `prd-authoring` | 产品 | 需求规划 |
| `product-design` | 产品设计 | 产品设计 |
| `openspec-design` | 架构 / 规格 | 产品设计 |
| `developer-planning` | 开发 | 程序开发 |
| `developer-delivery` | 开发 | 程序开发 |
| `code-review` | 开发审查 | 验收审查 |
| `qa-verification` | 测试 | 验收审查 |
| `delivery-summary` | 交付 | 交付归档 |

## 目录结构

```text
skills/
  skill-key/
    skill.json
    SKILL.md
    references/
    templates/
    scripts/
    assets/
schemas/
  skill.schema.json
docs/
  skill-spec.md
```

`skill.json` 是平台读取的机器元数据，`SKILL.md` 是 AI Agent 运行时读取的核心说明。

## 设计原则

- Skill 源码使用 Git 管理，支持 diff、review、tag 和回滚。
- 平台数据库只保存 Skill 元数据、版本、路径、校验值和启用状态。
- 每次 Skill Run 必须记录当时使用的 `key`、`version`、`checksum`。
- `opendevflow-guide` 是总入口，其他 Skill 是阶段能力。
- 平台展示 5 个一级阶段，内部通过 Skill Run 执行细分能力。

## 一级流程

```text
需求规划 -> 产品设计 -> 程序开发 -> 验收审查 -> 交付归档
```

## 使用方式

平台模式：

1. 平台根据当前工作流阶段选择默认 Skill。
2. 读取 `skill.json` 和 `SKILL.md`。
3. 结合需求上下文、历史产物和阶段目标生成 AI 会话。
4. 执行完成后保存 Skill Run、产物、日志和阶段结论。

独立模式：

1. 从 `opendevflow-guide` 开始。
2. 在本地维护 `.opendevflow/` 状态和产物。
3. 按阶段调用对应 Skill。
4. 完成质量检查后进入下一阶段。