# dev-flow-skills

**Repository Path**: NelsonLong/dev-flow-skills

## Basic Information

- **Project Name**: dev-flow-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dev-flow-skills

dev-flow 标准化开发流程的模块化技能组合包。面向 AI Agent 多实例协作场景，通过结构化流程替代无序交互。

## 核心特性

- **三档路由** — express（小改动）/ standard（默认）/ full（复杂需求），根据任务复杂度自动匹配流程深度
- **骨架+深度分离** — SKILL.md 精简骨架按需加载，references/deep/ 完整方法论深度加载
- **SOUL 状态感知** — dev-flow-task-node 贯穿全程，让无状态 AI 获得跨会话持久记忆
- **双轴审查** — Standards 轴（项目规范）与 Spec 轴（需求符合）独立评估，防止一个轴掩盖另一个
- **按需加载** — 只加载当前阶段需要的子技能，express ~3K token，standard ~8K，full ~15K

## 设计原则

1. **分级自适应性** — 框架该重时重，该轻时轻
2. **独立可用** — 每个子技能可独立激活，不依赖其他子技能
3. **核心精简** — dev-flow-core 控制路由和流程，子技能提供深度知识
4. **经验沉淀** — 带日期的具体教训，有"错误→正确"结构
5. **通用视角** — 第一人称描述分工，不绑定具体人名、项目或工具
6. **内容分层** — 骨架保留流程步骤，深度内容按需加载

## 快速使用

```
dev-flow express           # 快速流程：code → review → ship（小改动）
dev-flow                   # 标准流程：decide → code → review → fix → ship（默认）
dev-flow full              # 完整流程：discuss → decide → code → review → fix → ship
dev-flow autopilot         # 自动驾驶：从 Vault 任务节点发现目标并启动全链路
```

## 项目结构

```
dev-flow-skills/
├── skills/                    # 14 个 dev-flow 子技能
│   ├── dev-flow-core/         # 核心流程 — 路由器、阶段定义、跳转规则
│   ├── dev-flow-autopilot/    # 自动驾驶 — 目标发现、复杂度分析、流程路由
│   ├── dev-flow-discuss/      # 讨论阶段 — 需求澄清、领域语言构建
│   │   └── references/deep/   # Grill-Me 追问、教训案例
│   ├── dev-flow-decide/       # 决策阶段 — 方案选择、辩论模式
│   ├── dev-flow-code/         # 编码阶段 — TDD、委托模式、并行执行
│   │   └── references/deep/   # TDD 方法论、CLI/API 模式
│   ├── dev-flow-review/       # 审查阶段 — 双轴审查（规范+需求）
│   │   └── references/deep/   # 完整 checklist、续传协议
│   ├── dev-flow-fix/          # 修复阶段 — 6 阶段调试方法论
│   │   └── references/deep/   # 调试方法论详细步骤
│   ├── dev-flow-ship/         # 交付阶段 — 验收标准、持久化
│   ├── dev-flow-task-node/    # SOUL — 流程感知、任务节点 CRUD、多 Vault
│   │   └── references/deep/   # 感知协议、分诊、Vault 操作
│   ├── dev-flow-git/          # Git 管理 — 分支策略、PR 流程
│   │   └── references/deep/   # 分支和版本详细说明
│   ├── dev-flow-claude-ops/   # 协作会话操作 — 启动/截断/续传
│   │   └── references/deep/   # 故障排除、等待纪律
│   ├── dev-flow-patterns/     # 通用经验模式 — 第一性原理、陷阱
│   │   └── references/deep/   # 原理展开、陷阱案例
│   ├── dev-flow-templates/    # 模板和参考案例
│   ├── dev-flow-cli-patterns/ # CLI 应用开发规范
│   │   └── references/deep/   # 架构、服务层、安全、部署
│   └── dev-flow-architecture/ # 架构深化 — 浅模块发现、接缝分析
├── dependencies/              # 依赖技能（协作模式、代码审查等）
├── vault/                     # Vault 模板源
├── scripts/                   # 工具脚本（vault 初始化等）
├── docs/                      # 部署文档
├── CHANGELOG.md
└── README.md
```

## 六阶段流程

```
discuss(需求澄清) → decide(方案+分工) → code(TDD实现) → review(双轴审查) → fix(迭代修复) → ship(交付确认)
```

- **express** 跳过 discuss/decide，直接从 code 开始
- **standard** 跳过 discuss，从 decide 开始
- **full** 走完整六阶段

## 骨架+深度架构

每个技能由两部分组成：

- **SKILL.md（骨架）**：流程步骤、阶段流转、关联技能表。精简到 40-130 行，加载时只消耗核心 token
- **references/deep/（深度）**：完整方法论、教训案例、checklist 详细条目。按需加载，不进入默认上下文

骨架中通过 markdown 链接指向深度文件，需要时通过 `skill_view(name, file_path)` 加载。

## SOUL（dev-flow-task-node）

SOUL 是 dev-flow 的状态感知层，解决 AI Agent 无状态的本质缺陷：

- **感知三步法**：读取 → 感知 → 行动。进入任何阶段时自动恢复上下文
- **多 Vault 架构**：每个项目独立 Vault，自动发现（优先级：环境变量 > ./vault > git根/vault）
- **任务节点**：YAML frontmatter 定义 status/phase/priority/blocked_by，驱动流程流转

## 依赖技能

`dependencies/` 目录包含独立技能，被 dev-flow 体系引用但不内联：

- **协作模式**：collab-modes、collab-debate、collab-templates、collab-traps
- **代码审查**：code-review-and-quality、code-review-workflow
- **工程实践**：incremental-implementation、systematic-debugging、debugging-and-error-recovery、writing-plans
- **通用工具**：skill-creator、first-principles-thinking-protocol、prototype

## 版本历史

- **v0.5.0** — 三档路由机制、骨架+深度分离、项目特定知识清理
- **v0.4.0** — 模块化拆分、SOUL 状态感知、双轴审查、6 阶段调试方法论
- 详细变更见 `CHANGELOG.md`

## 部署

详见 `docs/deploy-on-new-machine.md`。

## 仓库

- **Gitee**: `git@gitee.com:NelsonLong/dev-flow-skills.git`
- **内网 Git**: `git@192.168.3.88:longxiang/dev-flow-skills.git`