@c4a/context-cli 0.7.5 → 0.7.9

package/plugins/skills/context-code-indexer/templates/articles/f06.md

@@ -0,0 +1,32 @@
+---
+id: context.article.f06
+kind: procedure
+media-type: text/markdown
+program:
+  article: f06
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 模型范围
+    catalog: 类型目录
+    roles: DTO 与视图模型
+    mapping: 转换与校验
+    authority: 权威与生成关系
+    references: 使用与源码
+---
+
+# F06 类型模型
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：DTO、请求／响应、View Model 或生成类型的映射对理解应用有价值。
+
+建议章节：**类型来源与生成边界 → 核心类型 → 页面与 API 类型链路 → 转换及兼容约束 → 修改入口**。
+
+表格列：类型名、类别、关键字段语义、使用位置、权威来源；链路表列页面／能力、View Model、Request、Response、转换函数。仅保留稳定且被使用的类型；完整声明仍留源码或契约引用，不恢复长段 Source type declaration。
+
+## 图示选择
+
+类型目录优先表格；转换关系用 flowchart，不把 DTO 直接画成数据库实体。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/f07.md

@@ -0,0 +1,31 @@
+---
+id: context.article.f07
+kind: procedure
+media-type: text/markdown
+program:
+  article: f07
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 复用范围
+    catalog: 组件地图
+    parents: 父页面与调用方
+    dependencies: 封装与依赖库
+    references: 详情与修改入口
+---
+
+# F07 应用内组件与复用边界
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：定位页面需要认识共享组件、wrapper、provider 或远程组件。
+
+建议章节：**组件分层 → 组件与使用方 → 包装和注入 → 公共契约入口 → 修改影响与排查起点**。
+
+记录组件身份、所在包／文件、调用页面、主要职责、公共库或内部实现。复杂内部组件按任务使用 F12 定位与修改指南，短内容留在本篇或 F03；形成明确公共消费边界的组件使用 L02 公共组件参考。页面内部组件不因 export 自动升级为组件库或拆成大量 Props 页。
+
+## 图示选择
+
+组件地图用 text 树；跨父层依赖用 flowchart，明确调用方与公开库边界。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/f08.md

@@ -0,0 +1,36 @@
+---
+id: context.article.f08
+kind: procedure
+media-type: text/markdown
+program:
+  article: f08
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    systems: 使用的组件库与设计系统
+    layers: 样式分层
+    tokens: Token 定义与消费
+    overrides: 局部覆盖
+    platforms: 主题与平台差异
+    accessibility: 响应式与可访问性
+    examples: 调整入口与示例
+    references: 系统规范与源码
+---
+
+# F08 样式与设计系统
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：存在影响页面开发的主题、token、样式覆盖或组件库接入规则。
+
+建议章节：**使用的组件库与设计系统 → 样式组织 → Token 与主题 → 覆盖顺序和隔离 → 响应式／可访问性 → 调整入口与示例**。
+
+保留 token 身份、定义／消费位置、配置与维护示例。响应式断点、无障碍保证和颜色语义需代码／规范支持。设计稿与代码不一致时标明版本，不从截图猜 Props 或 token。
+
+本篇负责应用如何消费和覆盖；系统自身的规范、基础资源和跨平台映射归 L03 独立设计系统模板。一组 CSS 变量不足以证明存在完整设计系统；没有系统资料时仍可写真实样式入口。
+
+## 图示选择
+
+token 定义/覆盖可用 flowchart；实际颜色或响应式外观使用授权来源图，代码不证明视觉效果。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/f09.md

@@ -0,0 +1,32 @@
+---
+id: context.article.f09
+kind: procedure
+media-type: text/markdown
+program:
+  article: f09
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 工程与交付边界
+    prerequisites: 运行前提
+    commands: 构建与测试入口
+    deployment: 部署与配置
+    verification: 验证与回滚
+    references: 相关资料
+---
+
+# F09 构建与部署
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：有项目拥有的脚本、工程配置或交付文档。
+
+建议章节：**开发前提 → 本地启动与调试 → 构建入口及产物 → 环境选择 → 发布与回滚入口 → 常见定位点**。
+
+命令来自 scripts／维护文档；说明包与执行目录、配置生效位置、产物身份。已存在发布脚本不等于线上已部署；仓库证据不足的真实平台值不补写。公共工程规则由一篇父级指南承载，子应用只写差异。
+
+## 图示选择
+
+构建交付顺序用 flowchart；命令和前提保留文字，步骤计划不代表执行回执。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/f10.md

