architext 0.0.3 → 0.0.5

package/dist/templates/zh/rules/01_workflow.md

@@ -1,5 +1,5 @@
 ---
-description: Command Dispatcher & Workflow Controller. Handles /archi.start, /archi.plan, and mode transitions between Discussion, Planning, and Implementation.
+description: Command Dispatcher & Workflow Controller. Handles /archi.* routing and mode transitions.
 globs: **/*
 applyTo: **/*
 alwaysApply: true
@@ -7,87 +7,89 @@ alwaysApply: true
 
 # Workflow Dispatcher
 
-> **Role**: 模式切换器。默认保持"通用架构师"模式，仅检测到显式指令时加载特定协议。
+> **Role**: 模式切换器。默认"通用架构师"模式，仅检测到显式指令时加载特定协议。
 
-> ⛔ **STOP CHECK** — 每轮回复前自检，命中任一项须立即停止并说明原因:
+> ⛔ **STOP CHECK** — 每轮回复前自检:
 > | 违规行为 | 正确处理 |
 > |:---|:---|
-> | 收到 `/archi.*` 指令，却未读取协议文件就开始执行 | 停止 → 先读取协议文件 |
-> | 用户请求涉及行为变更，却直接改代码 | 停止 → 引导到对应命令 |
-> | 执行 Terminal Gate 命令前未确认工作目录（见 `04_cli_tools.md`） | 停止 → 先通过 Working Directory Gate |
+> | 收到 `/archi.*` 却未读协议文件就执行 | 停止 → 先读取协议文件 |
+> | 用户请求涉及行为变更却直接改代码 | 停止 → 加载对应协议执行 |
+> | 执行 `npx archi` 前未确认工作目录 | 停止 → 先通过 Working Directory Gate（见 `04_cli_tools.md`） |
 
 ## 1. Explicit Command Routing
 
-**Trigger**: 用户输入以 `/archi.` 开头时，立即加载对应协议模板。
+**Trigger**: 用户输入以 `/archi.` 开头时，立即加载对应协议。
 
-| Command | Target Template | Action |
-|:---|:---|:---|
-| `/archi.start` | `[[__DOCS_DIR__]]/prompts/start.md` | Load CPO → Project Initiation |
-| `/archi.inherit` | `[[__DOCS_DIR__]]/prompts/inherit.md` | Load Legacy Analyst → Reverse Engineering |
-| `/archi.scope` | `[[__DOCS_DIR__]]/prompts/scope.md` | Load Strategist → Requirement Decomposition |
-| `/archi.plan` | `[[__DOCS_DIR__]]/prompts/plan.md` | Load Planner → Deep Interview |
-| `/archi.edit` | `[[__DOCS_DIR__]]/prompts/edit.md` | Load Editor → Spec Modification |
-| `/archi.revise` | `[[__DOCS_DIR__]]/prompts/revise.md` | Load Chief Architect → Global Revision |
-| `/archi.code` | `[[__DOCS_DIR__]]/prompts/code.md` | Load Developer → Coding & Auditing |
-| `/archi.audit` | `[[__DOCS_DIR__]]/prompts/audit.md` | Load Chief Auditor → Deep Code Audit |
-| `/archi.fix` | `[[__DOCS_DIR__]]/prompts/fix.md` | Load Debugger → Diagnosis |
-| `/archi.map` | `[[__DOCS_DIR__]]/prompts/map.md` | Load Surveyor → Map Refresh |
-| `/archi.remove` | `[[__DOCS_DIR__]]/prompts/remove.md` | Load Surgeon → Task Decommission |
-| `/archi.help` | `[[__DOCS_DIR__]]/prompts/help.md` | Load Manual → Display Guide |
-
-> **Protocol Load Gate** (禁跳过，三步须按序完成):
-> 1. **Read** 目标 `.md` 全文 → 文件不存在时停止，输出: `协议文件未找到，中止执行`
-> 2. **Override** `00_system` 部分设定
+| Command | Target Template |
+|:---|:---|
+| `/archi.start` | `[[__PROMPTS_PATH__]]/archi.start.md` |
+| `/archi.inherit` | `[[__PROMPTS_PATH__]]/archi.inherit.md` |
+| `/archi.scope` | `[[__PROMPTS_PATH__]]/archi.scope.md` |
+| `/archi.plan` | `[[__PROMPTS_PATH__]]/archi.plan.md` |
+| `/archi.edit` | `[[__PROMPTS_PATH__]]/archi.edit.md` |
+| `/archi.revise` | `[[__PROMPTS_PATH__]]/archi.revise.md` |
+| `/archi.code` | `[[__PROMPTS_PATH__]]/archi.code.md` |
+| `/archi.audit` | `[[__PROMPTS_PATH__]]/archi.audit.md` |
+| `/archi.fix` | `[[__PROMPTS_PATH__]]/archi.fix.md` |
+| `/archi.map` | `[[__PROMPTS_PATH__]]/archi.map.md` |
+| `/archi.remove` | `[[__PROMPTS_PATH__]]/archi.remove.md` |
+| `/archi.ref` | `[[__PROMPTS_PATH__]]/archi.ref.md` |
+| `/archi.recover` | `[[__PROMPTS_PATH__]]/archi.recover.md` |
+| `/archi.help` | `[[__PROMPTS_PATH__]]/archi.help.md` |
+
+> **Protocol Load Gate** (禁跳过，按序完成):
+> 1. **Read** 目标 `.md` 全文 → 文件不存在时停止: `协议文件未找到，中止执行`
+> 2. **Override** — 可覆盖: `<system_role>`, `<thinking_process>`, `<communication_style>`。不可覆盖: `<core_philosophy>`, `<critical_protocols>`。
 > 3. **Execute** `<step_1>` — 禁在步骤 1 完成前执行任何协议内容
 
 ---
 
