architext 0.0.3 → 0.0.5

package/dist/templates/zh/briefs/_base.md

@@ -6,7 +6,7 @@
 
 ## 项目概述
 
-**项目名称**: 
+**项目名称**:
 **一句话描述**: [项目是什么、为谁服务、解决什么问题]
 **问题陈述**: [目标用户遇到的核心痛点？现有方案哪里不足？]
 
@@ -20,12 +20,27 @@
 
 ## 核心任务
 
-> MVP 必须实现的任务（建议 3-7 个），每项一句话描述预期行为。
+> 必须实现的任务，每项一段话描述预期行为。
 > 详细 Spec 在 `/archi.plan` 阶段定义，此处只需明确"做什么"。
 
-1. 
-2. 
-3. 
+1.
+2.
+3.
+
+---
+
+## 业务流程
+
+> 如果你的项目有明确的用户旅程或核心工作流，在此描述。
+> 不需要画图——用文字描述步骤即可，AI 会据此理解系统行为。
+> 没有的话留空，AI 会从核心任务中推导。
+
+<!-- 写法参考：
+### [流程名称]
+1. 用户 [动作] → 系统 [响应]
+2. 用户 [动作] → 系统 [响应]
+3. ...
+-->
 
 ---
 
@@ -36,7 +51,7 @@
 >
 > 写法参考：
 > - **[任务/页面名]**: 描述具体行为、流程、约束
-> - 可附截图/草图链接
+> - 可附截图/草图（见下方"设计资产"）
 
 ---
 
@@ -44,8 +59,8 @@
 
 > 已确定的直接填写。不确定的留空或写"推荐"，AI 会基于项目特征推荐。
 
-**项目类型**: [[__PROJECT_TYPE__]]
-<!-- archi init 自动填入；手动填写时参考 templates/archi-decompose-roadmap SKILL 中的类型表 -->
+**项目特征**: [[__PROJECT_TYPE__]]
+<!-- archi init 自动填入（逗号分隔的特征标签）；手动填写时从 ui/data/api/cli/lib/mobile/desktop/miniapp/extension/realtime/ai 中选择 -->
 **语言/运行时**: [例：TypeScript + Node.js 22]
 **核心框架**: [例：Next.js 15 / Fastify / Tauri]
 **包管理器**: [例：pnpm / npm / yarn / cargo]
@@ -62,7 +77,7 @@
 
 ## 工程规范
 
-> 团队已有的工程约定。不确定的留空，AI 会基于技术栈推荐合理默认值。
+> 已有的工程约定。不确定的留空，AI 会基于技术栈推荐合理默认值。
 
 **仓库形态**: [Monorepo (Turborepo/Nx/pnpm workspaces) / 单体仓库]
 **架构模式**: [例：MFA / FSD / Clean Architecture / 分层架构 / 无偏好（AI 推荐）]
@@ -78,14 +93,33 @@
 > AI 需要知道哪些东西已经存在——避免重复造轮子或做出冲突决策。
 
 **项目起点**: [全新项目 / 基于已有代码库（简述现状和技术债）]
-**设计资产**: [Figma 链接 / 设计稿截图 / 无（AI 自行设计）]
-**品牌规范**: [已有 Logo/配色/字体 → 描述或附链接 / 无]
 **已有 API/后端**: [接口文档链接 / 简述可用端点 / 无（需从零搭建）]
 **第三方服务**: [已确定使用的服务，例：Auth0, Stripe, AWS S3, Resend...]
 **现有数据**: [已有数据库/数据源？格式？需要迁移？/ 无]
 
 ---
 
+## 设计资产
+
+> 为 AI 提供视觉/设计输入，直接影响项目的 UI 和架构决策质量。
+> 两种方式提供文件：
+> 1. **本地文件**: 将文件放入 `brief-assets/` 目录，按下方格式引用
+> 2. **外部链接**: 直接填写 URL
+>
+> 引用格式: `- [语义标签] ./brief-assets/文件名`
+>
+> 写法参考:
+> - [竞品参考-首页] ./brief-assets/linear-dashboard.png
+> - [我的草图] ./brief-assets/sketch-v1.png
+> - [品牌色板] ./brief-assets/brand-colors.pdf
+> - [API 文档] ./brief-assets/api-spec.yaml
+> - [数据库 Schema] ./brief-assets/schema.sql
+
+**设计稿/截图**: [按上方格式引用本地文件 / Figma 链接 / 无（AI 自行设计）]
+**品牌规范**: [已有 Logo/配色/字体 → 引用文件或描述 / 无]
+
+---
+
 <!-- @slot:style -->
 
 ## 边界与约束
@@ -94,7 +128,6 @@
 - [例：本期不做国际化 / 不做移动端适配 / 不做付费功能]
 
 **硬性约束**:
-- **时间**: [例：4 周 MVP / 无硬性 deadline]
 - **兼容性**: [例：Chrome 90+ / Node 18+ / iOS 15+]
 - **性能**: [例：首屏 < 2s / API P99 < 500ms / 无特殊要求]
 - **合规/无障碍**: [例：WCAG 2.1 AA / GDPR / 无]
@@ -112,5 +145,4 @@
 
 ## 补充说明
 
-> 任何上述未涵盖的信息：背景故事、特殊需求、已有决策的原因、团队技术偏好等。
-
+> 任何上述未涵盖的信息：背景故事、特殊需求、已有决策的原因等。

package/dist/templates/zh/briefs/_modules.md

@@ -5,10 +5,37 @@
 <!-- @tech:data -->
 **数据库**: [例：PostgreSQL / MongoDB / SQLite]
 **ORM / Query Builder**: [例：Prisma / Drizzle / TypeORM]
+
+### 数据模型草案
+
+> 如果你已经知道核心数据实体和关系，在此描述。不需要写完整 Schema——列出实体名和关键字段即可。
+> AI 会在 `/archi.plan` 阶段据此生成详细的数据模型，此处只需明确"有什么数据"。
+> 没有的话留空，AI 会从核心任务中推导。
+
+<!-- 写法参考：
+- **用户 (User)**: email, name, role (admin/user), avatar
+- **文章 (Post)**: title, content, status (draft/published), author → User
+- **评论 (Comment)**: body, author → User, post → Post
+- User 1:N Post, Post 1:N Comment
+-->
+
 <!-- @end -->
 
 <!-- @tech:api -->
 **API 风格**: [例：RESTful / GraphQL / gRPC / tRPC]
+
+### 已有 API 端点
+
+> 如果已有后端 API（自建或第三方），在此列出核心端点。也可将完整文档放入 `brief-assets/`。
+> 没有的话留空。
+
+<!-- 写法参考：
+- `POST /auth/login` → 返回 JWT token
+- `GET /users/:id` → 用户详情
+- `POST /posts` → 创建文章（需认证）
+- 完整文档: [API 文档] ./brief-assets/api-spec.yaml
+-->
+
 <!-- @end -->
 
 <!-- @tech:cli -->
@@ -116,7 +143,7 @@
 **实时传输方案**: [例：Socket.io / 原生 WebSocket / SSE / WebRTC]
 **实时框架/托管**: [例：Ably / Pusher / Liveblocks / 自建]
 **房间/频道模型**: [例：按用户 ID 订阅 / 按文档 ID 房间 / 广播]
-**[?CRDT] 协作冲突解决**: [例：Yjs / Automerge / 不需要（仅广播）]
+**（仅CRDT项目） 协作冲突解决**: [例：Yjs / Automerge / 不需要（仅广播）]
 **离线支持**: [例：离线队列 + 重连同步 / 不需要]
 <!-- @end -->
 
@@ -125,7 +152,7 @@
 **AI 框架**: [例：Vercel AI SDK / LangChain / LlamaIndex / 无框架直调 API]
 **Tool/Function Calling**: [例：需要（列出工具名称）/ 不需要]
 **Memory 方案**: [例：向量数据库（pgvector/Pinecone）/ 滑动窗口历史 / 无]
-**[?MCP] MCP 协议**: [例：@modelcontextprotocol/sdk / 不需要]
+**（仅MCP项目） MCP 协议**: [例：@modelcontextprotocol/sdk / 不需要]
 **流式输出**: [例：SSE 流式 / 批量返回]
 <!-- @end -->
 

package/dist/templates/zh/docs/global/api_snapshot.json

@@ -0,0 +1,24 @@
+{
+  "endpoints": [
+    {
+      "method": "[GET | POST | PUT | DELETE | PATCH]",
+      "path": "[/resource/:id]",
+      "description": "[一句话描述端点职责]",
+      "auth": "[required | public | optional]",
+      "requestBody": "[schema 描述或 N/A]",
+      "responses": {
+        "200": "[成功响应结构描述]",
+        "[4xx]": "[ref: error_codes.json#ERR_CODE]"
+      },
+      "owner": "[FEAT-xxx | INF-xxx]"
+    }
+  ],
+  "protocolMapping": [
+    {
+      "statusCode": "[400 | 401 | 403 | 404 | 500 | ...]",
+      "code": "[ERR_CODE]",
+      "meaning": "[含义]",
+      "action": "[调用方行为: Toast / Redirect / Retry / ...]"
+    }
+  ]
+}

package/dist/templates/zh/docs/global/command_api.json

@@ -0,0 +1,26 @@
+{
+  "commands": [
+    {
+      "name": "[command-name]",
+      "aliases": ["[alias]"],
+      "description": "[一句话描述命令职责]",
+      "args": [
+        {
+          "name": "[arg-name]",
+          "required": true,
+          "description": "[参数说明]"
+        }
+      ],
+      "flags": [
+        {
+          "name": "--[flag-name]",
+          "short": "-[f]",
+          "type": "[string | boolean | number]",
+          "default": "[默认值或 null]",
+          "description": "[标志说明]"
+        }
+      ],
+      "owner": "[FEAT-xxx | INF-xxx]"
+    }
+  ]
+}

package/dist/templates/zh/docs/global/data_snapshot.json

@@ -1,5 +1,4 @@
 {
-  "scope": "[?Data]",
   "models": [
     {
       "name": "[ModelName]",

package/dist/templates/zh/docs/global/design_tokens.json

@@ -1,6 +1,5 @@
 {
   "_comment": "由 /archi.start 基于 Brief「风格与调性」和「视觉参考」生成。所有值须从 Brief 推导，禁直接复用任何模板默认值。",
-  "scope": "[?UI]",
   "status": "drafting",
 
   "aestheticDirection": {

package/dist/templates/zh/docs/global/dictionary.json

@@ -25,7 +25,7 @@
       "replaces": "[替代的原始 API, 如 console.log]"
     }
   ],
-  "components [?UI]": [
+  "components（仅ui项目）": [
     {
       "name": "[组件名]",
       "path": "[文件路径]",

package/dist/templates/zh/docs/global/env_registry.json

@@ -0,0 +1,12 @@
+{
+  "variables": [
+    {
+      "name": "[ENV_VAR_NAME]",
+      "required": true,
+      "default": null,
+      "description": "[用途说明]",
+      "example": "[示例值]",
+      "owner": "[FEAT-xxx | INF-xxx]"
+    }
+  ]
+}

package/dist/templates/zh/docs/global/error_codes.json

@@ -1,12 +1,4 @@
 {
-  "protocolMapping [?API]": [
-    {
-      "statusCode": "[400 | EXIT_1 | ...]",
-      "code": "[ERR_VALIDATION]",
-      "meaning": "[含义]",
-      "action": "[调用方行为: Toast / Exit / Retry / ...]"
-    }
-  ],
   "businessErrors": [
     {
       "module": "[MODULE]",

package/dist/templates/zh/docs/global/map.json

@@ -55,18 +55,38 @@
       },
       {
         "file": "design_tokens.json",
-        "role": "Visuals [?UI]",
+        "role": "Visuals （仅ui项目）",
         "content": "颜色、字体、间距变量"
       },
       {
         "file": "data_snapshot.json",
-        "role": "Data [?Data]",
+        "role": "Data （仅data项目）",
         "content": "数据库 Schema 镜像"
       },
       {
         "file": "error_codes.json",
         "role": "Errors",
-        "content": "错误码与协议契约"
+        "content": "业务错误码注册表"
+      },
+      {
+        "file": "api_snapshot.json",
+        "role": "API （仅api项目）",
+        "content": "HTTP 端点注册表与协议映射"
+      },
+      {
+        "file": "env_registry.json",
+        "role": "Env （仅api项目）",
+        "content": "运行时环境变量清单"
+      },
+      {
+        "file": "command_api.json",
+        "role": "Commands （仅cli项目）",
+        "content": "CLI 命令签名注册表"
+      },
+      {
+        "file": "public_api.json",
+        "role": "Exports （仅lib项目）",
+        "content": "库 / SDK 公共导出 API 注册表"
       }
     ]
   },
@@ -81,6 +101,11 @@
       "category": "UI/UX",
       "purpose": "任务级 UI 范围声明 — 引用 ui_context.md 中的屏幕 ID，指定本任务涵盖的屏幕/组件范围"
     },
+    {
+      "file": "design.md",
+      "category": "Technical Design",
+      "purpose": "仅Complex任务: 技术方案设计 — 核心机制的状态机/流水线/协议定义、参数表与不变量"
+    },
     {
       "file": "plan.json",
       "category": "Plan",

package/dist/templates/zh/docs/global/public_api.json

@@ -0,0 +1,12 @@
+{
+  "exports": [
+    {
+      "name": "[exportName]",
+      "type": "[function | class | type | constant | enum]",
+      "signature": "[TypeScript 签名]",
+      "description": "[一句话描述导出项职责]",
+      "stability": "[stable | experimental | deprecated]",
+      "owner": "[FEAT-xxx | INF-xxx]"
+    }
+  ]
+}

package/dist/templates/zh/docs/global/vision.md

@@ -40,7 +40,7 @@ description: Project Constitution: Vision, Personas, Principles & Boundaries.
 
 ---
 
-## 4. Design & Experience (设计与体验语言) [?UI]
+## 4. Design & Experience (设计与体验语言) （仅ui项目）
 
 > **Note:** 本节仅适用于有 UI 的项目。具体色值和圆角定义请严格参阅 `[[__DOCS_DIR__]]/global/design_tokens.json`。
 

package/dist/templates/zh/docs/prompts/audit.md

@@ -1,5 +1,5 @@
 <protocol_audit>
-  **Trigger**: `/archi.audit [id]`
+  **Trigger**: `/archi.audit [id]` | 自然语言触发时由 Workflow Dispatch 自动加载
   **Goal**: 独立深度代码审查。带 `<id>` 审查该任务的代码实现；无 `<id>` 执行项目级体检。不修改代码，仅输出审查报告与修复工单。
 
 <meta>
@@ -10,52 +10,40 @@
       2.  **Evidence-Based**: 每个发现须附文件路径、行号、代码片段。
       3.  **Actionable Output**: 每个问题须附推荐修复命令（`/archi.fix`, `/archi.edit` 等）。
       4.  **Vision Anchored**: 始终以 `vision.md` 为方向基准，检测偏离。
-      5.  **Report Persistence**: 审查结果须写入文件 — 任务级 → `tasks/<id>_*/audit.md`（覆盖），项目级 → `audits/YYYY-MM-DD.md`（按日期存档，同日覆盖）。
+      5.  **Report Persistence**: 审查结果须写入文件 — 任务级 → `tasks/<id>_*/audit.md`（覆盖），项目级 → `audits/YYYY-MM-DD.md`（按日期存档）。
+      6.  **IDE-Native First**: 利用 IDE 原生能力驱动执行节奏，本协议定义质量标准和检查点，不对抗 IDE 的规划/执行机制。
     </principles>
 </meta>
 
 <step_1_resolve>
-    **Role**: 系统分析师
     **Mode Gate**:
 
     | 输入 | 模式 | 后续步骤 |
     |:---|:---|:---|
-    | `/archi.audit <id>` | 任务级深度审查 | step_2_task → step_3_report |
-    | `/archi.audit` | 项目级体检 | step_2_project → step_3_report |
+    | `/archi.audit <id>` | 任务级深度审查 | step_2a_task → step_3_report |
+    | `/archi.audit` | 项目级体检 | step_2b_project → step_3_report |
 
     **任务级 — Resolve ID**:
-    1.  从 `[[__DOCS_DIR__]]/global/roadmap.json` 解析 `<id>` → Task Name、Slug、状态。
+    1.  从 roadmap.json 解析 `<id>` → Task Name、Slug、状态。
     2.  **Status Gate** — 仅 `active` 或 `done` 可审查:
 
         | 状态 | 处理 |
         |:---|:---|
         | `active` / `done` | 通过 |
-        | `pending` | 拒绝 — 无代码可审查，先运行 `/archi.plan` + `/archi.code` |
+        | `pending` | 拒绝 — 无代码可审查 |
         | `blocked` | 拒绝 — 前置依赖未完成 |
 
-    3.  **Load Context**:
-        - `[[__DOCS_DIR__]]/global/vision.md` — 项目方向基准
-        - `[[__DOCS_DIR__]]/tasks/<id>_<Slug>/spec.md` — 功能逻辑
-        - `[[__DOCS_DIR__]]/tasks/<id>_<Slug>/plan.json` — 任务清单
-        - `[[__DOCS_DIR__]]/tasks/<id>_<Slug>/ui.md` — 任务 UI 范围声明(如存在)
-        - [?UI] `[[__DOCS_DIR__]]/global/ui_context.md` — AI 屏幕索引（定位对应屏幕 ID）
-        - [?UI] `[[__DOCS_DIR__]]/global/ui_concept.html` — 只读视觉参考（#10 合规对比的视觉标准源）
-        - `[[__DOCS_DIR__]]/tasks/<id>_<Slug>/audit.md` — 上次审计报告(如存在，用于对比)
-        - `02_tech_stack.md` — 技术红线
-        - [?UI] `[[__DOCS_DIR__]]/global/design_tokens.json`
-        - [?Data] `[[__DOCS_DIR__]]/global/data_snapshot.json`
-    4.  读取该任务对应的所有代码文件。
+    3.  **Load**: vision.md（方向基准）+ task docs (spec/plan/ui) + 前次 audit.md（对比用）+ project context (tech_stack/design_tokens/data_snapshot/ui_context/ui_concept)。读取该任务对应的所有代码文件。
 
     **项目级 — Load Overview**:
-    1.  读取 `[[__DOCS_DIR__]]/global/vision.md`、`roadmap.json`、`map.json`。
-    2.  读取 `02_tech_stack.md`。
-    3.  扫描 `[[__DOCS_DIR__]]/tasks/` 目录结构。
-    4.  读取项目代码入口文件与关键模块。
+    1.  读取 vision.md、roadmap.json、map.json、02_tech_stack.md。
+    2.  扫描 tasks/ 目录结构。
+    3.  读取项目代码入口文件与关键模块。
 
-    **Output**: 审查范围与上下文清单。
+    **Output**: 审查范围与上下文清单。进入 step_2a_task 或 step_2b_project。
 </step_1_resolve>
 
-<step_2_task>
+<step_2a_task>
     **Role**: 首席审计官
     **Scope**: 任务级深度代码审查（仅 `/archi.audit <id>` 时执行）。
 
@@ -72,17 +60,17 @@
     | 7 | **Tech Stack 合规** | 对照 `02_tech_stack.md`：违禁模式、过时 API、硬编码 |
     | 8 | **安全性** | 敏感信息泄露、输入未校验、注入风险、权限检查 |
     | 9 | **性能** | 不必要全量导入/大循环/无用计算/内存泄漏/N+1 查询 |
-    | 10 | [?UI] **Design 合规** | 样式是否用 Token 定义的视觉模式；无硬编码魔法值；实现与 `ui_concept.html` 对应屏幕视觉一致 |
-    | 11 | [?Data] **数据一致性** | 字段名/类型与 `data_snapshot.json` 是否一致 |
-    | 12 | [?I18n] **I18n 合规** | 无硬编码字符串；须用 Key/字典引用 |
+    | 10 | （本任务涉及ui时） **Design 合规** | Token 使用；无硬编码魔法值；与 `ui_concept.html` 视觉一致 |
+    | 11 | （本任务涉及data时） **数据一致性** | 字段名/类型与 `data_snapshot.json` 一致 |
+    | 12 | （仅i18n项目） **I18n 合规** | 无硬编码字符串；须用 Key/字典引用 |
     | 13 | **Orphan .gitkeep** | 目录已有其他文件时仍存在 `.gitkeep` — 须删除 |
-    | 14 | **Spec-Code 漂移** | 代码中的接口/类型/行为是否与 `spec.md` 一致；手动变更是否已同步到文档 |
-    | 15 | [?UI] **UI 引用完整性** | `ui.md` 中的 `ref: ui_concept.html#S-XX` 指针是否仍然有效；被引用的屏幕/组件是否因 edit/revise 后已改名或删除 |
+    | 14 | **Spec-Code 漂移** | 接口/类型/行为与 `spec.md` 一致；手动变更已同步文档 |
+    | 15 | （本任务涉及ui时） **UI 引用完整性** | `ui.md` 中 `ref: ui_concept.html#S-XX` 指针是否仍有效 |
 
-    **Output**: 按维度分组的发现列表，每项含级别、位置、描述。
-</step_2_task>
+    **Output**: 按维度分组的发现列表，每项含级别、位置、描述。进入 step_3_report。
+</step_2a_task>
 
-<step_2_project>
+<step_2b_project>
     **Role**: 首席审计官
     **Scope**: 项目级健康体检（仅 `/archi.audit` 无参数时执行）。
 
@@ -90,22 +78,18 @@
     |:---|:---|:---|
     | 1 | **Vision 漂移** | `roadmap.json` 任务方向与 `vision.md` 是否一致 |
     | 2 | **架构一致性** | `map.json` vs 实际目录结构，有无漂移或未注册模块 |
-    | 3 | **Roadmap 健康度** | 一致性 + 进度统计 + 长期 blocked 任务 + 依赖环检测 |
+    | 3 | **Roadmap 健康度** | 一致性 + 进度统计 + 长期 blocked + 依赖环检测 |
     | 4 | **文档完整度** | 各 Task 是否有 spec.md + plan.json；有无孤儿目录 |
-    | 5 | **Tech Stack 全局合规** | 抽查关键入口与模块，检测全局性违规 |
+    | 5 | **Tech Stack 全局合规** | 抽查关键入口与模块 |
     | 6 | **跨 Task 一致性** | 重复逻辑、命名冲突、接口不一致 |
-    | 7 | **Orphan .gitkeep** | 目录已有其他文件时仍存在 `.gitkeep` — 须删除 |
+    | 7 | **Orphan .gitkeep** | 目录已有其他文件时仍存在 `.gitkeep` |
 
-    扫描后标注优先级，推荐需深度审查的 Task：
-    - `done` 但 plan 未全部完成的
-    - 代码量大但无测试的
-    - 长期 `active` 未推进的
+    扫描后推荐需深度审查的 Task（`done` 但 plan 未全完成 / 代码量大无测试 / 长期 `active`）。
 
-    **Output**: 项目健康概览 + 深度审查推荐列表。
-</step_2_project>
+    **Output**: 项目健康概览 + 深度审查推荐列表。进入 step_3_report。
+</step_2b_project>
 
 <step_3_report>
-    **Role**: 报告撰写员
     **Action**:
 
     **Issue Classification**:
@@ -123,26 +107,28 @@
       -> 推荐修复：/archi.fix <ID> <描述> 或 /archi.edit <ID> <描述>
     ```
 
-    **Action Routing** (根据问题类型推荐命令):
+    **Action Routing**:
 
     | 问题类型 | 推荐命令 |
     |:---|:---|
-    | Bug（逻辑错误、边界遗漏） | `/archi.fix <ID> <描述>` |
-    | Spec 缺漏（功能未完整实现） | `/archi.edit <ID> <补充描述>` |
-    | 架构级问题（全局违规） | `/archi.revise <描述>` |
-    | 功能未完成（plan 虚标 done） | `/archi.code <ID>` |
-    | 小问题（命名、注释、简化） | 下次 `/archi.code` 时一并处理 |
-
-    **Report Structure**:
-    1.  审查概要（模式、范围、日期）
-    2.  发现列表（按级别排序：CRITICAL → WARNING → INFO）
-    3.  统计摘要（各级别数量）
-    4.  修复工单汇总（可直接执行的命令列表）
-    5.  Next Steps 表格
+    | Bug | `/archi.fix <ID> <描述>` |
+    | Spec 缺漏 | `/archi.edit <ID> <补充描述>` |
+    | 架构级问题 | `/archi.revise <描述>` |
+    | 功能未完成 | `/archi.code <ID>` |
+    | 小问题 | 下次 `/archi.code` 时一并处理 |
+
+    **Pre-signoff Checklist** (写入文件前须逐项确认):
+    □ （任务级）15 个审查维度全部覆盖，不适用项标注 N/A（非静默跳过）
+    □ （项目级）7 个检查项全部评估
+    □ 每个 CRITICAL/WARNING 发现已附 `文件:行号` + 代码片段
+    □ 每个发现已附推荐修复命令（/archi.fix / /archi.edit 等）
+    □ 报告已写入对应文件（任务级: tasks/<id>/audit.md；项目级: audits/YYYY-MM-DD.md）
+
+    **Report Structure**: 审查概要 → 发现列表（CRITICAL → WARNING → INFO）→ 统计摘要 → 修复工单汇总 → Next Steps。
 
     **Write Report File**:
     - 任务级 → `[[__DOCS_DIR__]]/tasks/<id>_<Slug>/audit.md`（覆盖式）
-    - 项目级 → `[[__DOCS_DIR__]]/audits/YYYY-MM-DD.md`（按日期存档，同日覆盖）
+    - 项目级 → `[[__DOCS_DIR__]]/audits/YYYY-MM-DD.md`（按日期存档）
 
     **Output**: 完整审查报告（同时输出到对话和写入文件）。
 </step_3_report>