architext 0.0.3 → 0.0.5

package/dist/templates/zh/skills/archi-plan-options/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: archi-plan-options
+type: subprocess
 description: Architext 架构决策选项库。定义五个核心维度（Core Structure / Interaction Pattern / Data Flow / Error Handling / Access & Scope）的候选方案及 AI+/AI- 分析，覆盖 Web/CLI/API/Lib/Mobile/MiniApp/Extension/Desktop/AI Agent 等项目类型。含约定继承规则、项目标签路由逻辑、推荐 vs 展开判断准则，供 /archi.plan step_2 Part 2（架构建议阶段）引用。
 ---
 
@@ -36,7 +37,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 
 ### Step 2 · 项目标签路由
 
-根据 step_1_load 已激活的项目标签（`[?UI]` / `[?Data]` / `[?CLI]` / `[?Lib]` / `[?API]` / `[?Mobile]` / `[?MiniApp]` / `[?Extension]` / `[?Desktop]` / `[?AI]`）选择适用维度，跳过不适用的维度。路由规则见各维度标题。
+根据 step_1_load 已激活的项目 features（`ui` / `data` / `cli` / `lib` / `api` / `mobile` / `miniapp` / `extension` / `desktop` / `ai`）选择适用维度，跳过不适用的维度。路由规则见各维度标题。
 
 ### Step 3 · 推荐 vs 展开
 
@@ -53,7 +54,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 
 根据项目标签路由到对应选项库：
 
-### [?Data] 数据模型与关系策略
+### 仅data项目: 数据模型与关系策略
 
 > 决定此功能的数据如何存储和组织。
 
@@ -67,7 +68,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | F | Virtual / Computed | 数据不直接存储，从其他字段实时计算，适合衍生数据、统计聚合、格式化展示 | 无需数据迁移，数据始终与源保持一致 | 计算逻辑分散在查询层，AI 易写出 N+1 查询或低效聚合语句 |
 | Z | 自定义 | (请描述你的数据结构方案) | - | - |
 
-### [?CLI] 输入/输出与配置设计
+### 仅cli项目: 输入/输出与配置设计
 
 > 决定此功能如何接收输入、以什么形式输出结果。
 
@@ -80,7 +81,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | E | Stdin / Pipe | 从标准输入或管道接收数据。适合数据处理管道、与 Unix 命令组合使用 | 输入格式可定义清晰的 Parser 契约 | 流式读取和编码处理易出错，须处理空输入和超大文件 |
 | Z | 自定义 | (请描述你的输入/输出方案) | - | - |
 
-### [?Lib] 公共 API 与类型设计
+### 仅lib项目: 公共 API 与类型设计
 
 > 决定此功能暴露给消费者的接口形态。
 
@@ -93,7 +94,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | E | Plugin / Middleware | 核心精简，功能通过插件/中间件扩展。适合需要高度可扩展的框架级库 | 核心代码简单，AI 可独立生成每个插件 | 插件间交互、执行顺序和类型安全难以保证，AI 易生成相互冲突的插件 |
 | Z | 自定义 | (请描述你的 API 设计方案) | - | - |
 
-### [?API] 接口契约与路由设计
+### 仅api项目: 接口契约与路由设计
 
 > 决定此功能的 API 端点结构和调用方式。
 
@@ -105,7 +106,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Nested Sub-resource | 嵌套路由表达从属关系，如 `GET /users/:id/posts`。适合资源间有明确父子关系的场景 | 路由结构反映数据关系，AI 可从路由推断查询逻辑 | 嵌套超 2 层路由冗长，权限检查须逐级验证父资源所有权 |
 | Z | 自定义 | (请描述你的 API 设计方案) | - | - |
 
-### [?Mobile] 导航架构策略
+### 仅mobile项目: 导航架构策略
 
 > 决定此功能在移动端导航体系中的位置与流转方式。
 
@@ -117,7 +118,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Modal / Bottom Sheet | 模态页面或底部弹出面板，不脱离当前上下文。适合快速操作、筛选、确认等次级流程 | 上下文局部化，不跳转根页面，AI 生成条件渲染逻辑准确 | Focus Trap、手势关闭、键盘弹起适配 AI 常处理不完整；iOS/Android 行为差异多 |
 | Z | 自定义 | (请描述你的移动端导航方案) | - | - |
 