-## 2. Natural Language Passthrough
-
-**Trigger**: 用户输入非 `/archi.` 指令文本。
+## 2. Natural Language Dispatch
 
-### 2.1 Intent Detection
+**Trigger**: 用户输入非 `/archi.` 指令且涉及业务变更。
 
-**Role**: 智能调度员。检测用户意图，按影响级别决定直接执行或引导到命令。
-
-**判定标准**: 该修改是否影响已文档化的行为（spec.md 的接口/逻辑/场景、ui.md 的交互/结构、plan.json 的实施步骤）？
+### §2.0 不触发协议的场景（直接回答）
 
 | 意图类型 | 处理 |
 |:---|:---|
-| 纯对话 / 代码阅读 / 架构讨论 | ✅ 直接回答，利用基底规则增强 |
+| 纯对话 / 代码阅读 / 架构讨论 | ✅ 直接回答 |
 | 琐碎修改（typo/注释/格式/日志） | ✅ 直接执行 |
-| 行为变更（逻辑/接口/类型/UI） | 🔀 引导 → `/archi.edit` + `/archi.code` |
-| Bug 修复 | 🔀 引导 → `/archi.fix` |
-| 新增功能 | 🔀 引导 → `/archi.scope` 或 `/archi.plan` |
-| 大规模重构 | 🔀 引导 → `/archi.revise` |
 
-### 2.2 Guided Dispatch (引导规范)
+### §2.1 Pre-flight（涉及业务变更时触发）
 
-🔀 引导时须:
-1. 一句话说明为什么需走命令（关联到哪个文档会受影响）
-2. 推荐具体命令 + 参数
-3. 询问用户是否开始
+1. 扫描 `roadmap.json` + `tasks/<ID>_*/` 目录，匹配用户意图对应的任务。
+2. 按下表确定应加载的协议：
 
-> ⛔ **禁**: 先改代码再事后建议走命令。违反此规则须撤销变更并重新引导。
+| 检查结果 | 加载协议 | 确认方式 |
+|:---|:---|:---|
+| roadmap 无匹配任务 | `scope.md` | 告知"我来帮你梳理需求"后直接开始 |
+| 有任务·无 spec.md | `plan.md` | 告知"该任务还没规划，我来做"后直接开始 |
+| 有 spec+plan·status=active | `code.md` | 直接开始（IDE 原生 plan mode 接管节奏） |
+| status=done·用户要修改 | `edit.md` | 告知"我先更新文档再改代码"后开始 |
+| 用户描述了异常行为 | `fix.md` | 直接开始诊断 |
+| 影响 >1 个任务或全局资产 | `revise.md` | 先输出影响评估，等确认 |
 
