docs: 增加 Agent 效率与范围控制 (#4)

dev_scripts/check_harness.py

@@ -44,6 +44,11 @@ CORE_DOCUMENT_REQUIREMENTS = {
         "## 面向初级维护者的修改边界",
         "## 每个任务的文档影响",
         "## 稳定文档与任务归档",
+        "## 效率与范围控制",
+        "### 严格控制范围",
+        "### 渐进执行和修复",
+        "### 复用已验证事实",
+        "### 明确停止条件",
     ),
     "docs/02-architecture-and-code-map.md": (
         "## 项目定位",
@@ -165,6 +170,22 @@ def check_task_template(errors: list[str], root: Path = ROOT) -> None:
         errors.append(f"单元任务模板缺少：{section}")
 
 
+def check_agent_efficiency_rules(errors: list[str], root: Path = ROOT) -> None:
+    path = root / "AGENTS.md"
+    if not path.is_file():
+        return
+    content = path.read_text(encoding="utf-8")
+    required = (
+        "### 效率与范围控制",
+        "#### 严格控制范围",
+        "#### 渐进执行和修复",
+        "#### 复用已验证事实",
+        "#### 明确停止条件",
+    )
+    for section in missing_sections(content, required):
+        errors.append(f"AGENTS.md 缺少：{section}")
+
+
 def core_mapping_errors(configured_mappings: dict[str, str]) -> list[str]:
     errors: list[str] = []
     for page, expected_path in CORE_PAGE_PATHS.items():
@@ -231,6 +252,7 @@ def main() -> int:
     check_wiki_mirrors(errors)
     check_core_documents(errors)
     check_task_template(errors)
+    check_agent_efficiency_rules(errors)
     check_archives(errors)
 
     for warning in warnings: