architext 0.0.4 → 0.0.6

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

@@ -6,7 +6,7 @@
 
 ## 项目概述
 
-**项目名称**: 
+**项目名称**:
 **一句话描述**: [项目是什么、为谁服务、解决什么问题]
 **问题陈述**: [目标用户遇到的核心痛点？现有方案哪里不足？]
 
@@ -18,25 +18,40 @@
 
 ---
 
-## 核心任务
+## 功能需求
 
-> MVP 必须实现的任务（建议 3-7 个），每项一句话描述预期行为。
-> 详细 Spec 在 `/archi.plan` 阶段定义，此处只需明确"做什么"。
+> 必须实现的核心能力，描述"做什么"而非"怎么做"。
+> AI 会据此分解为具体的实现任务，此处只需明确业务目标。
 
-1. 
-2. 
-3. 
+-
+-
+-
+
+---
+
+## 业务流程
+
+> 如果你的项目有明确的用户旅程或核心工作流，在此描述。
+> 不需要画图——用文字描述步骤即可，AI 会据此理解系统行为。
+> 没有的话留空，AI 会从核心功能中推导。
+
+<!-- 写法参考：
+### [流程名称]
+1. 用户 [动作] → 系统 [响应]
+2. 用户 [动作] → 系统 [响应]
+3. ...
+-->
 
 ---
 
 ## 已有设计决策
 
-> 如果你对某些任务/页面/流程已有明确想法，在此描述。AI 在后续 plan 阶段会以此为准，不会推翻。
+> 如果你对某些功能/页面/流程已有明确想法，在此描述。AI 在后续 plan 阶段会以此为准，不会推翻。
 > 没有的话留空即可。
 >
 > 写法参考：
-> - **[任务/页面名]**: 描述具体行为、流程、约束
-> - 可附截图/草图链接
+> - **[功能/页面名]**: 描述具体行为、流程、约束
+> - 可附截图/草图（见下方"设计资产"）
 
 ---
 
@@ -62,13 +77,20 @@
 
 ## 工程规范
 
-> 团队已有的工程约定。不确定的留空，AI 会基于技术栈推荐合理默认值。
+> 已有的工程约定。不确定的留空，AI 会基于技术栈推荐合理默认值。
 
 **仓库形态**: [Monorepo (Turborepo/Nx/pnpm workspaces) / 单体仓库]
 **架构模式**: [例：MFA / FSD / Clean Architecture / 分层架构 / 无偏好（AI 推荐）]
 **目录结构**: [已有明确结构 → 简述关键目录 / 无（AI 基于架构模式生成）]
 **分支策略**: [例：Trunk-based / Git Flow / GitHub Flow]
 **Commit 规范**: [例：Conventional Commits (feat/fix/chore) / 自定义 → 简述]
+
+**AI Git 工作流** (AI 执行 `/archi.code` 时的提交约定):
+- **自动提交**: [是 - 每个 Task 完成后自动 git commit / 否 - 仅生成 commit message，用户手动提交]
+- **提交粒度**: [Per Task - 每个 Task 一个 commit / Per Phase - 每个 Phase 一个 commit / 按需]
+- **分支策略**: [直接在 main 分支工作 / 每个 Task 新建分支 `feat/{task-id}`]
+- **自动推送**: [是 / 否]
+
 **测试偏好**: [例：Vitest / Jest / pytest / 无特殊要求]
 
 ---
@@ -78,14 +100,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 +135,6 @@
 - [例：本期不做国际化 / 不做移动端适配 / 不做付费功能]
 
 **硬性约束**:
-- **时间**: [例：4 周 MVP / 无硬性 deadline]
 - **兼容性**: [例：Chrome 90+ / Node 18+ / iOS 15+]
 - **性能**: [例：首屏 < 2s / API P99 < 500ms / 无特殊要求]
 - **合规/无障碍**: [例：WCAG 2.1 AA / GDPR / 无]