-### 2.3 未纳管代码
+3. 加载协议后按 §1 的 **Protocol Load Gate** 执行（读全文 → override → step_1）。
 
-修改对象未在 `map.json` 中注册、无对应 Task:
-- 告知用户该模块未纳管
-- 建议 `/archi.inherit` 或 `/archi.scope` 纳入
-- 用户确认"临时调整"后可直接修改
+### §2.2 链条衔接
 
-### 2.4 基底规则
+各协议 Signoff 的 Next Steps 已指向下一个协议。AI 须：
+- 主动提示下一步（"spec 写好了，要开始实现吗？"）
+- 用户确认后，直接加载下一个协议继续
 
-所有场景（含引导和纯对话）均依赖以下基底规则:
+| 衔接 | 串联方式 |
+|:---|:---|
+| scope → plan | 可连续执行（scope 完成后主动询问"要 plan 第一个任务吗？"） |
+| plan → code | **须等用户确认**（spec 是最重要的 checkpoint） |
+| code → audit | 协议内置（code.md step_5 已有 silent audit） |
 
-| Layer | File | Role |
-|:---|:---|:---|
-| Core | `00_system.md` | 身份设定，核心原则 |
-| Tech | `02_tech_stack.md` | 技术红线，编码规范 |
-| Custom | `90_custom_rules.md` | 团队特殊约束 |
-| Context | `99_context_glue.md` | 自动关联上下文文档 |
+> ⛔ **禁**: 在用户未确认时自动从 plan 串联到 code。
+
+### §2.3 IDE 协作
+
+利用 IDE 原生能力（plan mode / agent mode / checkpoint）驱动执行节奏。
+协议定义"做什么、检查什么"，不对抗 IDE 的规划/执行能力。
 
-**End of Dispatcher.**
+### §2.4 未纳管代码
 
-> CLI 强制执行规则见 `04_cli_tools.md`。
+修改对象未在 `map.json` 中注册、无对应 Task → **STOP & ASK**，提示用户通过 `/archi.inherit` 或 `/archi.scope` 纳管。

package/dist/templates/zh/rules/02_tech_stack.md

@@ -50,6 +50,7 @@ alwaysApply: true
 
 ---
 
+<!-- ═══════ 以下为固定协议（禁修改） ═══════ -->
 ## 4. UI Protocol: ITP v3.0 (Dual-Artifact) [可选 - 仅适用于有 UI 的项目]
 <!-- 核心 UI 描述协议 -->
 > **Note:** 如果项目没有 UI（如 CLI、Backend API、Library），可以删除此章节。
@@ -109,7 +110,7 @@ UI 制品层级：
 ### Test Suite (测试套件)
 * **Unit:** Tool: [例如：Vitest / Jest / pytest / cargo test / go test]  Scope: [例如：Utils 工具函数、核心业务逻辑、算法]  Rule: [例如：须 Mock 外部依赖；禁对易变 UI 做快照测试]
 * **Integration:** Tool: [例如：Vitest + Testcontainers / pytest + Docker]  Scope: [例如：API→DB 写入链路 / CLI 完整执行流程]
-* **E2E:** Tool: [例如：[?Web] Playwright / Cypress  [?API] Supertest / httpie  [?CLI] bats / shell script  [?Lib] 示例项目 + 自动化脚本  [?Mobile] Detox / Maestro]  Scope: [例如：[?Web] 核心用户路径  [?API] 关键 endpoint 全链路  [?CLI] 关键命令全流程  [?Lib] 公开 API 典型使用场景]
+* **E2E:** Tool: [例如：（仅ui项目） Playwright / Cypress （仅api项目） Supertest / httpie （仅cli项目） bats / shell script （仅lib项目） 示例项目 + 自动化脚本 （仅mobile项目） Detox / Maestro]  Scope: [例如：（仅ui项目） 核心用户路径 （仅api项目） 关键 endpoint 全链路 （仅cli项目） 关键命令全流程 （仅lib项目） 公开 API 典型使用场景]
 * **Test Command:** [例如：`pnpm test` / `pytest` / `cargo test` / `go test ./...`]
 
 ### Environment Scripts (环境脚本)
