From 65ead42f36a8877b74ca432e7a3bb4fd10058b8c Mon Sep 17 00:00:00 2001 From: ila Date: Tue, 18 Aug 2026 21:26:29 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E9=A1=B9=E7=9B=AE=E6=A1=A3?= =?UTF-8?q?=E6=A1=88=E6=94=B9=E4=B8=BA=E6=8C=89=E9=9C=80=E8=AF=BB=E5=8F=96?= =?UTF-8?q?=E5=B9=B6=E5=86=85=E8=81=94=E5=B8=B8=E7=94=A8=E5=91=BD=E4=BB=A4?= =?UTF-8?q?=20(#22)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原规则要求每次任务开始前无条件阅读 docs/00-project-profile.md（约 2100 tokens， 不命中 prompt cache），但实际高频使用的只有常用命令表。 改为：无条件只读任务涉及目录的 AGENTS.md；项目档案按明确触发条件按需读取； 常用命令内联到 AGENTS.md，与项目档案保持一致。项目档案内容未改动。 Co-Authored-By: Claude Opus 5 --- AGENTS.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 8171658..9e82f4f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. 永久规则