-### [?MiniApp] 页面架构与请求策略
+### 仅miniapp项目: 页面架构与请求策略
 
 > 决定此功能在小程序页面体系中的组织形式和网络请求封装方式。
 
@@ -129,7 +130,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | WebView Hybrid | 部分功能通过 WebView 内嵌 H5 页面实现，适合复杂富文本编辑或已有 Web 资产复用 | 可复用 Web 技术栈，功能完整性高 | WebView 与原生通信通过 bridge，AI 生成消息协议易有兼容性问题；受平台沙箱限制 |
 | Z | 自定义 | (请描述你的小程序页面方案) | - | - |
 
-### [?Extension] 架构层分配策略
+### 仅extension项目: 架构层分配策略
 
 > 决定此功能的核心逻辑部署在 Background Service Worker、Content Script 还是 Popup 层。
 
@@ -141,7 +142,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Full Architecture | Background + Content + Popup 各承担特定职责，通过消息总线协调。适合功能复杂的综合型扩展 | 职责分层明确，各层可独立开发和测试 | 三层消息协议复杂，AI 容易遗漏消息路由或混淆发送方/接收方 |
 | Z | 自定义 | (请描述你的扩展架构方案) | - | - |
 
-### [?Desktop] 进程模型与 IPC 策略
+### 仅desktop项目: 进程模型与 IPC 策略
 
 > 决定此功能的业务逻辑如何在主进程（Main）与渲染进程（Renderer）之间分配。
 
@@ -152,7 +153,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | C | Worker Thread | 计算密集型逻辑迁移至 Worker Thread，避免阻塞 UI 线程。适合文件处理、数据转换等重型任务 | 将重型任务与 UI 解耦，响应性好 | Worker Thread 无法直接访问 DOM 和 IPC，须通过 MessageChannel 通信，AI 容易遗漏序列化约束 |
 | Z | 自定义 | (请描述你的桌面端进程分配方案) | - | - |
 
-### [?AI] LLM 集成与 Agent 架构策略
+### 仅ai项目: LLM 集成与 Agent 架构策略
 
 > 决定此功能如何集成 LLM 能力、组织 Prompt 和管理 Agent 执行流程。
 
@@ -168,7 +169,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 
 ## 维度 2 · Interaction Pattern（必用）
 
-### [?UI] 展示与交互模式
+### 仅ui项目: 展示与交互模式
 
 > 决定用户看到什么界面、如何操作。
 
@@ -182,7 +183,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | F | Editor / Canvas | 富文本编辑区或画布式自由操作区域。适合内容创作/可视化编辑 | 功能上限高，用户自由度大 | Canvas 是指令式 API，比声明式 DOM 难生成得多；Selection API 极为复杂 |
 | Z | 自定义 | (请描述你的交互方案) | - | - |
 
-### [?CLI] 用户交互模式
+### 仅cli项目: 用户交互模式
 
 > 决定用户如何与此 CLI 功能互动、看到什么反馈。
 
@@ -195,7 +196,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | E | Watch / Daemon | 持续运行并监听变化，自动触发操作。适合开发工具、文件同步、自动构建 | 事件驱动模型清晰，每次触发独立处理 | 跨平台文件监听兼容性、防抖逻辑、优雅退出处理难点多 |
 | Z | 自定义 | (请描述你的交互方案) | - | - |
 
-### [?API] 客户端集成模式
+### 仅api项目: 客户端集成模式
 
 > 决定调用方如何接入和使用此 API。
 
@@ -207,7 +208,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Webhook / Event | API 通过 Webhook 回调主动通知客户端。适合异步事件驱动场景 | 解耦，异步通知无需轮询 | Webhook 的签名验证、重试幂等、超时处理 AI 容易遗漏 |
 | Z | 自定义 | (请描述你的集成方案) | - | - |
 
-### [?Lib] 消费者使用模式
+### 仅lib项目: 消费者使用模式
 
 > 决定消费者如何使用此库的功能。
 