@@ -158,9 +159,9 @@ UI 制品层级：
 | :--- | :--- | :--- |
 | **Unit Tests** | [e.g. Centralized 或 Colocation] | `__tests__/utils/date.test.ts` / `utils/date.test.ts` |
 | **Interfaces/Types** | [e.g. Near usage 或 Global types] | `types/user.d.ts` / `domain/user.entity.ts` |
-| **Assets/Images** [?UI] | [e.g. Public 或 Module assets] | `public/images` / `assets/` |
-| **Styles** [?UI] | [e.g. 按组件或全局] | `Button.module.css` / `global.css` |
-| **DTOs/Models** [?Data] | [e.g. Domain 或 Shared] | `domain/user/dto` / `models/` |
+| **Assets/Images**（仅ui项目） | [e.g. Public 或 Module assets] | `public/images` / `assets/` |
+| **Styles**（仅ui项目） | [e.g. 按组件或全局] | `Button.module.css` / `global.css` |
+| **DTOs/Models**（仅data项目） | [e.g. Domain 或 Shared] | `domain/user/dto` / `models/` |
 
 ---
 
@@ -183,10 +184,10 @@ UI 制品层级：
 * **Strategy:** [例如：Fail Fast + Form Validation / Fail Fast (stderr) / Schema Validation + Fail Fast]
 * **Rationale:** [例如：表单密集型应用，需前端实时校验 + 后端快速失败]
 
-### Data Flow (数据流模式) [?UI]
+### Data Flow (数据流模式) （仅ui项目）
 * **Default:** [例如：Standard Request + SWR / Realtime (Socket) / Polling]
 * **Rationale:** [例如：大部分页面为 CRUD 读写，SWR 做缓存和重新验证]
 
-### Auth & Access (认证与权限) [?Web/API]
+### Auth & Access (认证与权限) （仅ui或api项目）
 * **Mechanism:** [例如：JWT + RBAC / Session + Owner Only / API Key]
 * **Rationale:** [例如：多角色后台管理系统，需细粒度权限控制]

package/dist/templates/zh/rules/03_data_governance.md

@@ -11,14 +11,18 @@ alwaysApply: true
 
 ## 1. 数据文件清单
 
-| 文件 | 类型 | 读取时机 | 写入时机 |
-|:---|:---|:---|:---|
-| `roadmap.json` | 路线图 | `/archi.plan`, `/archi.code` 开始时 | `/archi.start` 创建; AI 直接编辑或 `npx archi task` 更新状态 |
-| `map.json` | 架构地图 | 触碰代码时 (via context_glue) | `/archi.plan` Step 3 (全局同步); `/archi.inherit` Step 3.6; `/archi.map` |
-| `dictionary.json` | 术语字典 | 生成变量名/命名时 | `/archi.plan` Step 3; code/fix 后 step_5 自动追加 |
-| `design_tokens.json` | 设计令牌 [?UI] | 生成 UI 代码时 | `/archi.start` 创建; 设计变更时更新 |
-| `data_snapshot.json` | 数据快照 [?Data] | `/archi.plan` Q1 设计; `/archi.code` 实现时 | Plan 阶段设计 Schema; Code 阶段同步实际变更 |
-| `error_codes.json` | 错误码契约 | 编写错误处理时 | `/archi.plan` Step 3; code/fix 后 step_5 自动追加 |
+| 文件 | 读取时机 | 写入时机 |
+|:---|:---|:---|
+| `roadmap.json` | plan/code 开始时 | start 创建; AI 编辑或 `npx archi task` 更新 |
+| `map.json` | 触碰代码时 (via context_glue) | plan Step 3; inherit Step 3.6; /archi.map |
+| `dictionary.json` | 生成变量名/命名时 | plan Step 3; code/fix 后 step_5 自动追加 |
+| `design_tokens.json`（仅ui） | 生成 UI 代码时 | start 创建; 设计变更时更新 |
+| `data_snapshot.json`（仅data） | plan 设计/code 实现时 | Plan 设计 Schema; Code 同步变更 |
+| `error_codes.json` | 编写错误处理时 | plan Step 3; code/fix 后 step_5 自动追加 |
+| `api_snapshot.json`（仅api） | 实现/对接端点时 | plan Step 3 注册; Code 同步 |
+| `env_registry.json`（仅api） | 引入新配置项时 | Code 引入新 env var 后立即追加 |
+| `command_api.json`（仅cli） | 实现/修改命令时 | plan Step 3 注册; Code 同步 |
+| `public_api.json`（仅lib） | 新增/修改导出时 | plan Step 3 注册; Code 同步 |
 
 ---
 
