fix(framework): 宪法+目录框架整改——统一权限体系、覆盖后端路径、补齐提示词、工作流闭环

- 权限矩阵: RL/R/W/RW 四态替代 ✅/❌，三文件语义对齐
- 目录重构: server/config/types 移入 src/，projects/*/src/ 全覆盖
- 提示词库: 新增 code-style.md / doc-template.md / bug-report.md
- 工作流: 8阶段→4阶段，新增 retry 循环 + escalation 升级规则
- 审核报告: reports/quality-reports/framework-review-2026-05-23.md

.ai/config/coder.json

@@ -1,23 +1,28 @@
 {
   "name": "Dev AI",
   "role": "代码开发者",
+  "description": "allowed_paths = 可写路径（含读）；read_only_paths = 只读路径；不在二者中的路径禁止访问。详细权限见 AGENTS.md 权限矩阵。",
   "responsibilities": [
     "编写业务代码",
     "生成技术文档",
-    "维护代码质量"
+    "定义验收标准",
+    "评估变更影响",
+    "维护共享资源"
   ],
   "allowed_paths": [
     "projects/*/src/",
     "projects/*/docs/",
     "shared/",
-    "review/*/task.md",
     "review/*/acceptance.md",
     "review/*/impact.md"
   ],
+  "read_only_paths": [
+    "review/*/task.md",
+    "review/*/feedback/"
+  ],
   "forbidden_paths": [
     "projects/*/tests/",
-    "reports/",
-    "review/*/feedback/"
+    "reports/"
   ],
   "prompt_templates": {
     "coding": ".ai/prompts/coding/",

.ai/config/tester.json

@@ -1,6 +1,7 @@
 {
   "name": "QA AI",
   "role": "测试工程师",
+  "description": "allowed_paths = 可写路径（含读）；read_only_paths = 只读路径；不在二者中的路径禁止访问。详细权限见 AGENTS.md 权限矩阵。",
   "responsibilities": [
     "编写测试用例",
     "执行测试",
@@ -13,11 +14,13 @@
     "review/*/acceptance.md",
     "review/*/feedback/"
   ],
+  "read_only_paths": [
+    "review/*/task.md"
+  ],
   "forbidden_paths": [
     "projects/*/src/",
     "projects/*/docs/",
     "shared/",
-    "review/*/task.md",
     "review/*/impact.md"
   ],
   "prompt_templates": {

.ai/config/workflow.json

@@ -11,33 +11,13 @@
       "name": "开发实现",
       "actor": "dev-ai",
       "input": "review/{task_id}/task.md",
-      "output": ["projects/*/src/", "projects/*/docs/"]
+      "output": ["projects/*/src/", "projects/*/docs/", "review/{task_id}/impact.md", "review/{task_id}/acceptance.md"]
     },
     {
-      "name": "影响评估",
-      "actor": "dev-ai",
-      "output": "review/{task_id}/impact.md"
-    },
-    {
-      "name": "验收标准定义",
-      "actor": "dev-ai",
-      "output": "review/{task_id}/acceptance.md"
-    },
-    {
-      "name": "测试设计",
+      "name": "测试验证",
       "actor": "qa-ai",
       "input": ["review/{task_id}/task.md", "review/{task_id}/acceptance.md"],
-      "output": "projects/*/tests/"
-    },
-    {
-      "name": "测试执行",
-      "actor": "qa-ai",
-      "output": ["reports/test-results/", "reports/reviews/"]
-    },
-    {
-      "name": "反馈提交",
-      "actor": "qa-ai",
-      "output": "review/{task_id}/feedback/round{round}.md"
+      "output": ["projects/*/tests/", "reports/test-results/", "review/{task_id}/feedback/round{round}.md"]
     },
     {
       "name": "验收确认",
@@ -45,9 +25,18 @@
       "input": ["review/{task_id}/feedback/", "reports/test-results/"]
     }
   ],
+  "retry": {
+    "max_rounds": 3,
+    "loop": ["测试验证", "开发实现"],
+    "escalation": {
+      "trigger": "第 3 轮测试仍有 BLOCKER 或 HIGH 级别 Bug",
+      "action": "暂停任务流转，等待人类负责人裁决"
+    },
+    "skip_acceptance_on_retry": true
+  },
   "ci_triggers": {
     "on_push_to_main": ["run-tests", "generate-reports"],
     "on_pr_open": ["run-tests", "code-review"],
     "on_task_update": ["notify-qa-ai"]
   }
-}
+}