@@ -218,7 +219,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | C | Decorator / Annotation | 通过装饰器声明行为。适合框架级库，声明式配置减少样板代码 | 声明式代码简洁，意图清晰 | TS 装饰器提案仍在演进，AI 可能混淆旧版和新版语法 |
 | Z | 自定义 | (请描述消费者的使用方式) | - | - |
 
-### [?Mobile] 移动端交互模式
+### 仅mobile项目: 移动端交互模式
 
 > 决定用户在移动设备上如何操作此功能、看到何种反馈。
 
@@ -230,7 +231,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Bottom Sheet / Action Sheet | 点击触发底部滑出面板或操作菜单。适合次级操作、筛选、快速选择 | 无需路由跳转，上下文局部化 | 手势关闭、键盘配合、嵌套滚动须精细处理；iOS/Android 行为差异 AI 常忽略 |
 | Z | 自定义 | (请描述你的移动端交互方案) | - | - |
 
-### [?MiniApp] 小程序交互模式
+### 仅miniapp项目: 小程序交互模式
 
 > 决定用户在小程序内如何与此功能交互。
 
@@ -241,7 +242,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | C | Half-Screen / Full-Screen Popup | 半屏弹窗或全屏覆盖层。适合详情查看、确认操作、筛选面板 | 弹窗结构明确，AI 生成条件渲染逻辑准确 | z-index 层级管理和动画过渡须注意微信小程序的渲染层特殊性 |
 | Z | 自定义 | (请描述你的小程序交互方案) | - | - |
 
-### [?Extension] 扩展交互入口模式
+### 仅extension项目: 扩展交互入口模式
 
 > 决定用户通过何种入口与扩展功能交互。
 
@@ -253,7 +254,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Side Panel | 浏览器侧边栏（Chrome sidePanel API），常驻于浏览器右侧。适合持续使用的工具面板 | 有完整页面空间，与浏览器原生集成，UX 自然 | sidePanel API 较新，跨浏览器兼容性有限；须用户主动开启 |
 | Z | 自定义 | (请描述你的扩展交互方案) | - | - |
 
-### [?Desktop] 桌面端交互模式
+### 仅desktop项目: 桌面端交互模式
 
 > 决定用户如何与此桌面应用功能交互，以及使用哪种系统级 UI 范式。
 
@@ -265,7 +266,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Native Dialogs | 使用系统原生文件选择器、对话框、通知。适合文件操作、系统级提醒场景 | 原生对话框零样式维护成本，用户熟悉 | 原生对话框 API 在 Electron/Tauri 中调用方式不同，须查文档确认 |
 | Z | 自定义 | (请描述你的桌面端交互方案) | - | - |
 
-### [?AI] Agent 交互输出模式
+### 仅ai项目: Agent 交互输出模式
 
 > 决定用户如何触发 AI 能力，以及如何接收 AI 的输出结果。
 
@@ -281,10 +282,10 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 
 ## 维度 3 · Data Flow
 
-**适用条件**: 项目含 `[?UI+Data]` 或 `[?UI+API]` 标签时适用；纯 `[?CLI]`/`[?Lib]` 跳过。
+**适用条件**: 项目含 `（仅ui且data项目）` 或 `（仅ui且api项目）` 标签时适用；纯 `（仅cli项目）`/`（仅lib项目）` 跳过。
 **约定继承**: `02_tech_stack.md` §9 Data Flow 有值 → 自动继承，不展开选项表。仅当此功能需偏离项目默认时才展开。
 
-### [?UI] 状态同步与数据流
+### 仅ui项目: 状态同步与数据流
 
 > 数据如何在前端界面和后端之间流转和同步。
 
@@ -319,10 +320,10 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 
 ## 维度 5 · Access & Scope
 