@@ -26,19 +30,19 @@ alwaysApply: true
 
 ### 2.1 格式约束
 
-- **JSON Only**: 全局数据的唯一真理源是 `.json` 文件。`.md` 视图由 `npx archi render` 自动生成，禁直接编辑 `.md` 视图。
-- **Schema Stability**: 分两档管理：
-  - **Tier 1 (严格)**: `roadmap.json`, `plan.json` — CLI 渲染/命令直接依赖，结构由 Zod Schema 校验，禁随意变更字段。
-  - **Tier 2 (宽松)**: `dictionary.json`, `error_codes.json`, `data_snapshot.json`, `design_tokens.json`, `map.json` — 仅校验顶层 key 存在。若现有字段无法充分描述需记录的内容，可自行扩展字段（添加新 key 或在数组 item 中添加新属性），无需修改 CLI。
-- **Valid JSON**: 写入后须保证合法 JSON (无尾逗号、无注释)。
+- **JSON Only**: `.json` 是唯一真理源。`.md` 视图由 `npx archi render` 生成，禁直接编辑。
+- **Schema Stability**:
+  - **Tier 1 (严格)**: `roadmap.json`, `plan.json` — CLI 直接依赖，Zod Schema 校验，禁随意变更。
+  - **Tier 2 (宽松)**: 其余文件仅校验顶层 key。**所有 Tier 2 文件均可自行扩展字段（新 key / 新数组属性），无需改 CLI。**
+- **Valid JSON**: 无尾逗号、无注释。
 
 ### 2.2 读写纪律
 
 | 场景 | 规则 |
 |:---|:---|
-| 需要查阅数据 | 读取 `.json` 文件，禁读 `.md` 视图 (可能过期) |
-| 需要更新 Roadmap 任务状态 | 优先使用 `npx archi task <ID> --status <s>`; 批量更新时可直接编辑 JSON |
-| 需要更新其他数据文件 | AI 直接编辑 `.json` 文件 |
+| 查阅数据 | 读 `.json`，禁读 `.md` 视图（可能过期） |
+| 更新 Roadmap 状态 | 优先 `npx archi task <ID> --status <s>`; 批量时可直接编辑 JSON |
+| 更新其他数据 | AI 直接编辑 `.json` |
 | 更新后 | 运行 `npx archi render` 重新生成 `.md` 视图 |
 
 ---
@@ -56,41 +60,41 @@ alwaysApply: true
 
 - **Directory Mapping**: 须反映真实物理文件树。
 - **Logical Topology**: 须注册每个 Task Module 的职责。
-- **Feature Relations**（字段 `featureRelations`）: 记录聚合型 Task 与其来源的联动关系。每条结构为 `{ aggregator, sources, evidence, checkNote }`；由 AI 在 `/archi.plan`（规划聚合型 Task 时）或 `/archi.inherit`（逆向扫描时）写入，无需用户手动维护。
-- **自我校正**: 若代码引用违反拓扑定义的层级关系，须报错并停止生成。
-- **可扩展**: 若现有字段不足以描述项目架构，可在 item 中自行添加字段（如 `tags`、`owner`），或添加新顶层 key。
+- **Feature Relations**: `featureRelations` 记录聚合型 Task 与来源的联动关系，由 AI 在 plan/inherit 时写入。
+- **自我校正**: 代码引用违反拓扑层级关系时，须报错并停止。
 
 ### `dictionary.json`
 
