architext 0.0.5 → 0.0.6

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

@@ -24,7 +24,7 @@
 <step_1_load>
     **Action**:
     1.  **Pre-flight**: 读取 roadmap.json，仅读 `<ID>` 条目及直接 deps 的 `id/title/status`；deps 未完成则拒绝（除非用户强制）。
-    2.  **Load**: vision.md（仅北极星+设计哲学）、02_tech_stack.md（红线 + §9 项目约定，提取 Error Handling/Data Flow/Auth 继承值）、（仅ui项目）design_tokens.json + ui_context.md（定位屏幕 ID，锁定范围供 step_4 填入，禁自行发明新 ID；不存在则跳过）、（仅data项目）data_snapshot.json。
+    2.  **Load**: 读取项目上下文（vision、tech_stack、按需读取 feature 相关 JSON），详见 00_system.md 数据治理规则。
     3.  **Dependency Context** (有依赖时): 仅读依赖任务 spec.md 的 Interface/Type 段；无引用时跳过。Stub 依赖 → 从关联文件提取源码公共接口。
     4.  **Refs** (如有): 读 refs/index.json，按 tags 语义匹配，仅读命中 ref 文件；不存在则跳过。
 
@@ -126,7 +126,7 @@
 
     **Action Checklist**:
     1.  **`map.json`**: 在 `directoryMapping` 注册 `[[__DOCS_DIR__]]/tasks/<ID>_<Slug>`；在 `logicalTopology` 定义模块职责与依赖。
-    2.  **数据治理同步** (`dictionary.json` / `error_codes.json` / `data_snapshot.json` 等): 按 `03_data_governance.md` 规则，将提案中涉及的新业务术语、错误码、Schema 增量同步至对应全局文件。
+    2.  **数据治理同步**: [[SUBAGENT: archi-data-sync|context: 扫描 Task 提案中引入的新业务实体/错误码/Schema/端点/命令/导出，按 00_system.md 规则增量同步]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-data-sync/SKILL.md`，按其执行协议操作）]]
     3.  **`map.json` featureRelations**: [[SUBAGENT: archi-feature-relations|mode: register, context: 判断本 Task 是否为聚合型，若是则注册 featureRelations 条目]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-feature-relations/SKILL.md`，按 mode: register 的逻辑执行）]]
 
     **Output**: 上述文件的变更 Diff (简要)。进入 step_5_generate。
@@ -151,7 +151,7 @@
     > 混合型任务在 § 2 内用子标题区分维度。
 
     **spec § 4 Interface Exports**：INF 任务**必填**，FEAT 任务有下游 deps 时必填。
-    **spec § 5 Constraints**：**必填** — 从 vision.md + 02_tech_stack.md 提取与本任务相关的红线。
+    **spec § 5 Constraints**：**必填** — 从 vision.md + tech_stack.md 提取与本任务相关的红线。
 
     **通用规则**:
     - 禁凭空编造 AC 条目，须对应功能设计中的具体内容。
@@ -165,7 +165,7 @@
          | 偏差类型 | 判定标准 | 处理方式 |
          |:---|:---|:---|
          | 无偏差 | 屏幕索引与设计一致 | 直接写 `ui.md`，引用屏幕 ID |
-         | 轻微增量 | 新增状态/弹窗/局部区域，不改整体布局 | 调用 skill 更新 `ui_concept.html` + `ui_context.md`，注明 `MODIFIED: S-XX` |
+         | 轻微增量 | 新增状态/弹窗/局部区域，不改整体布局 | 调用 skill 更新 `screens/S-XX.html` + `ui_context.md`，注明 `MODIFIED: screens/S-XX.html` |
          | 结构性偏差 | 布局重构、新增独立屏幕、流程路径变化 | **暂停**，向用户输出偏差说明，等待 **OK** 后调用 skill 更新，再写 `ui.md` |
 
       2. 完成偏差处理后，按 `ui.template.md` 填写屏幕范围声明和差异组件。
@@ -224,7 +224,13 @@
     □ plan.json — spec § 2 每条 AC → ≥1 task 覆盖（100% 覆盖原则）
     □ plan.json — 每个 task notes 含验证字段（非空，非 title 同义重复）
     □ map.json — tasks/<ID>_<Slug> 已在 directoryMapping 注册
-    □ 全局文件 — 新术语/错误码/Schema 已同步（dictionary/error_codes/data_snapshot）
+    □ 全局文件 — 新术语/错误码/Schema/Token/环境变量 已同步
+      - dictionary.json + error_codes.json + env_registry.json — 必填
+      - （仅ui项目）design_tokens.json + ui_context.md
+      - （仅data项目）data_snapshot.json
+      - （仅api项目）api_snapshot.json
+      - （仅cli项目）command_api.json
+      - （仅lib项目）public_api.json
     □ Step 6 Silent Audit — 已执行，所有 CRITICAL 问题已修复
 
     **Action** (Checklist 全部确认后):

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