-**适用条件**: 项目含 `[?Web/API]` 标签时提问权限控制；含 `[?MiniApp]` 标签时提问小程序授权模式；含 `[?Lib]` 标签时提问封装策略；纯 `[?CLI]` 通常跳过。
+**适用条件**: 项目含 `仅ui或api项目:` 标签时提问权限控制；含 `仅miniapp项目:` 标签时提问小程序授权模式；含 `仅lib项目:` 标签时提问封装策略；纯 `仅cli项目:` 通常跳过。
 **约定继承**: `02_tech_stack.md` §9 Auth & Access 有值 → 认证**机制**继承（如 JWT/RBAC），但**权限级别**仍为功能级决策（如某功能 Public vs Owner Only）。
 
-### [?Web/API] 权限控制
+### 仅ui或api项目: 权限控制
 
 > 谁能执行此功能的操作、看到什么数据。认证机制继承项目约定，此处仅决定此功能的权限级别。
 
@@ -336,7 +337,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | F | Tier / Subscription | 按付费等级限制功能。适合 SaaS 产品的分级功能 | 规则可配置化，与业务逻辑解耦 | Mock 支付状态和计费逻辑困难，测试需要大量 fixture 数据 |
 | Z | 自定义 | (请描述你的权限方案) | - | - |
 
-### [?MiniApp] 小程序授权模式
+### 仅miniapp项目: 小程序授权模式
 
 > 决定此功能需要哪种平台授权级别。
 
@@ -348,7 +349,7 @@ description: Architext 架构决策选项库。定义五个核心维度（Core S
 | D | Full Profile Auth | 请求完整用户资料授权（昵称/头像）。适合社交类功能或需要展示用户信息的场景 | 一次授权获取完整用户信息 | 微信已于 2022 年收紧此授权，须用新版 getUserProfile API，旧版 getUserInfo 已废弃，AI 训练数据中旧版代码较多易混淆 |
 | Z | 自定义 | (请描述你的小程序授权方案) | - | - |
 
-### [?Lib] 封装与可见性
+### 仅lib项目: 封装与可见性
 
 > 此功能的代码如何组织封装，对消费者暴露什么。
 