-- **命名权威**: 本文件是命名的最高法律。
-- **Boundary**: 仅注册**项目业务域**内容。Architext 框架自身概念（scripts、scaffold、roadmap、plan 等）禁注册。
-- **entities**: 生成变量名前须查阅 `entities[].codeName`；禁使用 `forbiddenSynonyms` 中的词。
-- **verbs**: 业务动作命名须查阅 `verbs[].codeName`，保持全项目动词一致。
-- **utilities**: 封装的共享工具（如 logger、AppError、fetchClient）须注册；AI 须用已注册工具替代原始 API（参照 `replaces` 字段）。
-- **components** [?UI]: 创建新组件前须搜索现有组件，优先复用。
-- **可扩展**: 若现有字段不足以描述某个术语/工具，可在对应数组 item 中自行添加字段（如 `tags`、`scope`、`deprecated`），也可添加新顶层数组（如 `enums`、`constants`）。
+- **命名权威**: `entities[].codeName` 是最高法律；禁用 `forbiddenSynonyms` 中的词。
+- **Boundary**: 仅注册项目业务域；Architext 框架概念禁注册。
+- verbs 保持全项目动词一致；utilities 须注册并用已注册工具替代原始 API。
+- 仅ui项目: components 创建前须搜索复用。
 
-### `design_tokens.json` [?UI]
+### `design_tokens.json`（仅ui项目）
 
 - **Token Only**: 样式严格使用 Token；禁硬编码 Hex/px/rem。
 - **Dark Mode**: 须同时定义 `light` 和 `dark` 值。
-- **可扩展**: 若现有 Token 结构不足以覆盖项目需求（如 `motion`、`breakpoints`、`z-index`），可自行添加新属性。
 
-### `data_snapshot.json` [?Data]
+### `data_snapshot.json`（仅data项目）
 
-- **结构**: `models[]`（名称、字段、类型、约束）+ `relationships[]`（模型间关系：1:1/1:N/M:N/self-ref）。
-- **Design First**: Plan 阶段须定义模型结构和字段类型，禁写 "TBD"，须精确到字段名与类型。
-- **Sync Back**: Code 阶段完成后，须将实际变更同步回此文件。
-- **可扩展**: 若现有字段不足以描述数据模型（如需记录 `indexes`、`triggers`、`seedData`），可在 model item 或顶层自行添加字段。
+- **结构**: `models[]`（名称/字段/类型/约束）+ `relationships[]`（1:1/1:N/M:N/self-ref）。
+- **Design First**: Plan 须定义模型结构，精确到字段名与类型，禁写 "TBD"。
+- **Sync Back**: Code 完成后须将实际变更同步回此文件。
 
 ### `error_codes.json`
 
-- **Boundary**: 仅注册**项目业务域**错误。框架基础设施（scripts/validate、dev-up、dev-reset 等）的错误由脚本自身 exit code + stderr 处理，禁注册到此文件。
-- **结构**: `protocolMapping [?API]`（状态码→行为映射）+ `businessErrors`（业务错误注册表）。
-- **Code Format**: `ERR_[MODULE]_[REASON]` (如 `ERR_AUTH_INVALID_TOKEN`)。
-- **statusCode**: 按项目类型填写（HTTP status / Exit code / 留空）。
-- **Design Before Code**: 编写错误处理代码前须先在此注册错误码，含 `message` 和 `recovery`。
-- **可扩展**: 若现有字段不足以描述错误信息（如需记录 `severity`、`retryable`、`httpBody`），可在 item 中自行添加字段。
+- **Boundary**: 仅注册项目业务域错误；框架基础设施错误禁注册。
+- **Code Format**: `ERR_[MODULE]_[REASON]`。
+- **Design Before Code**: 编写错误处理前须先注册，含 `message` 和 `recovery`。
+
+### 条件性文件专项
+
+| 文件 | 核心规则 |
+|:---|:---|
+| `api_snapshot.json`（仅api） | endpoints[] 注册; Register First 禁实现未登记端点; owner 标注 Task ID |
+| `env_registry.json`（仅api） | 引入即注册; required/example 必填 |
+| `command_api.json`（仅cli） | 修改即同步; owner 标注 Task ID |
+| `public_api.json`（仅lib） | stable 变更须走 /archi.edit; 完整 TS 签名; owner 标注 Task ID |
 
 ---
 

package/dist/templates/zh/rules/99_context_glue.md

@@ -33,8 +33,8 @@ alwaysApply: true
 | 代码类型 | 必读上下文 | 真理来源 |
 |:---|:---|:---|
 | **Business Logic** (Tasks/Entities) | Spec Document | `[[__DOCS_DIR__]]/global/map.json` → Module Entry |