@@ -17,7 +17,7 @@
     **Action**:
     1.  **Resolve ID**: 从 roadmap.json 解析 `<id>` → Task Name、Slug、状态。
     2.  **ID Not Found** → 报错并列出可用任务 ID。
-    3.  **Load**: task docs 目录、roadmap.json（依赖关系）、map.json（架构注册）、99_context_glue.md（关联）。
+    3.  **Load**: task docs 目录、roadmap.json（依赖关系）、map.json（架构注册）。
 
     **Output**: 目标 Task 基本信息（ID、名称、状态、关联文件数）。
 </step_1_resolve>
@@ -37,7 +37,7 @@
 
     ### 2.2 代码文件识别
 
-    通过以下方式定位代码文件：context_glue 关联路径、map.json 注册模块、plan.json 提及的文件、以 Slug 命名或明确归属的文件。
+    通过以下方式定位代码文件：map.json 注册模块、plan.json 提及的文件、以 Slug 命名或明确归属的文件。
 
     ### 2.3 全局引用扫描
 
@@ -45,7 +45,6 @@
     |:---|:---|
     | `roadmap.json` | 任务条目 + deps 引用 |
     | `map.json` | 模块条目 + featureRelations 中以被删 Task 为 aggregator 的条目 |
-    | `99_context_glue.md` | 关联条目 |
     | `dictionary.json` | 独占术语（仅标记） |
     | `error_codes.json` | 独占错误码（仅标记） |
 
@@ -57,7 +56,7 @@
 
     扫描其他 Task 的 `spec.md`，检查是否引用了被删 Task 的接口/组件/数据。发现引用则标注 `[Breaking]`。
 
-    **Output**: 向用户输出下线影响报告 — 含 Task 状态、将删除的文档和代码（文件/来源表）、全局引用清理项（roadmap/map/context_glue）、（有）术语/错误码残留（须人工确认）、（有）聚合联动表、（有）跨 Task 引用 [Breaking] 表。末尾：OK 确认执行 / 中止取消。
+    **Output**: 向用户输出下线影响报告 — 含 Task 状态、将删除的文档和代码（文件/来源表）、全局引用清理项（roadmap/map）、（有）术语/错误码残留（须人工确认）、（有）聚合联动表、（有）跨 Task 引用 [Breaking] 表。末尾：OK 确认执行 / 中止取消。
 
     **Gate**: 用户回复 OK 后进入 step_3。有 `[Breaking]` 引用时须再次警告。
 </step_2_impact>
@@ -72,8 +71,7 @@
     | 2 | 删除 Task 文档目录 | `[[__DOCS_DIR__]]/tasks/<id>_<slug>/` |
     | 3 | 更新 `roadmap.json` | 移除任务条目；清理 deps 引用 |
     | 4 | 更新 `map.json` | 移除模块条目 + featureRelations 条目 |
-    | 5 | 更新 `99_context_glue.md` | 移除关联条目 |
-    | 6 | [?有独占术语] 更新 `dictionary.json` | 移除或标注废弃 |
+    | 5 | [?有独占术语] 更新 `dictionary.json` | 移除或标注废弃 |
     | 7 | [?有独占错误码] 更新 `error_codes.json` | 移除或标注废弃 |
     | 8 | [?有聚合联动] 检查聚合方代码 | 确认引用已清理 |
 
@@ -95,13 +93,20 @@
     □ tasks/<id>_<slug>/ 文档目录 — 已删除（step_3 操作 #2）
     □ roadmap.json — 任务条目 + deps 引用 — 已清理（step_3 操作 #3）
     □ map.json — 模块条目 + featureRelations — 已清理（step_3 操作 #4）
-    □ 99_context_glue.md — 关联条目 — 已清理（step_3 操作 #5）
     □ （有独占术语/错误码）dictionary.json + error_codes.json — 已处理
+    □ 全局文件清理检查:
+      - vision.md + tech_stack.md — 必检
+      - dictionary.json + error_codes.json + env_registry.json — 必检
+      - （仅ui项目）design_tokens.json + ui_context.md
+      - （仅data项目）data_snapshot.json
+      - （仅api项目）api_snapshot.json
+      - （仅cli项目）command_api.json
+      - （仅lib项目）public_api.json
     □ Terminal Gate — 项目构建通过，无残留 import 引用（step_4）
 
     **Output**: 下线完成摘要：
     - **已删除**: 文档 N 个文件、代码 N 个文件