@@ -0,0 +1,32 @@
+---
+id: context.article.f10
+kind: procedure
+media-type: text/markdown
+program:
+  article: f10
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    roles: 宿主与 Remote
+    registration: 注册与 Expose
+    loading: 加载和生命周期
+    sharing: 共享依赖与上下文
+    failures: 错误与兼容边界
+    references: 源码导航
+---
+
+# F10 宿主与微前端
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：存在 federation、remote／expose、host bridge 或类似跨应用运行契约；普通 SPA 不生成。
+
+建议章节：**运行角色与拓扑 → 注册和加载 → Expose 与源码 → 生命周期及注入 → 跨应用通信 → 共享依赖与隔离 → 加载失败排查**。
+
+表格列：host／remote 身份、注册位置、入口或 manifest、expose 到文件、共享依赖约束、调用方。区分远程资源定位、模块加载和内部业务行为。特定框架的识别规则由已授权扩展提供，通用模板只定义信息责任。
+
+## 图示选择
+
+宿主/remote 边界用 flowchart；已证实加载交互用 sequenceDiagram，外部实现缺失处停止。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/f11.md

@@ -0,0 +1,39 @@
+---
+id: context.article.f11
+kind: procedure
+media-type: text/markdown
+program:
+  article: f11
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 子应用范围
+    catalog: 子应用目录
+    ownership: 入口与职责
+    integration: 宿主接入
+    contracts: 共享契约
+    capabilities: 暴露能力与入口
+    navigation: 页面与 API 导航
+    delivery: 开发交付差异
+    details: 详情与下一步
+---
+
+# F11 子应用目录与详情
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：有独立构建／运行／所有权边界或宿主注册支持子应用身份。
+
+目录章节：**宿主职责 → 子应用登记表 → 共享契约 → 子应用导航**。登记表列名称、模块路径、运行身份、入口、归属依据、相关页。
+
+详情章节：**业务定位 → 对宿主的依赖 → 暴露能力与入口 → 页面／API 导航 → 开发交付差异**。复杂子应用再组合 F01–F10，简单子应用保留详情一篇即可。页面、tab 和弹窗不自动变为子应用。
+
+## 前端领域模型如何处理
+
+前端可组合 S04 领域模型，描述页面可证实的业务实体、权限和状态。区分展示状态与服务端权威状态；不因文章位于 frontend 就复制一套服务端规则。状态实现细节仍由 F04 承载。
+
+## 图示选择
+
+子应用目录用 text 树或表格；单应用接入在职责章节用 flowchart，避免重复整个宿主图。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/f12.md