@@ -105,12 +145,11 @@
 
 | 参考项目 | 参考维度 |
 |:---|:---|
-| [例：Linear] | [交互体验、任务管理逻辑] |
+| [例：Linear] | [交互体验、功能管理逻辑] |
 | | |
 
 ---
 
 ## 补充说明
 
-> 任何上述未涵盖的信息：背景故事、特殊需求、已有决策的原因、团队技术偏好等。
-
+> 任何上述未涵盖的信息：背景故事、特殊需求、已有决策的原因等。

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 -->
@@ -44,7 +71,7 @@
 
 ### 视觉参考 (Visual Reference)
 
-> 为 AI 提供审美输入，直接影响 `ui_concept.html` 的视觉质量。
+> 为 AI 提供审美输入，直接影响 `screens/` 目录下各屏幕原型的视觉质量。
 > 以下任填一项即有效，填得越多 AI 越能还原你的期望风格。
 
 **竞品/灵感截图**: [可粘贴图片 / Figma 链接 / URL]

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

@@ -0,0 +1,40 @@
+{
+  "errorPatterns": {
+    "_comment": "错误模式：{ id: 唯一标识, watchFor: [执行前需警惕的场景], matchWhen: [报错后匹配的关键词], cause: 根本原因, solution: 解决方案, lesson: 教训/原则 }。AI解决错误后在此追加",
+    "examples": [
+      {
+        "id": "build-vite-config-missing",
+        "watchFor": ["运行 npm run build", "修改 vite.config.ts"],
+        "matchWhen": ["ENOENT", "vite.config", "Cannot find module"],
+        "cause": "配置文件被误删或 node_modules 未安装",
+        "solution": "检查文件是否存在，运行 npm install 重装依赖",
+        "lesson": "修改配置前备份，定期确认 node_modules 完整"
+      },
+      {
+        "id": "type-import-assertion-deprecated",
+        "watchFor": ["导入 JSON 文件"],
+        "matchWhen": ["assert", "SyntaxError", "import", "type"],
+        "cause": "Node.js 18+ 废弃了 import assert 语法，改用 import attributes",
+        "solution": "assert { type: 'json' } 改为 with { type: 'json' }",
+        "lesson": "关注 Node.js 版本更新，import JSON 时确认语法版本"
+      }
+    ]
+  },
+  "checkpoints": {
+    "_comment": "检查点：{ before: 执行前匹配的操作描述, check: [要检查的 errorPatterns.id 列表] }。AI根据 watchFor 场景自动生成",
+    "examples": [
+      {
+        "before": "运行 npm run build",
+        "check": ["build-vite-config-missing"]
+      },
+      {
+        "before": "修改配置文件",
+        "check": ["build-vite-config-missing"]
+      },
+      {
+        "before": "导入 JSON 文件",
+        "check": ["type-import-assertion-deprecated"]
+      }
+    ]
+  }
+}

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