-    - **已清理**: roadmap / map / context_glue 中的引用
+    - **已清理**: roadmap / map 中的引用
     - **构建状态**: 通过/失败
     - **[?有]须人工跟进**: 术语/错误码/跨 Task 引用残留
     - **Git Commit Suggestion**: `feat(remove): decommission <ID> <Name>`

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

@@ -19,7 +19,7 @@
 
 <step_1_load>
     **Action**:
-    1.  **Load**: 全部全局资产（vision/roadmap/map/dictionary/error_codes/02_tech_stack + 条件: design_tokens/data_snapshot）。
+    1.  **Load**: 全部全局资产（vision/roadmap/map/dictionary/error_codes/tech_stack + 条件: design_tokens/data_snapshot）。
     2.  **Scan Task Index**: 扫描 tasks/ 目录，建立 Task 索引（ID、名称、状态）。
     3.  **Intent Analysis**: 根据 `[context]`，初步定位受影响的全局资产类别。
 
@@ -68,7 +68,7 @@
     按用户确认的清单修改全局文件。每个文件修改后输出变更摘要。
 
     **（仅ui项目） Phase 1.5 — 设计系统变更检查**:
-    若 `design_tokens.json` 有以下变更，须通知用户需重跑 `archi-ui-wireframe` 重新生成：
+    若 `design_tokens.json` 有以下变更，须通知用户需重跑 `/archi.ui` 重新生成：
 
     | 变更范围 | 影响 |
     |:---|:---|
@@ -83,7 +83,7 @@
     **Phase 2 — 级联更新 Task 文档**:
     对每个受影响的 Task，按 `/archi.edit` 标准执行:
     1.  更新 `spec.md`。
-    2.  （仅ui项目） 更新 `ui.md`；如屏幕结构受影响，[[SKILL: archi-ui-wireframe|运行 skill（局部更新模式）同步更新]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md` 并遵循其协议执行）]]。
+    2.  （仅ui项目） 更新 `ui.md`；如屏幕结构受影响，[[SKILL: archi-ui-wireframe|运行 skill（局部更新模式）同步更新 `screens/S-XX.html`]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md` 并遵循其协议执行）]]。
     3.  在 `plan.json` 追加新 Phase: `Phase X: Global Revision — [变更主题] (<Date>)`。
 
     **Output**: 每个文件的变更摘要（全局 + Task）。进入 step_5_verify。
@@ -103,7 +103,15 @@
     **Pre-signoff Checklist** (Gate 通过后、输出前须逐项确认):
     □ step_4 Safety Checkpoint — Git 工作区已确认（无未提交变更或已告知用户）
     □ Phase 1 — 所有确认的全局资产已修改，每个文件有变更摘要输出
-    □ （仅ui项目，设计系统有变更）已通知用户重跑 archi-ui-wireframe
+    □ Phase 1 — 全局文件检查:
+      - roadmap.json + vision.md + tech_stack.md + map.json — 必检
+      - dictionary.json + error_codes.json + env_registry.json — 必检
+      - （仅ui项目）design_tokens.json + ui_context.md
+      - （仅data项目）data_snapshot.json
+      - （仅api项目）api_snapshot.json
+      - （仅cli项目）command_api.json
+      - （仅lib项目）public_api.json
+    □ （仅ui项目，设计系统有变更）已通知用户重跑 `/archi.ui`
     □ Phase 2 — 每个受影响 Task 的 spec.md 已更新 + plan.json 已追加 Revision Phase
     □ Step 5 Silent Audit — 已执行，所有 CRITICAL 问题已修复
     □ 一致性确认: vision ↔ tech_stack ↔ roadmap ↔ map 无孤立引用（旧术语/路径已清理）

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

@@ -34,7 +34,7 @@
 
 <step_1_load>
     **Action**:
-    1.  **Load**: vision.md（仅北极星+Boundaries）、roadmap.json（仅 id/title/status/deps/tag + 当前最大 ID 水位）、02_tech_stack.md、map.json（仅 directoryMapping + featureRelations）。
+    1.  **Load**: 读取项目上下文（vision、roadmap、tech_stack、map），详见 00_system.md 数据治理规则。
     2.  **Scan Tasks**: 扫描 tasks/ 目录 — 了解已有 Task 概要（标题+关键流程，无需全文）。
 
     **Output**: 内部上下文摘要，进入 `<step_2_analysis>`。
@@ -117,7 +117,8 @@
     **Pre-signoff Checklist** (输出前须逐项确认):
     □ 分解方案已获用户明确确认（回复 OK 后才写入 roadmap — step_4 Gate）
     □ roadmap.json — 任务已追加（非覆盖），lastUpdated 已更新
-    □ （有新模块）map.json directoryMapping — 新任务模块路径已预注册
+    □ （有新模块）map.json directoryMapping + logicalTopology — 新任务模块路径已预注册
+    □ featureRelations — 若新任务涉及已有文件的关联影响，已同步更新
     □ step_5 Terminal Gate — task --check + render 已通过
 
     **Action** (Gate 须在 step_5 完成):