@@ -0,0 +1,59 @@
+---
+id: context.article.f12
+kind: procedure
+media-type: text/markdown
+program:
+  article: f12
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 职责与父层
+    callers: 调用方与输入
+    behavior: 行为与状态
+    dependencies: 组件及请求依赖
+    change: 修改入口
+    verification: 测试与验证
+---
+
+# F12 应用内部组件定位与修改指南
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+### 什么时候单独成篇
+
+有独立维护任务、被多个页面使用、包装了复杂公共组件、控制关键交互或需要解释父子协作时，可形成一篇指南。普通展示组件、页面局部图标和简单 wrapper 默认留在 F07 组件地图 或 F03 页面详情内。
+
+内部组件可以 export，也可以有 Props 和 story；这些不自动证明它是面向跨模块消费者的稳定公共契约。有明确跨模块消费边界的共享包则使用 L02，无需以是否发布 npm 作为唯一判断。
+
+### 默认章节
+
+```markdown
+# <组件名称>：职责与修改入口
+## 所属页面与职责
+## 调用入口与使用方
+## 输入、回调与依赖
+## 状态与交互流程
+## 修改注意与验证入口
+## 相关代码和公共组件
+```
+
+| 章节 | 内容要求 |
+| --- | --- |
+| 所属页面与职责 | 所属应用／模块、渲染任务、与页面或公共库的边界 |
+| 调用入口与使用方 | 已核实的父组件／页面、路由或调用点；未遍历全部消费者则只声明已知范围 |
+| 输入、回调与依赖 | 影响理解任务的关键 Props、回调、store/query/context 和公共组件；无需默认生成所有内部字段表 |
+| 状态与交互流程 | 哪一层决定显隐／禁用、哪些值由父层传入、本组件做哪些动作；入口版给具体读取位置，深入后才解释全条件 |
+| 修改注意与验证入口 | 已有单测／集成／story／页面验证入口、已知影响面；不编造测试通过或穷尽性 |
+| 相关代码和公共组件 | 实现、调用方、依赖公共组件契约与版本；公共库 API 通过链接引用 |
+
+### 与公共组件参考的区别
+
+这类文章优先回答“在哪个页面、谁传值、改哪里、怎么核对”，不默认写安装包、稳定兼容承诺、全套主题规范和迁移指南。局部代码可以提供可复用模式，但要区分已有团队约定与 Agent 的建议。
+
+内部组件被提升为公共组件时，重新依据实际消费边界选择 L02，并保留原页面到公共入口的链接；不能仅改变文章标题就宣称 API 稳定。
+
+## 图示选择
+
+组成层级用 text 树，父子交互用 flowchart 或 sequenceDiagram；复杂展示条件回到父层。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/l01.md

@@ -0,0 +1,38 @@
+---
+id: context.article.l01
+kind: procedure
+media-type: text/markdown
+program:
+  article: l01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 用途与适用范围
+    installation: 安装与初始化
+    capabilities: 主要能力
+    usage: 典型用法
+    contracts: 契约与扩展点
+    limits: 限制与兼容
+    references: 源码与验证入口
+  contract_table: contract_api
+---
+
+# L01 公共能力与使用指南
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**用途和适用场景 → 支持的导入／命令 → 初始化及前提 → 能力分组 → 维护示例 → 兼容与修改入口**。
+
+能力表列：能力身份、入口、使用方、对应契约和示例。SDK 初始化、CLI 参数与插件注册各用已有专门模板；不复制源码中所有 export。可补分层架构、provider／middleware 和维护约定，但必须服务具体读者任务。
+
+## 公共组件与设计系统的专用标准
+
+L02 公共组件 已独立细化建议章节、家族、Props／事件／方法／Ref、示例与行为变体。非 UI 的公共 API 仍沿用对应 SDK／CLI 程序模板与 L01 的消费原则，不强套 UI 的样式／焦点章节。
+
+L03 设计系统 独立覆盖系统入口、基础规范、主题接入和平台版本关系，避免缩成组件库的一小段颜色说明。
+
+## 图示选择
+
+接入调用有顺序要求时用 sequenceDiagram；命令/签名用表格，模块层次用 text 树。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/l02.md

