architext 0.0.4 → 0.0.5

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

@@ -11,18 +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 自动追加 |
-| `api_snapshot.json` | API 端点（仅api项目） | 实现/对接 HTTP 端点时 | `/archi.plan` Step 3 注册端点; Code 阶段同步实际路径 |
-| `env_registry.json` | 环境变量（仅api项目） | 引入新配置项时 | Code 阶段引入新 env var 后立即追加 |
-| `command_api.json` | 命令签名（仅cli项目） | 实现/修改 CLI 命令时 | `/archi.plan` Step 3 注册命令; Code 阶段同步实际签名 |
-| `public_api.json` | 公共导出（仅lib项目） | 新增/修改导出 API 时 | `/archi.plan` Step 3 注册导出; Code 阶段同步实际签名 |
+| 文件 | 读取时机 | 写入时机 |
+|:---|:---|:---|
+| `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 同步 |
 
 ---
 
@@ -30,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`, `api_snapshot.json`, `env_registry.json`, `command_api.json`, `public_api.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` 视图 |
 
 ---
@@ -60,68 +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 处理，禁注册到此文件。
-- **结构**: `businessErrors`（业务错误注册表）。HTTP 协议状态码映射见 `api_snapshot.json`。
-- **Code Format**: `ERR_[MODULE]_[REASON]` (如 `ERR_AUTH_INVALID_TOKEN`)。
-- **statusCode**: 按项目类型填写（HTTP status / Exit code / 留空）。
-- **Design Before Code**: 编写错误处理代码前须先在此注册错误码，含 `message` 和 `recovery`。
-- **可扩展**: 若现有字段不足以描述错误信息（如需记录 `severity`、`retryable`），可在 item 中自行添加字段。
+- **Boundary**: 仅注册项目业务域错误；框架基础设施错误禁注册。
+- **Code Format**: `ERR_[MODULE]_[REASON]`。
+- **Design Before Code**: 编写错误处理前须先注册，含 `message` 和 `recovery`。
 
-### `api_snapshot.json` （仅api项目）
+### 条件性文件专项
 
-- **结构**: `endpoints[]`（端点注册表）+ `protocolMapping[]`（HTTP 状态码→调用方行为映射）。
-- **Register First**: 规划端点前须先在此注册，禁实现未登记的端点。
-- **owner**: 每个端点须标注归属 Task ID，便于追踪变更来源。
-- **可扩展**: 可在 endpoint item 中追加 `tags`、`deprecated`、`version` 等字段。
-
-### `env_registry.json` （仅api项目）
-
-- **Register on Introduce**: 代码中每引入一个新的 `process.env.X` 或等价配置读取，须立即在此追加记录。
-- **required**: 必填项标 `true`；有合理默认值的标 `false` 并填写 `default`。
-- **example**: 须提供示例值，禁留空（帮助新成员快速配置环境）。
-- **可扩展**: 可追加 `sensitive`（是否为密钥）、`validValues`（枚举约束）等字段。
-
-### `command_api.json` （仅cli项目）
-
-- **Register on Introduce**: 每新增或修改 CLI 命令后同步更新此文件。
-- **owner**: 每条命令须标注归属 Task ID。
-- **可扩展**: 可追加 `examples`、`deprecated`、`since` 等字段。
-
-### `public_api.json` （仅lib项目）
-
-- **Stability First**: 导出 API 一旦标注 `stable`，变更须走 `/archi.edit` 流程，不可随意修改签名。
-- **signature**: 须写完整 TypeScript 签名，禁模糊描述（如"返回用户对象"）。
-- **owner**: 每条导出须标注归属 Task ID。
-- **可扩展**: 可追加 `since`、`examples`、`seeAlso` 等字段。
+| 文件 | 核心规则 |
+|:---|:---|
+| `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/skills/archi-decompose-roadmap/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: archi-decompose-roadmap
+type: subagent
 description: Architext 任务分解专家。五步分解法：先标定项目类型校准基建清单，再双视角提取业务 Task 和 Infra 任务，识别 Polish 打磨任务，NFR 横切关注点按权重决定注入或独立，建立真实依赖链并输出并行批次。任务通过 ID 前缀（INF/FEAT/POLISH/EDIT）编码类型，tag 字段承载业务领域标签。产出符合 Tier 1 Schema 的 roadmap.json 任务，作为 `/archi.plan` 的输入契约。
 ---
 
@@ -275,10 +276,6 @@ Brief → [本 Skill] → roadmap.json 任务
 }
 ```
 