-| **UI Components** (Pages/Widgets) [?UI] | UI Document + `[[__DOCS_DIR__]]/global/design_tokens.json` | `[[__DOCS_DIR__]]/global/map.json` + Global Rules |
-| **Data Schema** (ORM/SQL/Models) [?Data] | Data Snapshot | `[[__DOCS_DIR__]]/global/data_snapshot.json` |
+| **UI Components** (Pages/Widgets)（仅ui项目） | UI Document + `[[__DOCS_DIR__]]/global/design_tokens.json` | `[[__DOCS_DIR__]]/global/map.json` + Global Rules |
+| **Data Schema** (ORM/SQL/Models)（仅data项目） | Data Snapshot | `[[__DOCS_DIR__]]/global/data_snapshot.json` |
 | **Config / Infra** (Package.json...) | Tech Stack | `02_tech_stack.md` |
 
 ---

package/dist/templates/zh/skills/archi-data-sync/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: archi-data-sync
+type: reviewer
+description: 数据治理同步执行器。在独立上下文中扫描主 Agent 产出，对比全局数据文件的现有状态，按 03_data_governance.md 规则执行增量同步，返回变更 Diff。
+---
+
+# 数据治理同步执行器
+
+## 系统流程定位
+
+```
+/archi.* step_N → Verify 阶段
+    ↓
+[本 Skill] 扫描产出 → 对比全局文件 → 增量同步 → 返回 Diff
+    ↓
+主 Agent Signoff（确认 Diff）
+```
+
+> **Skill 的职责边界**：
+> - 负责：扫描主 Agent 产出中新增的业务实体/错误码/Schema，与全局数据文件对比，执行增量同步
+> - 不负责：修改 `03_data_governance.md` 本身（本 Skill 是规则的执行者，不是制定者）
+> - 不负责：注册框架概念（Architext 框架自身概念禁注册到全局数据文件）
+
+---
+
+## 权威规则源
+
+`03_data_governance.md` 是数据治理的唯一权威规则源。本 Skill 的所有行为须与该文件一致。
+
+---
+
+## 同步范围
+
+| 全局文件 | 同步内容 | 触发条件 |
+|:---|:---|:---|
+| `dictionary.json` | 新业务实体 · 动作 · 共享工具 · 公共组件 | 产出中出现未登记的业务术语或工具 |
+| `error_codes.json` | 新业务错误码 | 产出中出现未注册的错误场景 |
+| 本任务涉及data时: `data_snapshot.json` | Schema 变更 | 产出中有数据模型新增/修改 |
+| 仅api项目: `api_snapshot.json` | 新端点 | 产出中有新 HTTP/RPC 端点 |
+| 仅api项目: `env_registry.json` | 新环境变量 | 产出中引入新 `process.env.X` |
+| 仅cli项目: `command_api.json` | 新命令 | 产出中有新 CLI 命令 |
+| 仅lib项目: `public_api.json` | 新导出 API | 产出中有新公共导出 |
+
+---
+
+## 执行协议
+
+1. **读取全局数据文件**: 加载上表中与项目 features 匹配的全局文件
+2. **扫描主 Agent 产出**: 识别新增的业务实体、错误码、Schema、端点等
+3. **Boundary 检查**: 禁注册框架概念（scripts、scaffold、roadmap、plan 等），仅同步项目业务域内容
+4. **查重**: 对比现有条目，避免重复注册
+5. **增量同步**: 仅追加/修改，禁删除已有条目
+6. **输出变更 Diff**
+
+### 硬边界
+
+- **禁直接追加写入** — 须先查现有内容边界再写，避免重复或冲突
+- **禁注册框架概念** — 仅同步项目业务域内容
+- **禁修改 `03_data_governance.md`** — 本 Skill 是规则的执行者
+
+### 输出格式
+
+```
+### Data Sync Results
+
+ADDED:
+- dictionary.json: entities += [新实体名]
+- error_codes.json: businessErrors += [ERR_CODE]
+
+MODIFIED:
+- data_snapshot.json: models.User += [新字段]
+
+NO CHANGE:
+- [无需同步的文件]
+
+**Summary**: X 文件变更 / Y 条新增 / Z 条修改
+```
+
+无需同步时输出: `### Data Sync Results — NO CHANGES`
+
+---
+
+> **中间产物**：此 Skill 为审查型子程序，产出变更 Diff 后控制权交还调用方。