@@ -0,0 +1,103 @@
+---
+id: context.article.l02
+kind: procedure
+media-type: text/markdown
+program:
+  article: l02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 用途与选用
+    setup: 接入与基本用法
+    scenarios: 场景与变体
+    behavior: 行为与组合规则
+    styles: 样式与设计系统
+    limits: 环境可访问性与限制
+    references: 相关组件与源码入口
+  contract_table: api
+---
+
+# L02 公共组件与组件家族
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+### 身份与拆页条件
+
+先确认包／公开入口、组件名、平台、适用版本、稳定或弃用状态。仓内共享组件如果有明确跨模块消费契约，即使未发布 npm，也可按公共组件处理；单纯 export、放在 components/ 或出现在演示站不构成公共性证明。
+
+默认按读者会选择和使用的能力成页。主组件、仅供其使用的 part、配置类型及辅助 hook 可以同页；独立公共能力、独立运行契约或明显不同平台再拆。静态方法不是第二个 SDK，Props 类型不是另一篇组件文章。
+
+Toast 类家族可以先给成员选择表，再按成员或调用方式分节；复杂家族可以保留一篇入口和少量详情。不因为导出多个符号就强制多页，也不因同名而合并不同平台、包版本和 deprecated 实现。
+
+### 默认文章结构
+
+以下八个章节角色和顺序稳定。1、2、4、8 是基本阅读责任；其他章节按事实适用性出现。没有资料支撑的示例可以只保留维护示例入口和具体缺失前提，不能补造行为。
+
+```markdown
+# <组件或家族名称>
+> 包与导入入口 · 平台 · 适用版本 · 维护状态
+
+## 用途与选用
+## 接入与基本用法
+## 典型场景与变体
+## API
+## 行为与组合规则
+## 样式与设计系统
+## 运行环境、可访问性与限制
+## 相关组件与源码入口
+```
+
+| 章节 | 应回答什么 | 内容形式与证据 |
+| --- | --- | --- |
+| 用途与选用 | 解决什么界面任务；与相近组件如何区分 | 简短用途；家族成员／选型表；产品语义来自维护说明或用法，不能按组件名发明设计建议 |
+| 接入与基本用法 | 怎么导入、先配置什么、最少怎样使用 | 精确 import／entry、必要 Provider／CSS 链接、最小有来源示例；示例依赖不能只存在于演练场隐藏 scope |
+| 典型场景与变体 | 哪些选择会改变使用方式 | 场景→相关 API→预期表现→示例；按行为差异选取，不枚举所有颜色和大小的笛卡尔积 |
+| API | 消费者能传什么、调用什么、收到什么 | 下述分类契约表；公共关键配置类型可在本节局部解释，规范信息只维护一份 |
+| 行为与组合规则 | 状态谁控制、如何交互、配置如何叠加 | 受控／非受控、回调、数据结构、覆盖顺序、关闭／清理、组合约束；具体内容由组件能力决定 |
+| 样式与设计系统 | 哪些是组件可覆盖项、哪些来自全局系统 | 变体、尺寸、slot、token、逻辑方向等具体差异；公共基础规范链接到设计系统，不整篇复制 |
+| 运行环境、可访问性与限制 | 在什么条件下可用、有什么已知边界 | SSR／Portal／宿主／移动端限制；已证实键盘、焦点、role、对比度相关行为；实际测试与静态观察区分 |
+| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，明确证据版本；关键行为的定位尽量贴近对应章节 |
+
+章节可以有组件特定的小节，例如“选择后是否关闭”“清理时机”“嵌套分组”。固定公共章节不要求把每个组件的业务特点改成相同文案，也不改变事实的原有语义。
+
+### API 分组规范
+
+| 类别 | 默认列 | 适用条件 |
+| --- | --- | --- |
+| Props／属性 | 名称、类型、必填、默认或取值来源、语义／约束 | 公共输入属性；仅展示一次，不混入 export-entry 伪属性 |
+| 事件／回调 | 名称、参数、触发时机、与状态的关系 | callback 也是 prop 时用链接或合并行，避免两份定义漂移 |
+| 方法／静态 API | 名称、签名或参数、返回、生命周期／清理 | show/destroy 等公开方法；不能只打印 JSDoc 一段字符串 |
+| Ref／命令式句柄 | 获取方式、公开成员、何时可用、失效／清理 | 有 ref/handle 契约时，函数类型需保留有效签名 |
+| 子组件／slot／part | 身份、放置位置、组合限制、独立 API | 公开复合组件，不将仅内部渲染函数列为消费者可用 |
+| Hook | 调用前提、参数、返回、Provider／生命周期依赖 | 有明确公共契约时；独立用途较大可另用公共库参考 |
+| 关键配置类型 | 判别字段、各分支必需项、嵌套项、关联 API | 对象数组、union、group/item、受约束配置等对用法必要时 |
+
+**类型必须可理解。** 保留 union 成员、数组元素、泛型和函数参数。无法解析的类型给准确别名与权威定义入口，不能渲染成 `{}` 后当作完整契约。不递归展开整个 React、宿主上下文或基础库类型树。
+
+**默认值必须有来源。** 区分参数默认、运行时分支默认、继承环境与文档声明。同版本事实矛盾时说明冲突并回查，不能用大量 `unknown` 遮住已知默认；未声明的默认不能猜成 false／undefined。正文与 API 表不能给相互冲突的确定值。
+
+继承属性优先“来源链接＋本组件差异／覆盖”；仅在独立消费必须时展开必要字段。配置类型用于解释约束，不在表后再次粘贴完整原始声明。少量无法由表表达的签名可以保留，声明压缩后的正确性需要核验。
+
+### 不同组件能力的章节变体
+
+| 能力形态 | 必须额外表达的有效信息 |
+| --- | --- |
+| 展示型 | 内容与截断、尺寸／外观变体；不能强造状态管理章节 |
+| 可交互／表单型 | 受控关系、输入输出、禁用与只读、校验、触发时机；不要混淆视觉禁用和实际阻止事件 |
+| 浮层型 | trigger、Portal root、定位／碰撞、开合、dismiss、焦点、安全区与层级；已证实的环境差异 |
+| 数据／复合型 | item/group 判别结构、部件组合、全局与局部配置优先级、选择后的动作 |
+| 命令式型 | 初始化上下文、show/update/destroy 等实际公开方法、返回句柄、排队／替换、卸载与资源清理 |
+
+这些是同一标准模板的条件章节，不是新增 Provider。一个组件同时满足多个形态时组合使用，语义信息只写一次。
+
+### 示例标准
+
+默认一个可说明基本用法的维护示例，再按独立行为补必要案例；没有固定六个示例或每个 Prop 一个示例的要求。命令式与声明式都是公开用法时，分别保留入口。至少覆盖会改变消费方式的关键分支，而非只提供装饰性按钮 demo。
+
+示例需标明原始文件／故事／官网来源及适用版本。摘取时保留必需 import、状态回写、Provider 和样式前提；允许省略重复的演示布局，不能删掉决定行为的控制代码。引用已有例子不等于本轮实际运行通过。官方示例若与目标版本不匹配，先记录版本差异，不能直接覆盖代码契约。
+
+## 图示选择
+
+公开 parts 层级用 text 树；有证据的受控交互或命令式生命周期用 sequenceDiagram/状态图；外观用授权示例图。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/l03.md

