# harness-driven-develop

**Repository Path**: c2harness/harness-driven-develop

## Basic Information

- **Project Name**: harness-driven-develop
- **Description**: 基于Harness的软件开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# harness-driven-develop

## 介绍

基于 Harness 的软件开发框架，实现 Agentic Coding 模式下的规范驱动开发流程。本项目提供完整的技能系统（Skills）和工作流（Workflows），支持从需求规格到代码实现的全生命周期管理。

### 核心特性

- **技能系统（Skills）**: 提供模块化的开发技能，包括文档治理、架构设计、接口设计、测试驱动开发等
- **工作流系统（Workflows）**: 定义标准化的开发流程，确保一致性和可验证性
- **文档治理（Doc-Gardening）**: 强制执行文档规范，确保 SSOT（单一数据源）原则
- **渐进式披露**: 控制上下文加载，避免信息过载
- **阶段控制（Gate System）**: 实现 spec → design → build 的强制流程约束

---

## 项目结构

```
harness-driven-develop/
├── .trae/
│   ├── rules/              # 规则定义
│   ├── skills/             # 技能实现
│   └── workflows/          # 工作流定义
├── docs/
│   ├── spec/               # 需求规格文档
│   ├── architecture/       # 架构设计文档
│   ├── design/             # 详细设计文档
│   ├── api/                # API 定义文档
│   ├── data_model/         # 数据模型文档
│   ├── templates/          # 文档模板
│   ├── reference/          # 参考文档
│   └── exec-plan/          # 执行计划
├── AGENTS.md               # 执行协议
└── README.md               # 项目说明
```

---

## 技能系统（Skills）

### 核心技能

| 技能名称 | 用途 |
|---------|------|
| `doc-gardening` | 文档治理，强制执行文档规范和 SSOT 原则 |
| `context-engineering` | 上下文管理，控制信息加载范围 |
| `planning-and-task-breakdown` | 任务拆解，将需求转化为可执行任务 |
| `api-and-interface-design` | 接口设计，定义 API 契约 |
| `source-driven-development` | 规范驱动开发，确保代码符合规范 |
| `test-driven-development` | 测试驱动开发，先写测试再实现 |
| `security-and-hardening` | 安全加固，识别和修复安全风险 |
| `debugging-and-error-recovery` | 调试与错误恢复 |
| `code-review-and-quality` | 代码审查与质量保证 |
| `performance-optimization` | 性能优化 |

### 技能优先级

```
doc-gardening        > ALL（文档操作强制）
design-workflow      > develop相关
develop-workflow     > 普通实现
通用coding行为       > 最低优先级
```

---

## 工作流系统（Workflows）

### 架构工作流（architecture-workflow）

从 spec 出发，构建系统架构设计：

1. **STEP 0**: Spec 验证
2. **STEP 1**: 上下文加载
3. **STEP 2**: 系统边界定义
4. **STEP 3**: 模块架构设计
5. **STEP 4**: 数据流与控制流建模
6. **STEP 5**: 依赖图构建
7. **STEP 6**: 部署架构
8. **STEP 7**: API 契约定义
9. **STEP 8**: 安全架构
10. **STEP 9**: 可观测性设计
11. **STEP 10**: 测试策略
12. **STEP 11**: 风险评估
13. **STEP 12**: 架构验证
14. **STEP 13**: 架构评审

### 设计工作流（design-workflow）

基于已有设计规格，完成详细设计：

1. **STEP 0**: 前置验证（Spec + Architecture）
2. **STEP 1**: 任务拆解与规划
3. **STEP 2**: API 与数据设计
4. **STEP 2.1**: 处理逻辑设计
5. **STEP 2.2**: 状态管理设计
6. **STEP 2.3**: 并发与一致性设计
7. **STEP 2.4**: 性能设计
8. **STEP 2.5**: 安全与可观测性设计
9. **STEP 2.6**: 错误处理设计
10. **STEP 2.7**: 测试覆盖设计
11. **STEP 3**: 文档结构化链接
12. **STEP 4**: 设计验证
13. **STEP 5**: 设计评审

### 开发工作流（develop-workflow）

基于设计文档完成开发实现：

1. **STEP 0**: 构建门禁验证
2. 遵循架构约束进行开发
3. 执行代码审查和安全扫描
4. 完成测试覆盖要求
5. 通过文档治理校验

---

## 文档模板

### 模板类型

| 模板 | 路径 | 用途 |
|------|------|------|
| 架构模板 | `docs/templates/architecture.template.md` | 系统架构设计模板 |
| 设计模板 | `docs/templates/design.template.md` | 详细设计模板 |

### 使用方式

```bash
# 基于模板创建文档
cp docs/templates/architecture.template.md docs/architecture/my-system.architecture.md
```

---

## 使用说明

### 基本流程

```
需求分析 → spec 编写 → 架构设计 → 详细设计 → 开发实现
     ↓          ↓          ↓           ↓          ↓
  doc-gardening 验证   architecture   design    develop
                        workflow      workflow  workflow
```

### 技能调用示例

```text
# 文档操作必须调用 doc-gardening
任何文档操作 → doc-gardening → 校验 → PASS/REJECT

# 设计任务调用 design-workflow
设计相关任务 → design-workflow → 完成设计

# 开发任务调用 develop-workflow
开发实现任务 → develop-workflow → 完成开发
```

### 阶段控制规则

1. **未完成 spec** → 禁止 design
2. **未完成 design** → 禁止 build
3. **design 未通过验证** → 禁止 build
4. **文档未通过 doc-gardening** → 禁止一切后续操作

### 执行协议

详见 [AGENTS.md](AGENTS.md)，包含完整的执行规则和约束。

---

## 安装与运行

```bash
# 克隆项目
git clone https://gitee.com/your-repo/harness-driven-develop.git

# 进入项目目录
cd harness-driven-develop

# 运行初始化脚本
.trae/init.sh
```

---

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码（遵循项目编码规范）
4. 新建 Pull Request
5. 通过代码审查

---

## 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。