-> **ID 前缀 vs tag 职责分离**：
-> - `id` 前缀（`INF-` / `FEAT-` / `POLISH-` / `EDIT-`）= 任务类型，决定 `/archi.plan` 的 spec 验收格式
-> - `tag` = 业务领域标签，仅用于人类分类浏览，不影响 AI 行为
-
 `deps` 为空或全部 `done` → `pending`；有未完成 deps → `blocked`
 
 ---
@@ -291,35 +288,7 @@ Brief → [本 Skill] → roadmap.json 任务
 
 产出三部分数据：
 
-**① 任务数据**（直接对应 `roadmap.json` 的 phases/tasks 结构）：
-
-```json
-{
-  "phases": [
-    {
-      "id": "phase-infra",
-      "name": "Infrastructure",
-      "tasks": [
-        { "id": "INF-01", "title": "...", "status": "pending", "description": "...", "goal": "...", "deps": [], "tag": "Infra", "slug": "..." }
-      ]
-    },
-    {
-      "id": "phase-core",
-      "name": "Core Features",
-      "tasks": [
-        { "id": "FEAT-01", "title": "...", "status": "blocked", "description": "...", "goal": "...", "deps": ["INF-01"], "tag": "Core", "slug": "..." }
-      ]
-    },
-    {
-      "id": "phase-polish",
-      "name": "Polish & Launch",
-      "tasks": [
-        { "id": "POLISH-01", "title": "...", "status": "blocked", "description": "...", "goal": "...", "deps": ["FEAT-01"], "tag": "Quality", "slug": "..." }
-      ]
-    }
-  ]
-}
-```
+**① 任务数据**：直接对应 `roadmap.json` 的 `phases[].tasks[]` 结构，每个 task 遵循上方 Task JSON Schema。phases 按 `phase-infra` → `phase-core` → `phase-polish` 排列。
 
 **② NFR 归并清单**（须随任务数据一并返回给调用方；调用方写入 roadmap 时追加为 `nfr` 顶层字段；`/archi.plan` 的 `step_1_load` 须读取此清单）：
 

package/dist/templates/zh/skills/archi-design-patterns/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: archi-design-patterns
+type: specialist
 description: Architext 技术方案结构化模式库。定义四种核心机制描述模式（State Machine / Pipeline / Decision Matrix / Protocol）的标准格式与自检清单，供 /archi.plan step_4 生成 design.md § 2 时引用，亦供 /archi.code step_5 审计实现与设计一致性时引用。
 ---
 

package/dist/templates/zh/skills/archi-interview-protocol/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: archi-interview-protocol
+type: specialist
 description: Architext 补充访谈协议。规范信息缺口的提问方式：选择题优先、AI 推荐 + [推荐] 标注、[Z] 自定义兜底、AI+/AI- 完整分析、选项说明描述具体行为。产出标准 Q-table 和 INPUT 提示行，供 /archi.start、/archi.scope、/archi.plan 的补充确认步骤引用。
 ---
 
@@ -19,7 +20,7 @@ description: Architext 补充访谈协议。规范信息缺口的提问方式：
 > - 负责：问题如何提（格式/规则/语气）
 > - 不负责：问什么内容（由调用方的缺口列表决定）、用户回答后如何处理（由调用方决定）
 
-## 调用方与触发条件
+## 调用模式
 
 | 调用方 | 触发步骤 | 触发条件 | 问题数上限 |
 |:---|:---|:---|:---|

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（架构建议阶段）引用。
 ---