@@ -0,0 +1,92 @@
+---
+id: context.article.l03
+kind: procedure
+media-type: text/markdown
+program:
+  article: l03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 目标与适用范围
+    packages: 平台软件包与版本
+    foundations: 基础规范地图
+    components: 组件与交互模式
+    configuration: 主题及运行配置
+    adoption: 采用定制与迁移
+    purpose: 用途与语义
+    catalog: 分类与 Token 目录
+    mapping: 命名及对应关系
+    consumption: 消费方式
+    rules: 组合与适用规则
+    environment: 环境与 Provider
+    globals: 全局配置
+    inheritance: 继承与局部覆盖
+    resources: CSS 与资源加载顺序
+    ssr: SSR 与 Hydration
+    platforms: 平台和主题差异
+    verification: 验证与排查入口
+    references: 来源与修改入口
+---
+
+# L03 设计系统及基础规范
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+### 来源和归属
+
+有维护的设计规范、token 源或稳定的跨组件约定时启用。规范文档由 Markdown、实现与 token 由 Code 提供，各自保留来源职责；混合知识通过现有授权主题和引用组合，不新增一个同时吞设计、代码和运行态的通用 Provider。
+
+只有 token 或静态资源材料时，采用“基础资源参考”对应变体，给定义、别名、消费和修改入口；没有规范证据不补设计目标，也不将其标题或内容包装成完整设计系统。仅文档规范则可以独立成文，不以存在组件源码为前置。
+
+不能只由组件源码推断设计意图，也不能将设计图中的名称直接当作当前程序 API。平台、设计规范版本、组件包版本、资源版本分开记录。同名组件在 Web、原生与其他跨端实现中的属性不应互相覆盖。
+
+### 系统入口文章
+
+```markdown
+# <设计系统>
+## 目标与适用范围
+## 平台、软件包与版本
+## 基础规范地图
+## 组件与交互模式
+## 主题及运行配置
+## 采用、定制与迁移
+## 权威资源与维护入口
+```
+
+| 章节 | 必要内容 |
+| --- | --- |
+| 目标与适用范围 | 来自规范的设计目标、覆盖产品／平台范围、与组件库的关系；不虚构品牌原则 |
+| 平台、软件包与版本 | 平台、实现包／入口、设计规范版本、维护状态、文档和源码；不同版本状态分别列 |
+| 基础规范地图 | 已有的颜色、字体／排版、间距、布局／断点、圆角、阴影／层级、动效、图标／插画等主题及入口 |
+| 组件与交互模式 | 组件分类、组合模式、相近能力的选择依据；实际组件 API 链接 L02 |
+| 主题及运行配置 | 默认主题、上下文、局部覆盖、暗色／高对比、方向和响应式的实现边界 |
+| 采用、定制与迁移 | 按平台的接入导航、允许的扩展方式、已有迁移指引和版本差异；不复制安装全篇 |
+| 权威资源与维护入口 | 规范、设计资源、token 定义／生成、实现和维护说明，区分已读取与仅有导航链接 |
+
+### 基础规范专题变体
+
+同一模板按主题拆分 **colors、typography、spacing-layout、elevation、motion、icons-assets** 等文章；只生成有材料和独立阅读价值的主题。
+
+建议章节为 **用途与语义 → 分类／token 目录 → 命名及对应关系 → 消费方式 → 组合与适用规则 → 平台／主题差异 → 来源与修改入口**。
+
+Token 表列：语义名、层级（基础／语义／组件）、定义或别名指向、平台／主题、消费标识、来源。别名引用不等于当前运行值；生成映射要保留权威源和产物关系。颜色十六进制、字号或时长不是唯一重点，必须让读者理解用途与替换边界。
+
+图标／插画专题需说明资源包、命名、取得和渲染方式、镜像／方向或平台差异、定制约束；不是将每张 SVG 都变成一篇组件 Props 页。存在静态资源指南时保留它的使用入口。
+
+### 主题与运行接入专题变体
+
+建议章节为 **环境与 Provider → 全局配置 → 继承与局部覆盖 → CSS／资源加载顺序 → SSR／Hydration → 多端、方向与高对比 → 验证与排查入口**。
+
+只对有证据的技术机制成文。某个组件默认跟随上下文，不能简化为全系统固定常量；只有 Web 样本不能推断原生平台一致。可访问性应区分规范要求、实现行为和验证记录，不能仅靠 token 名称推定合规。
+
+### 分篇与去重
+
+系统内容较少时，上述内容在一篇系统入口中组织；规范丰富时采用“系统入口＋基础主题＋运行接入＋迁移”的菜单。它们是 L03 下不同阅读主题／文章计划，不是每个组件再生成一套设计系统。
+
+L05 组件库 说明实现包如何接入；L02 组件 只写组件特有 token／覆盖差异；F08 应用样式 只写该应用的消费和局部定制。三处通过链接连接，公共规范保持单一权威承载。
+
+## 图示选择
+
+token 别名/主题继承用 flowchart，系统资源目录用 text 树；颜色/排版/动效引用有来源视觉材料，不用关系图冒充视觉规范。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/l04.md

