# team-ai-harness

**Repository Path**: willenfoo/team-ai-harness

## Basic Information

- **Project Name**: team-ai-harness
- **Description**: 团队 AI 工程化体系（AI Harness）——> 面向软件工程的 AI Harness Framework
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-17
- **Last Updated**: 2026-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# team-ai-harness

#### 介绍

团队 AI 工程化体系（AI Harness）：团队共享的 AI 编码规范仓库，**工具无关**——同一套规则，无论使用 Qoder、Codex、Claude Code 还是其它 AI 开发工具，克隆初始化本工程后均可接入使用。

#### 软件架构

```
rules/              # 规范正文（单一事实源，纯 Markdown、工具无关）
└── logging.md      # Spring Boot 日志规范
```

#### 安装教程（各工具接入）

1. **Qoder**：把 `rules/` 下的 `.md` 复制到目标项目的 `.qoder/rules/` 目录，并在文件头补上 Qoder 触发元数据（frontmatter：`trigger: model_decision` + 一句话 `description` 含主题关键词）——`model_decision` 仅在相关任务时注入，控制 token 成本；
2. **Codex**：将 `rules/` 下规则内容（或文件路径引用）合入目标项目根目录的 `AGENTS.md`；
3. **Claude Code**：合入目标项目根目录的 `CLAUDE.md`；
4. **其它工具**：任何支持 Markdown 规则 / 上下文注入的 AI 工具均可直接引用 `rules/` 下文件。

#### 使用说明

1. 规则修订一律在本仓库进行（单一事实源），改完再同步到各项目对应目录；
2. 禁止反向修改项目内的副本，避免多处漂移；
3. 新增规则优先沿用现有形态：【强制】/【推荐】分级 + ❌✅ 正反例对照 + `model_decision` 触发。

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request