ilaandClaude Opus 5
bfc0726c33
原有 4 个命令行入口（check_harness、sync_wiki_docs、new_task_archive、 export_task_archives）需要在多处文档分别描述，同步核心镜像还要按顺序跑 3 条命令。 合并为 dev_scripts/harness.py，提供 check / sync / archive / export 四个子命令， 各命令实现逻辑逐字取自原脚本，行为未改变；新增 sync --verify 一次完成 导出 → check --strict → 一致性校验。wiki_docs.py 作为库保持不变。 破坏性变更：4 个旧入口已删除，不保留兼容转发。已采用 DevHarness 的业务项目 升级基线时必须同步修改自己的命令与文档。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
60 lines
3.0 KiB
Markdown
60 lines
3.0 KiB
Markdown
# DevHarness
|
||
|
||
DevHarness 是一个以 Gitea 工单管理任务过程、以 Gitea Wiki 管理长期文档、以 Git 提交记录代码变更、由人负责确认和验收的 AI 辅助开发模板。
|
||
|
||
它约束的是开发过程，不限制项目使用 Python、Go、JavaScript 或其他技术栈。
|
||
|
||
## 工作闭环
|
||
|
||
```text
|
||
讨论需求或缺陷
|
||
-> 阅读代码并提出方案
|
||
-> 人工确认方案
|
||
-> 创建 Epic / MVP / 单元任务工单
|
||
-> Agent 实现并测试
|
||
-> 提交代码并更新工单
|
||
-> 人工验收
|
||
-> 归档 Wiki；任务快照仅在人工提出时导出
|
||
-> 关闭工单并更新父工单
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
1. 复制或克隆本仓库，并修改仓库名称。
|
||
2. 创建 Gitea 远端仓库并推送当前引导提交，启用工单和 Wiki。
|
||
3. 配置 `wiki-docs.json` 和安全访问方式；优先使用已配置的 Gitea MCP，MCP 不可用时才使用 Gitea API 并记录原因。令牌只通过环境变量或 MCP 安全配置提供。
|
||
4. 按 [新项目文档初始化](docs/07-new-project-documentation-setup.md) 查询线上 Wiki；`Home` 不存在时先创建并回读 `Home`，取得 revision 后再创建其他核心页面。
|
||
5. 把项目不可违反的安全规则写入根目录或子项目的 `AGENTS.md`。
|
||
6. 使用 `.gitea/issue_template/` 中的模板创建第一个 Epic、MVP 和单元任务。本地 `docs/` 的存在不能证明线上 Wiki 已初始化。
|
||
7. 开始产品代码前运行：
|
||
|
||
```powershell
|
||
python dev_scripts/harness.py sync --verify
|
||
```
|
||
|
||
新仓库在 Gitea 尚未建立前允许一次不关联工单的引导提交。远端和工单系统配置完成后，所有改变程序行为的工作都必须先有单元任务工单。
|
||
|
||
## 目录
|
||
|
||
```text
|
||
AGENTS.md Agent 的通用工作规则
|
||
CLAUDE.md Claude Code 的规则入口
|
||
.gitea/issue_template/ Epic、MVP、单元任务工单模板
|
||
docs/00-project-profile.md Wiki 项目档案的只读镜像
|
||
docs/01-workflow.md Wiki 开发工作流的只读镜像
|
||
docs/02-07*.md 代码地图、业务、验证、修改、排错和初始化镜像
|
||
docs/templates/task-archive.md Wiki 任务归档模板的只读镜像
|
||
docs/task/ 人工按需导出的 Wiki 任务归档快照
|
||
wiki-docs.json 核心 Wiki 页面到本地镜像的显式映射
|
||
dev_scripts/harness.py check / sync / archive / export 单一入口
|
||
dev_scripts/wiki_docs.py Gitea Wiki 客户端与镜像生成库
|
||
```
|
||
|
||
## 设计原则
|
||
|
||
- 人决定目标、范围和验收结果，Agent 负责检查、实现和验证。
|
||
- 工单记录实施过程，Wiki 保存长期有效的最终事实，`docs/` 默认保存核心镜像；任务归档快照按需导出。
|
||
- 一个单元工单只解决一个可独立测试和回退的问题。
|
||
- 实现提交与必要的核心文档镜像提交分开，便于审查与追溯。
|
||
- 凭据、个人数据和生产数据不得进入代码、工单或归档。
|