@@ -0,0 +1,30 @@
+---
+id: context.article.l04
+kind: procedure
+media-type: text/markdown
+program:
+  article: l04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    boundary: 扩展边界
+    registration: 注册及执行顺序
+    context: 输入输出与上下文
+    collaboration: 宿主与下游协作
+    cleanup: 错误和清理
+    references: 使用与测试入口
+---
+
+# L04 中间件、适配与运行模式
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**扩展边界 → 注册及执行顺序 → 输入输出与上下文 → 与宿主／下游的协作 → 错误和清理 → 使用／测试入口**。
+
+只输出有维护意义的中间件、服务协作和代码约定，不把某个私有实现提升为团队规范。事件执行器沿用 S07，网关适配沿用现有 request-adaptation-guide。
+
+## 图示选择
+
+注册、调用和清理用 sequenceDiagram，宿主/扩展边界用 flowchart；不将声明顺序推断为运行顺序。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/l05.md

@@ -0,0 +1,50 @@
+---
+id: context.article.l05
+kind: procedure
+media-type: text/markdown
+program:
+  article: l05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    purpose: 定位与适用平台
+    packages: 软件包版本与维护状态
+    setup: 安装与全局接入
+    catalog: 组件分类与选择导航
+    configuration: 公共配置资源与设计系统
+    compatibility: 兼容迁移与限制
+    references: 示例文档与源码
+---
+
+# L05 组件库总览与接入
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+用于一个明确面向消费者的组件集合、公共业务组件包或多个相关实现包的入口。它与 L02 单组件文章分开，也不将站点自身的演示组件当成库的公共组件。
+
+默认章节：
+
+```markdown
+# <组件库>
+## 定位与适用平台
+## 软件包、版本与维护状态
+## 安装与全局接入
+## 组件分类与选择导航
+## 公共配置、资源与设计系统
+## 兼容、迁移与已知限制
+## 示例、文档与源码入口
+```
+
+包表列：包／子入口、用途、平台、适用版本、维护状态、文档与源码。主入口、deprecated 子入口、图标／颜色资源包分别说明，不能以相近名字混成一套版本。
+
+接入须根据维护资料给依赖前提、CSS／reset 顺序、Provider、环境配置和一个最小消费入口。局部组件页链接本篇并提示必要前提，不重复整份安装指南。配置包含全局与局部优先级时保留其证据。
+
+组件目录按用途／交互任务／正式分类组织，记录公共名称、家族、导入入口、摘要、详情或源码。单组件尚不足以独立成文也应在目录有入口。仅公共类型或 helper 可以在相应能力下承载，不独立制造空页。
+
+规模较小时总览与接入合一；多平台或接入复杂时分总览、quick-start、组件地图、迁移等文章。页面数由阅读边界决定。L05 可采用 C01 的索引结构，但同一库只有一个主入口，不能重复生成同义的 C01/L01/L05 三篇概览。
+
+## 图示选择
+
+包与能力目录用 text 树或表格；真实包依赖用 flowchart，链接组件详情和系统图。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/q03.md