package/dist/templates/zh/skills/archi-silent-audit/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: archi-silent-audit
+type: reviewer
+description: 嵌入式轻量审查。在独立上下文中审查主 Agent 产出，按模式筛选审查维度，返回发现列表。禁生成报告文件。与 audit.md 共享维度定义但职责不同：audit.md 是用户主动触发的独立深度审查，本 Skill 是协议自动触发的轻量检查。
+---
+
+# 嵌入式轻量审查
+
+## 系统流程定位
+
+```
+/archi.* step_N → Verify 阶段
+    ↓
+[本 Skill] 接收模式参数 → 独立审查 → 返回发现列表
+    ↓
+主 Agent Signoff（须回应发现）
+```
+
+> **Skill 的职责边界**：
+> - 负责：在独立上下文中审查主 Agent 产出，输出分级发现列表
+> - 不负责：修复问题（交还主 Agent）、生成报告文件（那是 audit.md 的职责）、执行 Terminal Gate 命令
+
+> **与 `audit.md` 的关系**：
+> - `audit.md` = 独立深度审查协议，生成报告文件，仅用户主动触发 `/archi.audit`
+> - 本 Skill = 嵌入式轻量检查，inline 返回发现列表，协议自动触发
+> - 两者共享审查维度定义（见 `audit.md` step_2_task），本 Skill 按模式筛选执行
+
+---
+
+## 模式与审查维度
+
+### 模式 `init` (调用方: start, inherit)
+
+审查新建项目/继承项目的全局文件质量。
+
+| # | 维度 | 审查要点 |
+|:---|:---|:---|
+| 1 | **Vision-Roadmap 对齐** | roadmap 任务方向与 vision.md 北极星指标是否一致 |
+| 2 | **Tech Stack 一致性** | `02_tech_stack.md` 与实际依赖/配置是否一致 |
+| 3 | **全局文件完整性** | 须存在的全局文件是否齐全（vision, roadmap, map, dictionary, tech_stack, custom_rules） |
+| 4 | **信息零遗漏** | Brief/代码中的所有信息是否已路由到对应文件 |
+| 5 | 仅ui项目: **Design Tokens** | `design_tokens.json` 含基础颜色/字体/间距定义 |
+
+### 模式 `plan-docs` (调用方: plan)
+
+审查规划文档（spec/ui/plan）的质量。
+
+| # | 维度 | 审查要点 |
+|:---|:---|:---|
+| 1 | **Design Fidelity** | spec § 2 是否完整覆盖确认的功能设计 |
+| 2 | **Dimension Match** | spec § 2 维度格式是否与 Task Type 匹配 |
+| 3 | **Tech Consistency** | 是否用了 `02_tech_stack.md` 未声明的技术 |
+| 4 | **WBS Coverage** | plan.json 是否 100% 覆盖 spec 的每个 AC 条目 |
+| 5 | **Notes Quality** | plan.json 每个 task 的 notes 是否含产出物+约束+可执行验证 |
+| 6 | **Interface Exports** | INF 任务 § 4 是否填写；有下游 deps 时是否声明接口 |
+| 7 | **Constraints** | § 5 是否含 vision.md + tech_stack 相关红线 |
+| 8 | 本任务涉及data时: **Data Integrity** | 实体和字段与确认的核心实体是否一致 |
+| 9 | 仅Complex任务: **Design Trace** | design.md § 6 是否所有 AC 均可追踪 |
+| 10 | 仅Complex任务: **Parameter Specificity** | design.md § 3 参数是否具体化（无模糊词） |
+| 11 | 仅Complex任务: **Self-Check Pass** | design.md § 2 机制自检清单是否通过 |
+
+### 模式 `code-impl` (调用方: code)
+
+审查代码实现的质量。
+
+| # | 维度 | 审查要点 |
+|:---|:---|:---|
+| 1 | **Tech Consistency** | 与 `02_tech_stack.md` 一致（库/模式/API 风格） |
+| 2 | **SOTA** | 拒绝过时模式；采用 tech_stack 最佳实践 |
+| 3 | **Security** | 无敏感信息泄露；输入有校验 |
+| 4 | **Performance** | 避免不必要大依赖/全量导入/无用计算/内存泄漏 |
+| 5 | 本任务涉及ui时: **Design Compliance** | 样式仅用 Token/Preset 视觉模式；无硬编码魔法值 |
+| 6 | 本任务涉及ui时: **Accessibility** | 含必要无障碍属性 |
+| 7 | 本任务涉及data时: **Data Integrity** | 符合 `data_snapshot.json`；字段名/类型一致 |
+| 8 | 仅i18n项目: **I18n** | 无硬编码字符串；须用 Key/字典引用 |
+| 9 | 仅Complex任务: **Design Compliance** | 状态转移/流程/协议与 design.md § 2 一致 |
+| 10 | 仅Complex任务: **Invariant Enforcement** | design.md § 4 不变量在代码中有 assert/运行时检查 |
+| 11 | 仅Complex任务: **Parameter Alignment** | 代码数值与 design.md § 3 参数表一致 |
+
+---
+
+## 执行协议
+
+1. **读取上下文**: 按调用方传入的文件路径加载所需文档和代码
+2. **按模式筛选维度**: 仅执行当前模式对应的审查维度表
+3. **逐项审查**: 每个维度输出 PASS 或发现（含级别+位置+描述）
+4. **输出发现列表**: 按级别排序返回
+
+### 发现级别
+
+| 级别 | 含义 | 主 Agent 须 |
+|:---|:---|:---|
+| `CRITICAL` | 阻塞性问题 | **须修复**后再签收，禁跳过 |
+| `WARNING` | 有风险 | **须在签收报告中说明**处理方式 |
+| `INFO` | 建议优化 | 可自行决定是否处理 |
+
+### 输出格式
+
+```
+### Silent Audit Results (mode: <mode>)
+
+**CRITICAL** (须修复):
+- [维度名] 位置: 描述
+
+**WARNING** (须说明):
+- [维度名] 位置: 描述
+
+**INFO** (建议):
+- [维度名] 位置: 描述
+
+**Summary**: X CRITICAL / Y WARNING / Z INFO
+```
+
+无发现时输出: `### Silent Audit Results (mode: <mode>) — ALL PASS`
+
+---
+
+> **中间产物**：此 Skill 为审查型子程序，产出发现列表后控制权交还调用方，由主 Agent 在 Signoff 中回应发现。