refactor: 项目档案改为按需读取并内联常用命令 (#22)
原规则要求每次任务开始前无条件阅读 docs/00-project-profile.md(约 2100 tokens, 不命中 prompt cache),但实际高频使用的只有常用命令表。 改为:无条件只读任务涉及目录的 AGENTS.md;项目档案按明确触发条件按需读取; 常用命令内联到 AGENTS.md,与项目档案保持一致。项目档案内容未改动。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -2,7 +2,24 @@
|
||||
|
||||
本仓库采用 DevHarness 工作流:Gitea 工单是任务过程的事实来源,Gitea Wiki 是长期开发文档和任务归档的事实来源,Git 是代码与版本绑定资料的变更记录。`docs/` 默认保存核心 Wiki 的只读镜像,`docs/task/` 只保存人工按需导出的任务归档快照。人负责确认方案与验收,Agent 负责检查、实现、测试和留下证据。
|
||||
|
||||
开始工作前先阅读 [项目档案](docs/00-project-profile.md) 和任务涉及目录中的 `AGENTS.md`。目录越深的规则越具体,但不得削弱上级安全规则。
|
||||
开始工作前先阅读任务涉及目录中的 `AGENTS.md`。目录越深的规则越具体,但不得削弱上级安全规则。
|
||||
|
||||
[项目档案](docs/00-project-profile.md) 按需阅读,不作为每次任务的固定前置。出现下列情况之一时必须读:需要环境、配置或凭据来源;需要确认目录边界;需要判断子项目与交付单元划分;需要 DevHarness 来源与基线;需要项目专用验收要求。只为查命令不必打开项目档案。
|
||||
|
||||
## 常用命令
|
||||
|
||||
所有命令默认从仓库根目录执行,与项目档案保持一致。
|
||||
|
||||
| 用途 | 命令 |
|
||||
|---|---|
|
||||
| 查看工作区 | `git status --short --branch` |
|
||||
| 检查模板结构 | `python dev_scripts/check_harness.py --strict` |
|
||||
| 运行单元测试 | `python -m unittest discover -s tests -v` |
|
||||
| 导出核心 Wiki 镜像 | `python dev_scripts/sync_wiki_docs.py` |
|
||||
| 检查核心 Wiki 镜像 | `python dev_scripts/sync_wiki_docs.py --check` |
|
||||
| 创建任务归档 | `python dev_scripts/new_task_archive.py 123 "修复登录超时"` |
|
||||
| 增量导出任务归档 | `python dev_scripts/export_task_archives.py` |
|
||||
| 全量导出任务归档 | `python dev_scripts/export_task_archives.py --all` |
|
||||
|
||||
## 1. 永久规则
|
||||
|
||||
|
||||
Reference in New Issue
Block a user