@@ -132,7 +133,7 @@
 
     | 优先级 | 动作 | 说明 |
     |:---|:---|:---|
-    | （仅ui项目） 推荐 | [[SKILL: archi-ui-wireframe|运行 skill（追加模式）]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md` 并遵循其协议执行）]] | 为新增任务追加屏幕到 `ui_concept.html` |
+    | （仅ui项目） 推荐 | `/archi.ui` | 为新增任务增量更新 UI 概念设计（`screens/` 目录） |
     | 1 | `/archi.plan <第一个 pending 任务 ID>` | 对首个可执行任务做深度规划 |
     | 2 | 审查 roadmap | 确认依赖关系和优先级 |
 </step_6_signoff>

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

@@ -0,0 +1,102 @@
+<protocol_script>
+  **Trigger**: `/archi.script`
+  **Goal**: 基于已冻结的 `tech_stack.md` 生成/更新 `.architext/scripts/` 自动化脚本。
+  **When**: 基建任务（INF-01 等）完成后，`tech_stack` 命令已从占位符变为实际值且可运行时。
+
+<meta>
+    <style>Deterministic, Auto-Detect, Post-Infra</style>
+    <language>简体中文</language>
+    <principles>
+      1. **Post-Infra Only**: 仅基建完成后执行，`tech_stack` 命令必须已确定且可运行。
+      2. **Auto-Detect**: 自动识别 OS，生成 `.sh`（Unix）和 `.ps1`（Windows）。
+      3. **Tech-Stack Driven**: 严格从 `tech_stack.md` 提取实际命令，禁硬编码。
+      4. **Idempotent**: 多次运行结果一致，有变更才写入。
+    </principles>
+</meta>
+
+<step_1_ingest>
+    **Action**:
+    1. 读取 `[[__DOCS_DIR__]]/global/tech_stack.md`
+    2. 读取项目实际代码，提取实际命令：
+       - `package.json` → `scripts` 字段（如有）
+       - 配置文件 → `vite.config.*` / `webpack.config.*` / `tsconfig.json` 等
+       - CI 配置 → `.github/workflows/` / `.gitlab-ci.yml` 等（如有）
+    3. 交叉验证：tech_stack 命令 vs 实际配置
+       - 一致 → 使用 tech_stack 命令
+       - 不一致 → 以实际代码为准（tech_stack 可能过期）
+    4. 提取以下命令（跳过 `[例如：...]` 占位符）：
+       - **Lint**: Section 3 Static Analysis
+       - **Format**: Section 3 Formatter
+       - **Build**: Section 3 Build Command
+       - **Test**: Section 5 Test Command
+       - **Dev**: Section 3 Dev Command
+       - **Install**: Section 3 Package Manager + install
+    5. 检测当前 OS（Windows / Unix-like）
+
+    **Output**: 内部命令映射表（tech_stack + 实际代码交叉验证结果），进入 step_2_generate。
+</step_1_ingest>
+
+<step_2_generate>
+    **Action**: 基于提取的命令生成三个脚本：
+
+    ### validate
+    聚合检查：Lint → Format Check → Type Check → Build → Test
+    - 每步失败即退出（exit 1）
+    - 带颜色输出（绿=通过，红=失败，黄=跳过）
+
+    ### dev-up
+    启动环境：Install → Build → Health Check
+    - Health Check：尝试运行构建产物（如 CLI 则 `--version`）
+
+    ### dev-reset
+    重置环境：Kill Process → Clean Cache → Reinstall → Rebuild → Health Check
+    - Kill：终止 node/tsx 进程
+    - Clean：删除 node_modules/.cache, dist, coverage
+
+    **Script Structure**:
+    - Unix (`.sh`): `#!/bin/bash`, `set -e`, ANSI colors
+    - Windows (`.ps1`): PowerShell, `$ErrorActionPreference`, Write-Host colors
+
+    **Output**: 内存中脚本内容，进入 step_3_write。
+</step_2_generate>
+
+<step_3_write>
+    **Action**:
+    1. 确保 `[[__DOCS_DIR__]]/scripts/` 目录存在
+    2. 对比现有脚本（如有）：
+       - 内容一致 → 跳过
+       - 内容变更 → 覆盖，标注 `MODIFIED`
+       - 不存在 → 写入，标注 `ADDED`
+    3. 写入文件：
+       - Unix: `validate`, `dev-up`, `dev-reset`（无扩展名，+x 权限）
+       - Windows: `validate.ps1`, `dev-up.ps1`, `dev-reset.ps1`
+
+    **Output**: 文件变更列表。
+</step_3_write>
+
+<step_4_signoff>
+    **Terminal Gate** (禁止跳过): 标准检查 (task --check + render)。
+
+    **Pre-signoff Checklist**:
+    □ tech_stack.md — 成功提取到非占位符命令
+    □ scripts/ — validate/dev-up/dev-reset 已生成（Unix + Windows）
+    □ 变更标注 — ADDED / MODIFIED / SKIPPED 正确输出
+
+    **Output**:
+    ```
+    ✅ Scripts Generated
+
+    | 脚本 | OS | 状态 |
+    |:---|:---|:---|
+    | validate | Unix | ADDED/MODIFIED/SKIPPED |
+    | validate | Windows | ADDED/MODIFIED/SKIPPED |
+    | dev-up | Unix | ... |
+    | dev-up | Windows | ... |
+    | dev-reset | Unix | ... |
+    | dev-reset | Windows | ... |
+
+    **Next**: AI 执行 `/archi.code` 时将自动使用 `scripts/validate`
+    ```
+</step_4_signoff>
+
+</protocol_script>

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

@@ -90,13 +90,13 @@
 
     ### 信息路由规则
 
-    > 规则文件（`02_tech_stack`、`90_custom_rules` 等）已由 IDE 注入当前上下文，AI 已知其路径，直接写入即可。
+    > 规则文件（`tech_stack`、`90_custom_rules` 等）已由 IDE 注入当前上下文，AI 已知其路径，直接写入即可。
 
     | Brief 内容 | 目标文件 |
     |:---|:---|
     | 项目身份、目标用户、成功指标、参考灵感 | `[[__DOCS_DIR__]]/global/vision.md` |
-    | 技术栈、部署目标、第三方库/服务 | 规则文件 `02_tech_stack` |
-    | 风格调性 — 审美方向/信息密度/动效偏好 | `02_tech_stack` (UI Protocol) + `design_tokens.json` |
+    | 技术栈、部署目标、第三方库/服务 | 规则文件 `tech_stack` |
+    | 风格调性 — 审美方向/信息密度/动效偏好 | `tech_stack` (UI Protocol) + `design_tokens.json` |
     | （仅ui项目）审美方向 preset + 视觉参考（品牌色/字体/图标/竞品截图） | `design_tokens.json` 对应字段 + `vision.md` Visual Reference |
     | （仅ui项目）brief-assets/ 中标记为 `[竞品参考]` 的图片 | `design_tokens.json` aestheticDirection 参考 + `vision.md` Visual Reference |
     | 核心任务列表 | `[[__DOCS_DIR__]]/global/roadmap.json` |
@@ -107,7 +107,7 @@
     | brief-assets/ 中标记为 `[数据库 Schema]` 的文件 | 解析后写入 `data_snapshot.json` |
     | brief-assets/ 中标记为 `[API 文档]` 的文件 | 解析后路由到 `vision.md` Context + 相关 Roadmap 任务 |
     | 边界与反目标 | `vision.md` Boundaries |
-    | 已有资源 | `vision.md` + `02_tech_stack` 按归属 |
+    | 已有资源 | `vision.md` + `tech_stack` 按归属 |
     | 补充说明中的规则/约定/偏好 | 规则文件 `90_custom_rules` |
     | 补充说明中的领域术语 | `dictionary.json` |
     | 补充说明中的其他背景 | `vision.md` Context |
@@ -118,7 +118,7 @@
     - 从 Brief 填充 Core Vision / Target Audience / Boundaries / Design & Experience / Product Principles / 背景上下文
     - 须填满所有占位符，禁保留模板示例文字
 
-    ### 3.2 Tech Stack (规则文件 `02_tech_stack`)
+    ### 3.2 Tech Stack (规则文件 `tech_stack`)
     - Brief 已确定 → 直接写入 | 留空/写"推荐" → AI 推荐并标注 `(AI 推荐)` + 理由
     - **AX Optimization**: 推荐时优先 AI 友好型技术
     - 须填充完整 Section 1-9
@@ -139,12 +139,12 @@
     - （仅data项目） `data_snapshot.json`: 初始化核心实体骨架；无数据描述时写入空模板
     - （仅ui项目） `design_tokens.json`: 基于「风格与调性」和「视觉参考」填充 aestheticDirection / primitivePalette / mode / motion / illustration / semanticTokens
     - `error_codes.json`: 基于任务列表预定义核心错误码
+    - （仅api项目） `api_snapshot.json`: 初始端点注册；Brief 有 API 描述时从中提取，否则写入空模板
+    - `env_registry.json`: 初始环境变量注册
+    - （仅cli项目） `command_api.json`: 初始命令注册；Brief 有命令描述时从中提取，否则写入空模板
+    - （仅lib项目） `public_api.json`: 初始导出注册；Brief 有导出描述时从中提取，否则写入空模板
 
-    仅ui项目: **UI 概念设计**: [[SKILL: archi-ui-wireframe|按 skill 的协议，自动生成 UI 概念设计。]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md` 并遵循其协议执行）]]
-    - 无需用户确认即开始生成
-    - 读取刚写入的 vision.md + roadmap.json + design_tokens.json + 02_tech_stack
-    - 写入 `ui_concept.html` + `ui_context.md`
-    - 输出 UI 概念设计摘要，等待用户确认或反馈调整
+    仅ui项目: **UI 概念设计**: 跳过 — 由 `/archi.ui` 独立完成。仅确保 `design_tokens.json` 已填充。
 
     ### 3.6 Map (`[[__DOCS_DIR__]]/global/map.json`)
     - `directoryMapping`: 基于 tech_stack 架构模式预注册核心目录骨架
@@ -165,12 +165,15 @@
 
     **Pre-signoff Checklist** (Gate 通过后、输出前须逐项确认):
     □ vision.md — 所有占位符已替换，无模板示例文字残留
-    □ 02_tech_stack.md — Section 1-9 完整填充，Section 9 Project Conventions 含 Strategy + Rationale
+    □ tech_stack.md — Section 1-9 完整填充，Section 9 Project Conventions 含 Strategy + Rationale
     □ roadmap.json — archi-decompose-roadmap Skill 已执行，任务链已生成
-    □ map.json — 核心目录骨架已预注册（directoryMapping）
-    □ dictionary.json + error_codes.json — 领域术语和核心错误码已提取
-    □ （仅ui项目）design_tokens.json + ui_concept.html + ui_context.md — 已生成
+    □ map.json — 核心目录骨架已预注册（directoryMapping + logicalTopology + featureRelations）
+    □ dictionary.json + error_codes.json + env_registry.json — 领域术语、核心错误码、环境变量已提取
+    □ （仅ui项目）design_tokens.json + ui_context.md — 已生成
     □ （仅data项目）data_snapshot.json — 初始实体骨架已写入
+    □ （仅api项目）api_snapshot.json — 初始 API 端点已注册
+    □ （仅cli项目）command_api.json — 初始 CLI 命令已注册
+    □ （仅lib项目）public_api.json — 初始库导出已注册
     □ Step 4 Silent Audit — 已执行，所有 CRITICAL 问题已修复
 
     **Action** (Checklist 全部确认后):
@@ -185,8 +188,9 @@
 
     | 优先级 | 行动 | 说明 |
     |:---|:---|:---|
-    | （仅ui项目） 推荐 | 审查 ui_concept.html | UI 概念设计已自动生成；在浏览器中确认布局和视觉效果 |
+    | （仅ui项目） 推荐 | `/archi.ui` | 生成 UI 概念设计（`screens/` 多文件结构） |
     | 推荐 | `/archi.plan INF-01` | 规划第一个基础设施任务 |
+    | （INF 完成后） | `/archi.script` | 生成 AI 自动化脚本（validate/dev-up/dev-reset） |
     | 可选 | `/archi.scope <scope-brief.md>` | 如有更多需求待分解，追加到 Roadmap |
 </step_5_signoff>
 

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

@@ -0,0 +1,113 @@
+<protocol_ui>
+  **Trigger**: `/archi.ui` | 自然语言触发时由 Workflow Dispatch 自动加载
+  **Goal**: 生成或增量更新多文件 UI 概念设计（`screens/` 目录）。
+
+<meta>
+    <style>Visual, Systematic, Incremental</style>
+    <language>简体中文</language>
+    <principles>
+      1.  **Auto-Detect**: 无子命令，自动检测 `screens/` 目录状态决定全量生成或增量更新。
+      2.  **Multi-File**: 每个屏幕独立 `S-XX.html`，共享样式 `_shared.css`，`index.html` 作导航枢纽。
+      3.  **Token-Driven**: 视觉样式严格来自 `design_tokens.json`，禁硬编码。
+      4.  **IDE-Native First**: 利用 IDE 原生能力驱动执行节奏，本协议定义质量标准和检查点，不对抗 IDE 的规划/执行机制。
+    </principles>
+</meta>
+
+<step_1_load>
+    **Action**:
+    1.  **Pre-flight**: 检查 `architext.json` → `features` 是否含 `ui`。不含 → 拒绝（"本项目未启用 UI 特征"）。
+    2.  **Load**: 读取项目上下文 + UI 相关 JSON（design_tokens、ui_context），详见 00_system.md 数据治理规则。
+    3.  **Mode Detection**:
+
+        | 条件 | 模式 | 行为 |
+        |:---|:---|:---|
+        | `screens/` 目录不存在 | **全量生成** | 从 roadmap 提取全部 UI 屏幕 → step_2 |
+        | `screens/` 存在 | **增量更新** | 对比 roadmap + ui_context.md，识别新增/变更屏幕 → step_2 |
+
+    **Output**: 模式判定结果 + 上下文摘要。进入 step_2_plan。
+</step_1_load>
+
+<step_2_plan>
+    **Action**:
+
+    **全量模式**: 从 roadmap 任务中提取所有涉及 UI 的屏幕，分配屏幕 ID（S-01, S-02...）。
+    **增量模式**: 对比现有 `screens/` 与 roadmap，识别差异：
+
+    | 差异类型 | 处理 |
+    |:---|:---|
+    | 新增屏幕（roadmap 有任务但无对应 S-XX） | 分配新 ID，加入生成清单 |
+    | 屏幕变更（已有屏幕的任务有需求变化） | 加入更新清单 |
+    | 无变化 | 跳过 |
+
+    **Tokens 检查**: 检查 `design_tokens.json`:
+    - `aestheticDirection.preset` 为空 → 引导选择
+    - `primitivePalette.brand` 为空 → 引导填入 Hex
+    - 其他空值 → AI 推断，非阻塞
+
+    **Output**: 屏幕规划清单（ID / 名称 / 对应任务 / 状态列表 / 操作：新增/更新/跳过）。
+
+    **Gate**: 用户回复 **OK** 后进入 step_3_generate；未确认禁生成文件。
+</step_2_plan>
+
+<step_2_5_refinement>
+    **Trigger**: 用户回复非 OK，含修正、增删屏幕或调整映射。
+    **Action**: 融入反馈，刷新屏幕规划清单重新输出，等待再次确认。
+
+    用户回复 OK → 进入 step_3_generate。
+</step_2_5_refinement>
+
+<step_3_generate>
+    **Action**: 调用 Skill 执行实际生成。
+
+    [[SKILL: archi-ui-wireframe|按 skill 的协议，基于确认的屏幕规划清单生成多文件 UI 概念设计。全量模式生成所有屏幕；增量模式仅生成新增/变更屏幕。]][[NO-SKILL: （Skill 未安装：请阅读 `[[__DOCS_DIR__]]/skills/archi-ui-wireframe/SKILL.md` 并遵循其协议执行）]]
+
+    **产出物**:
+    - `[[__DOCS_DIR__]]/global/screens/_shared.css` — CSS 变量（来自 design_tokens）+ 基础布局 + 控制栏样式
+    - `[[__DOCS_DIR__]]/global/screens/S-XX.html` — 每个屏幕独立文件
+    - `[[__DOCS_DIR__]]/global/screens/index.html` — 导航枢纽，列出所有屏幕
+    - `[[__DOCS_DIR__]]/global/ui_context.md` — AI 屏幕索引（路由引用 `screens/S-XX.html`）
+
+    **Output**: 生成文件清单 + 变更摘要。进入 step_4_verify。
+</step_3_generate>
+
+<step_4_verify>
+    **Role**: 独立审查官
+
+    **验证清单**:
+
+    | 检查项 | 通过标准 |
+    |:---|:---|
+    | 文件完整性 | `screens/` 含 `index.html` + `_shared.css` + 全部 `S-XX.html` |
+    | 跨文件链接 | `index.html` 中所有 `S-XX.html` 链接有效；每个 `S-XX.html` 含返回索引链接 |
+    | CSS 引用 | 每个 `S-XX.html` 引用 `_shared.css`；CSS 变量来自 design_tokens |
+    | 状态覆盖 | 每个屏幕含 default + 适用状态（loading/empty/error） |
+    | ui_context.md | 屏幕索引路由引用 `screens/S-XX.html` 路径 |
+    | （增量模式）已有屏幕 | 未修改的屏幕文件未被覆盖 |
+
+    有失败项 → 修复后重检。全部通过 → 进入 step_5_signoff。
+</step_4_verify>
+
+<step_5_signoff>
+    **Pre-signoff Checklist** (输出前须逐项确认):
+    □ `screens/` 目录结构完整（index.html + _shared.css + S-XX.html）
+    □ `ui_context.md` 已生成/更新，路径引用正确
+    □ Step 4 验证全部通过
+    □ （增量模式）仅目标屏幕被修改，其余文件未变
+
+    **Output**: UI 概念设计摘要，含：
+    - **模式**: 全量生成 / 增量更新
+    - **屏幕覆盖**: 共 N 个屏幕（新增 X / 更新 Y / 保留 Z）
+    - **审美方向**: preset + 品牌色
+    - **文件清单**: 生成/修改的文件列表
+
+    **用户确认**: 回复 **OK** 完成；非 OK 进入 Refinement（调用 Skill 局部更新）。
+
+    **Next Steps**:
+
+    | 优先级 | 动作 | 说明 |
+    |:---|:---|:---|
+    | 推荐 | 在浏览器打开 `screens/index.html` | 确认布局和视觉效果 |
+    | 1 | `/archi.plan <第一个 pending 任务 ID>` | 开始规划任务 |
+</step_5_signoff>
+
+</protocol_ui>

package/dist/templates/zh/docs/shared/ui-redlines.md

@@ -0,0 +1,7 @@
+**UI 设计红线（Anti-patterns）**:
+- **禁紫色渐变白底** — AI 默认审美标志
+- **禁 Emoji 代图标**（🔔📁⚙️）→ 用自绘 SVG 或声明的图标库
+- **禁所有屏幕同一居中卡片布局** → 列表/详情/表单须有明显差异
+- **禁纯黑+纯白** → 用有层次的灰度色板
+- **禁通用感** → 打开须一眼判断审美方向（Linear vs Notion vs Grafana）
+- **禁硬编码** — 颜色用 Token，间距用变量，非魔法数字

package/dist/templates/zh/docs/templates/spec.template.md

@@ -79,7 +79,7 @@ description: Task Specification for {FEATURE_NAME}.
 
 ## 5. Constraints
 
-<!-- [AI]: 从 vision.md + 02_tech_stack.md 提取与本任务相关的红线约束。
+<!-- [AI]: 从 vision.md + tech_stack.md 提取与本任务相关的红线约束。
 
   格式:
   - [约束内容] (ref: [来源])

package/dist/templates/zh/docs/templates/ui.template.md

@@ -1,12 +1,12 @@
 ---
-description: 任务级 UI 范围声明 — 描述本任务负责的屏幕/组件范围，屏幕 ID 来自 ui_context.md，视觉原型见 ui_concept.html（人看）。
+description: 任务级 UI 范围声明 — 描述本任务负责的屏幕/组件范围，屏幕 ID 来自 ui_context.md，视觉原型见 screens/（人看）。
 glue: 屏幕 ID 引用自 [[__DOCS_DIR__]]/global/ui_context.md；禁重定义整体布局或全局导航。
 ---
 
 # UI Scope: {FEATURE_NAME}
 
 > **Screen Index**: `[[__DOCS_DIR__]]/global/ui_context.md`（AI 读取屏幕 ID 和导航关系）
-> **Visual Prototype**: `[[__DOCS_DIR__]]/global/ui_concept.html`（人类浏览器预览）
+> **Visual Prototype**: `[[__DOCS_DIR__]]/global/screens/index.html`（人类浏览器预览，各屏幕 `screens/S-XX.html`）
 > **Tokens**: `[[__DOCS_DIR__]]/global/design_tokens.json`
 > **Protocol**: ITP v3.0（仅描述本任务边界内的组件树）
 
@@ -27,15 +27,15 @@ glue: 屏幕 ID 引用自 [[__DOCS_DIR__]]/global/ui_context.md；禁重定义
 ```text
 [ScreenName > 修改区域名]
   NewComponent [Col, Gap:4]      ← 本任务新增
-    ExistingComponent            ← ref: ui_concept.html S-XX (不修改)
+    ExistingComponent            ← ref: screens/S-XX.html (不修改)
     #NewSubComponents
 ```
 
-> **引用规则**: 已在 `ui_concept.html` 中定义的组件 → `ref: ui_concept.html#S-XX-组件名`；禁复制粘贴其结构。
+> **引用规则**: 已在 `screens/S-XX.html` 中定义的组件 → `ref: screens/S-XX.html#组件名`；禁复制粘贴其结构。
 
 ## 3. Interactions (本任务新增的交互)
 
-<!-- [AI]: 仅列出本任务引入的新交互；ui_concept.html 已有的交互不重复 -->
+<!-- [AI]: 仅列出本任务引入的新交互；screens/S-XX.html 已有的交互不重复 -->
 
 | Trigger | Target | Action |
 |:---|:---|:---|
@@ -43,9 +43,9 @@ glue: 屏幕 ID 引用自 [[__DOCS_DIR__]]/global/ui_context.md；禁重定义
 
 ## 4. States (本任务负责的状态渲染)
 
-<!-- [AI]: 若 ui_concept.html 的状态已充分描述，此处可省略或仅补充差异 -->
+<!-- [AI]: 若 screens/S-XX.html 的状态已充分描述，此处可省略或仅补充差异 -->
 
-| State | Delta from ui_concept.html |
+| State | Delta from screens/S-XX.html |
 |:---|:---|
-| `loading` | 同 ui_concept.html S-XX loading（无差异）|
+| `loading` | 同 screens/S-XX.html loading（无差异）|
 | `empty` | 本任务空态文案不同："{具体文案}" |