# AgentStudyC

**Repository Path**: LPZtalk/agent-study-c

## Basic Information

- **Project Name**: AgentStudyC
- **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-07-01
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自动 C++ 开发 Agent 学习项目

这是一个用于学习自动 C++ 开发 Agent 的教程型工程。项目从一个小型 C++ 日志库开始，逐步加入需求拆解、代码检索、修改计划、自动编译、自动测试、代码审查和交付文档更新等能力。

## 当前阶段

- 已初始化 C++ 日志库最小骨架。
- 已建立过程文档和交付文档的分离结构。
- 已建立“每个任务完成后同步更新文档”的工程规则。
- 已建立 Harness v0.1 规划型串联器，可根据需求生成一次开发规划运行包。

## 目录结构

```text
include/                 C++ 公共接口
src/                     C++ 实现代码
tests/                   测试代码
agent/                   后续放 Agent 角色代码
skills/                  后续放 Skill 定义、提示词和模板
harness/                 后续放流程控制、工具调用和验证闭环
runs/                    Harness 生成的本地运行包，默认不提交
docs/过程文档/           学习路线、需求规划、迭代记录
docs/交付文档/           当前准确的架构、接口和交付记录
```

## 构建与测试

```bash
cmake -S . -B build
cmake --build build
ctest --test-dir build -C Debug --output-on-failure
```

说明：Visual Studio 等多配置生成器需要在运行 CTest 时指定 `-C Debug` 或 `-C Release`；Ninja、Makefile 等单配置生成器可以省略 `-C`。

## Harness v0.1

```bash
python harness/run_planning.py "给 C++ 日志库增加日志级别过滤功能"
```

该命令会在 `runs/` 下生成 `开发规划.md` 和 `metadata.json`。v0.1 只负责读取项目规则、Skill 和项目定制文档并生成规划包，不调用 LLM、不修改代码、不生成 patch、不执行构建测试。

## 编译测试 Harness

```bash
python harness/run_verification.py
```

该命令读取 `project-profile.yaml` 中的验证步骤，自动执行 configure、build 和 unit_test，并在 `runs/` 下生成 `验证结果.md` 和 `verification-metadata.json`。当前不会自动修复失败，也不会自动执行文档一致性检查。

## 开发规则

1. 每完成一个最小功能，必须更新 `docs/过程文档/需求与迭代规划.md` 或 `docs/过程文档/迭代记录.md`。
2. 每完成一个开发任务，必须更新 `docs/交付文档/` 中对应的最终交付文档。
3. `docs/过程文档/` 可以记录计划、思考和迭代过程。
4. `docs/交付文档/` 只记录当前代码对应的准确事实。
5. 开发必须保持模块化、接口化、跨平台、可扩展、可维护和鲁棒性。