@@ -0,0 +1,29 @@
+---
+id: context.article.q03
+kind: procedure
+media-type: text/markdown
+program:
+  article: q03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 范围与来源
+    catalog: 能力与场景表
+    prerequisites: 前置条件和数据
+    automation: 自动化入口
+    references: 需求与缺陷
+---
+
+# Q03 用例目录
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**范围与来源 → 按能力分组的场景表 → 前置条件和数据 → 自动化入口 → 相关需求／缺陷**。
+
+场景表列：场景、输入／动作、预期结果、来源类别、脚本／正式用例链接、关联代码。正式用例、源码测试、代码推导候选必须区分；没有运行记录不得写“通过”。目录定位完整不等于覆盖率达标。
+
+## 图示选择
+
+用例场景优先表格；分支组合复杂时用 flowchart，区分正式用例与推导候选。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/plugins/skills/context-code-indexer/templates/articles/q05.md

@@ -0,0 +1,29 @@
+---
+id: context.article.q05
+kind: procedure
+media-type: text/markdown
+program:
+  article: q05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    requirements: 数据需求
+    preparation: 准备入口
+    isolation: 环境和隔离
+    lifecycle: 数据生命周期
+    verification: 验证和清理
+---
+
+# Q05 测试数据与环境
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**数据需求 → 准备入口 → 环境和隔离条件 → 数据生命周期 → 验证和清理**。
+
+保留脚本、配置、测试数据模板及适用前提。静态 fixture、造数程序和真实账号是不同材料；只说明取得数据的方法，不复制实际凭证。某脚本存在不代表当前账号有权限运行。
+
+## 图示选择
+
+数据准备/使用/清理用 flowchart；环境依赖有来源才画，不包含真实凭证。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。