@@ -1,119 +1,49 @@
 {
-  "governance": {
-    "coreRules": [
+  "directoryMapping": {
+    "_comment": "代码目录 ↔ 模块映射：{ path: 目录路径, module: 模块名, responsibility: 职责描述 }",
+    "examples": [
       {
-        "file": "00_system.md",
-        "role": "System Role",
-        "when": "每次对话开始时 (身份设定, 核心原则)"
+        "path": "src/features/auth",
+        "module": "auth",
+        "responsibility": "用户认证、登录、注册"
       },
       {
-        "file": "01_workflow.md",
-        "role": "SOP",
-        "when": "决定当前任务流程 (Task vs Fix) 与验收标准"
-      },
-      {
-        "file": "02_tech_stack.md",
-        "role": "Tech Stack",
-        "when": "技术选型、代码规范、工程治理标准"
-      },
-      {
-        "file": "03_data_governance.md",
-        "role": "Data Governance",
-        "when": "读写全局 JSON 数据文件时"
-      },
-      {
-        "file": "04_cli_tools.md",
-        "role": "CLI Reference",
-        "when": "执行 Terminal Gate 命令时 (npx archi task/plan/render 语法速查)"
-      },
-      {
-        "file": "99_context_glue.md",
-        "role": "Context Bridge",
-        "when": "触碰代码时，自动关联上下文文档"
+        "path": "src/features/todos",
+        "module": "todo",
+        "responsibility": "待办事项 CRUD"
       }
-    ],
-    "globalReference": [
-      {
-        "file": "roadmap.json",
-        "role": "Roadmap",
-        "content": "进度追踪、里程碑、技术债管理"
-      },
-      {
-        "file": "vision.md",
-        "role": "Vision",
-        "content": "愿景、北极星指标、设计哲学"
-      },
-      {
-        "file": "map.json",
-        "role": "Map (本文件)",
-        "content": "目录结构、文件索引、逻辑拓扑"
-      },
-      {
-        "file": "dictionary.json",
-        "role": "Dictionary",
-        "content": "业务术语、公共组件注册表"
-      },
-      {
-        "file": "design_tokens.json",
-        "role": "Visuals （仅ui项目）",
-        "content": "颜色、字体、间距变量"
-      },
-      {
-        "file": "data_snapshot.json",
-        "role": "Data （仅data项目）",
-        "content": "数据库 Schema 镜像"
-      },
-      {
-        "file": "error_codes.json",
-        "role": "Errors",
-        "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 命令签名注册表"
-      },
+    ]
+  },
+  "logicalTopology": {
+    "_comment": "逻辑拓扑：{ module: 模块名, layer: 层(layer/domain/interface/infrastructure), depends: [依赖模块] }",
+    "examples": [
+      { "module": "auth", "layer": "domain", "depends": ["user-repo"] },
+      { "module": "todo", "layer": "domain", "depends": ["auth", "todo-repo"] }
+    ]
+  },
+  "criticalUserJourneys": {
+    "_comment": "关键用户旅程：{ journey: 旅程名, steps: [步骤], owner: 归属任务ID }",
+    "examples": [
       {
-        "file": "public_api.json",
-        "role": "Exports （仅lib项目）",
-        "content": "库 / SDK 公共导出 API 注册表"
+        "journey": "用户注册登录",
+        "steps": ["访问首页", "点击注册", "填写表单", "提交验证", "登录成功"],
+        "owner": "FEAT-AUTH"
       }
     ]
   },
-  "featureDocs": [
-    {
-      "file": "spec.md",
-      "category": "Specification",
-      "purpose": "业务逻辑、算法、验收标准 (Logic)"
-    },
-    {
-      "file": "ui.md",
-      "category": "UI/UX",
-      "purpose": "任务级 UI 范围声明 — 引用 ui_context.md 中的屏幕 ID，指定本任务涵盖的屏幕/组件范围"
-    },
-    {
-      "file": "design.md",
-      "category": "Technical Design",
-      "purpose": "仅Complex任务: 技术方案设计 — 核心机制的状态机/流水线/协议定义、参数表与不变量"
-    },
-    {
-      "file": "plan.json",
-      "category": "Plan",
-      "purpose": "详细步骤拆解与测试用例 (Execution)"
-    }
-  ],
-  "directoryMapping": [],
-  "logicalTopology": [],
-  "criticalUserJourneys": [],
-  "featureRelations": []
+  "featureRelations": {
+    "_comment": "影响关联关系，以网状结构组织：{ group: 网名, members: [成员文件], rule: 变更规则 }",
+    "examples": [
+      {
+        "group": "UI 协议",
+        "members": [
+          "prompts/ui.md",
+          "skills/archi-ui-wireframe/SKILL.md",
+          "prompts/start.md",
+          "prompts/inherit.md"
+        ],
+        "rule": "UI 协议与 Skill 强关联，变更需互相检查"
+      }
+    ]
+  }
 }

package/dist/templates/zh/{rules/04_cli_tools.md → docs/global/references/cli_reference.md}

@@ -1,10 +1,3 @@
----
-description: CLI Reference Manual. Working directory rule and command syntax for npx archi task/plan/render.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
 # CLI Reference
 
 > **Role**: 命令速查手册。提供 `npx archi` 系列命令的语法与参数，供 Terminal Gate 执行时查阅。

package/dist/templates/zh/{rules/02_tech_stack.md → docs/global/tech_stack.md}

@@ -1,10 +1,3 @@
----
-description: Technical Standards & Technology Stack. Contains language versions, framework choices, coding conventions, naming rules, and forbidden patterns. Consult when writing code.
-globs: **/*
-applyTo: **/*
-alwaysApply: true
----
-
 # Tech Stack & Engineering Standards: [项目名称]
 
 > **Role:** The "Law" of the codebase. Defines tools, structure, and engineering workflows.
@@ -15,7 +8,7 @@ alwaysApply: true
 ## 1. Global Mandates (全局红线)
 * **No Hardcoding:** 所有的密钥、API地址必须使用环境变量，严禁硬编码。
 * **No Dead Code:** 提交的代码必须是干净的，严禁保留注释掉的代码块或无用的 `TODO`。
-* **Comments for Why:** 注释解释“为什么这么做”（业务背景），而不仅仅是“做了什么”。
+* **Comments for Why:** 注释解释"为什么这么做"（业务背景），而不仅仅是"做了什么"。
 
 ---
 
@@ -51,23 +44,19 @@ alwaysApply: true
 ---
 
 <!-- ═══════ 以下为固定协议（禁修改） ═══════ -->
-## 4. UI Protocol: ITP v3.0 (Dual-Artifact) [可选 - 仅适用于有 UI 的项目]
+## 4. UI Protocol: ITP v3.0 (Tri-Artifact) [可选 - 仅适用于有 UI 的项目]
 <!-- 核心 UI 描述协议 -->
 > **Note:** 如果项目没有 UI（如 CLI、Backend API、Library），可以删除此章节。
 
-### 4.1 Dual-Artifact Strategy (双制品策略)
-
-UI 制品层级：
+### 4.1 Tri-Artifact Strategy (三制品策略)
 
 | 制品 | 格式 | 读者 | 职责 |
 |:---|:---|:---|:---|
-| `ui_concept.html` | 单文件 HTML | 人类 (浏览器) | **全局视觉真相源** — 所有屏幕的线框图/着色稿 |
-| `ui_context.md` | 结构化 Markdown | AI (plan/code/audit/edit) | **AI 屏幕索引** — 屏幕 ID/路由/状态/导航关系/共享组件轻量清单 |
-| `ui.md` | ITP v3.0 DSL | AI (code/audit) | 任务级 UI 范围声明 — 指定本任务涵盖的屏幕/组件 |
-- `ui_concept.html` 由 `archi-ui-wireframe` Skill 生成，覆盖项目所有用户可见屏幕；仅供人类在浏览器预览
-- `ui_context.md` 由同一 Skill 同步生成，是 AI 命令读取 UI 结构信息的唯一入口；禁手动修改
-- `ui.md` 仅声明"本任务负责 ui_context.md 中的哪些屏幕/状态"，禁重定义全局布局
-- code 阶段以 `ui.md`（任务设计）+ `ui_context.md`（结构/导航）+ `design_tokens.json`（视觉约束）为准；同时以 `ui_concept.html` 为**只读视觉参考**校准布局，用**项目自身技术栈**实现等价视觉效果
+| `screens/` | 多文件 HTML (`index.html` + `S-XX.html` + `_shared.css`) | 人类 (浏览器) | **全局视觉真相源** — `/archi.ui` 触发 Skill 生成；每个屏幕独立预览 |
+| `ui_context.md` | 结构化 Markdown | AI (plan/code/audit/edit) | **AI 屏幕索引** — AI 读取 UI 结构的唯一入口；由同一 Skill 同步生成；禁手动修改 |
+| `ui.md` | ITP v3.0 DSL | AI (code/audit) | 任务级 UI 范围声明 — 仅声明本任务负责的屏幕/状态，禁重定义全局布局 |
+
+- code 阶段以 `ui.md` + `ui_context.md` + `design_tokens.json` 为准；`screens/S-XX.html` 为**只读视觉参考**，用**项目自身技术栈**实现等价效果
 
 ### 4.2 Naming (PrefixFunction)
 组件命名须遵循 `前缀+功能` 格式：
@@ -190,4 +179,4 @@ UI 制品层级：
 
 ### Auth & Access (认证与权限) （仅ui或api项目）
 * **Mechanism:** [例如：JWT + RBAC / Session + Owner Only / API Key]
-* **Rationale:** [例如：多角色后台管理系统，需细粒度权限控制]
+* **Rationale:** [例如：多角色后台管理系统，需细粒度权限控制]

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

@@ -77,6 +77,6 @@ description: Project Constitution: Vision, Personas, Principles & Boundaries.
 **Trigger**: 仅在项目初始化 (`/archi.start`) 或重大战略转型 (`/archi.revise`) 时修改。
 
 **Action**:
-1.  **Alignment**: 确保 Section 3 (Principles) 与 `02_tech_stack.md` 中的技术选型不冲突。
+1.  **Alignment**: 确保 Section 3 (Principles) 与 `tech_stack.md` 中的技术选型不冲突。
 2.  **Completeness**: 必须填满所有 `[ ]` 占位符，严禁保留 "Example" 字样。
 3.  **Consistency**: 所有的 Task Spec (`.spec.md`) 都必须引用此文件的 Vision 以确保不跑题。

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/screens/)。读取该任务对应的所有代码文件。
 
     **项目级 — Load Overview**:
-    1.  读取 `[[__DOCS_DIR__]]/global/vision.md`、`roadmap.json`、`map.json`。
-    2.  读取 `02_tech_stack.md`。
-    3.  扫描 `[[__DOCS_DIR__]]/tasks/` 目录结构。
-    4.  读取项目代码入口文件与关键模块。
+    1.  读取项目上下文（vision、roadmap、tech_stack、map），详见 00_system.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>` 时执行）。
 
@@ -69,20 +57,20 @@
     | 4 | **逻辑正确性** | 业务逻辑错误、矛盾、遗漏分支、状态机缺陷 |
     | 5 | **Bug 猎杀** | 空值/undefined、竞态、资源泄漏、死循环、off-by-one |
     | 6 | **错误处理** | 吞错、静默失败、错误传播链完整性、用户可见反馈 |
-    | 7 | **Tech Stack 合规** | 对照 `02_tech_stack.md`：违禁模式、过时 API、硬编码 |
+    | 7 | **Tech Stack 合规** | 对照 `tech_stack.md`：违禁模式、过时 API、硬编码 |
     | 8 | **安全性** | 敏感信息泄露、输入未校验、注入风险、权限检查 |
     | 9 | **性能** | 不必要全量导入/大循环/无用计算/内存泄漏/N+1 查询 |
-    | 10 | （本任务涉及ui时） **Design 合规** | 样式是否用 Token 定义的视觉模式；无硬编码魔法值；实现与 `ui_concept.html` 对应屏幕视觉一致 |
-    | 11 | （本任务涉及data时） **数据一致性** | 字段名/类型与 `data_snapshot.json` 是否一致 |
+    | 10 | （本任务涉及ui时） **Design 合规** | Token 使用；无硬编码魔法值；与 `screens/S-XX.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: screens/S-XX.html` 指针是否仍有效 |
 
-    **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>