@c4a/context-cli 0.7.5 → 0.7.9

package/plugins/skills/context-code-indexer/templates/api-service-public-api-reference.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "api-service-public-api-reference",
+  "profile": "api-service",
+  "reader_goal": "look-up-public-contract",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "look-up-public-contract",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain the declared operation or type, invocation prerequisites, input and output semantics, and a supported example. Share this contract reference with related task pages.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

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

@@ -0,0 +1,49 @@
+---
+id: context.article.c01
+kind: procedure
+media-type: text/markdown
+program:
+  article: c01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 定位与边界
+    capabilities: 核心能力
+    dependencies: 技术与依赖摘要
+    index: 知识索引
+    tasks: 任务导航
+    sources: 来源与适用版本
+---
+
+# C01 模块／知识入口
+
+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.
+
+适用：应用、服务、组件库、业务域或产品资料的主入口；具体对象的专业章节由对应模板补充。产出为普通知识文章，文件不必叫 SKILL.md。
+
+建议章节：
+
+1. **定位与边界**：解决什么任务、覆盖哪个产品／资料范围或仓库／模块、适用条件。
+2. **核心能力**：按业务任务归组，链接到已存在的文章或具体代码入口。
+3. **技术与依赖摘要**：仅在有技术材料且影响读者选择入口时出现；纯产品资料不强制此节。
+4. **知识索引**：主题、何时阅读、目标文章／代码位置。
+5. **任务导航**：开发、接口对接、排障、交付分别从哪里继续。
+6. **来源与适用版本**：文档身份／定位与适用版本；代码材料记录仓库、模块路径和证据版本。
+
+最低产出：对象身份、可信资料／起始文件／注册点和下一步阅读位置。浅索引模块可作为父级表格中的记录，不强制单页。禁止链接到尚未产出的模板占位文件。
+
+## 图示选择
+
+目录用 text 树；仅有已证实跨模块关系时在概览补 flowchart LR。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。
+
+## 导航内容的主责与合并
+
+主入口负责“哪个问题去哪里”，不重复专业文章的全文。小模块可将 C01、F01 与 C07
+合并为一篇；分开时，架构页解释运行边界，源码指引只补调查顺序，不重复同一份文件表。
+没有深度文章的模块仍可在父级地图中给源码入口，不创建空链接。
+
+导航表优先使用：**读者问题／任务 → 对应模块与职责 → 第一篇文章或源码入口 → 何时继续深入**。
+核心能力必须说出材料已证明的具体行为，不能只写“详细内容见源码”。目录记录的数量、
+实际阅读的数量与深入解释的数量分别说明；不把目录列全当成已读全。

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

@@ -0,0 +1,36 @@
+---
+id: context.article.c02
+kind: procedure
+media-type: text/markdown
+program:
+  article: c02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    goals: 业务目标
+    actors: 角色与场景
+    prerequisites: 使用前提
+    operations: 操作与结果
+    exceptions: 规则与异常
+    acceptance: 验收依据
+    version: 版本和范围
+    capabilities: 能力边界
+    flows: 主要流程入口
+    references: 相关系统与文档
+---
+
+# C02 业务概览
+
+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.
+
+适用：有业务说明、真实页面或用例能够支持业务定位时。建议章节为 **业务目标 → 角色与场景 → 能力边界 → 主要流程入口 → 相关系统与文档**。每个场景至少给角色、触发动作和代码／资料定位；业务指标与历史原因只在权威资料支持时增加。
+
+与 C01 区别：C01 帮读者找资料，C02 解释业务。内容过少时合并到 C01；不根据目录名虚构经营目标或业务指标。
+
+**纯产品与功能说明变体**：只有产品文档时也可独立采用。产品总览使用 **目标与适用对象 → 场景与角色 → 功能地图 → 使用与规则入口 → 版本和范围**；功能详情使用 **用户任务 → 前置条件 → 操作与结果 → 规则和异常 → 验收依据 → 相关资料**。需求中的预期、已发布行为和用户观察分别标明，不把需求文档直接当作线上已实现。详细操作可由已有用户指南承载，验收资料关联 Q03/Q04；不强制出现源码、API 或部署章节。
+
+## 图示选择
+
+在业务流程或操作章节用 flowchart TD；产品方案与已发布行为分别标注。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,28 @@
+---
+id: context.article.c03
+kind: procedure
+media-type: text/markdown
+program:
+  article: c03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 适用范围
+    terms: 术语表
+    distinctions: 易混概念
+    references: 相关入口
+---
+
+# C03 术语与标识
+
+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、领域类型之间存在定位需求。建议章节为 **适用范围 → 术语表 → 易混概念 → 相关入口**。
+
+表格列：读者用语、代码／协议标识、含义、适用范围、来源与相关页。同义词必须来自材料或真实问题；不把同名字段视为同一业务概念。短表并入模块概览，跨模块通用词仅维护一份。
+
+## 图示选择
+
+术语优先表格；有明确概念关系才补带关系标签的 flowchart，不凭同名连线。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,29 @@
+---
+id: context.article.c04
+kind: procedure
+media-type: text/markdown
+program:
+  article: c04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    layers: 依赖分层
+    catalog: 核心依赖表
+    initialization: 初始化与注入
+    compatibility: 兼容和版本约束
+    boundaries: 跨边界定位
+---
+
+# C04 依赖与协作边界
+
+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 LR，分别标注导入、调用、注入，不混同运行关系。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,30 @@
+---
+id: context.article.c05
+kind: procedure
+media-type: text/markdown
+program:
+  article: c05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    symptoms: 现象索引
+    conditions: 适用条件
+    findings: 已知事实与判断
+    diagnosis: 排查步骤
+    recovery: 修复与验证
+    sources: 来源
+---
+
+# C05 已知问题与排障
+
+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.
+
+适用：存在已核实缺陷、受限能力、历史事件或具体可复现现象。建议章节为 **现象索引 → 适用条件 → 已知事实与判断 → 排查步骤 → 修复／绕行及验证 → 来源**。
+
+记录列：现象、版本／环境、定位点、结论状态、下一步。TODO/FIXME 只能作为维护线索，不自动认定线上故障；已修问题标明适用历史版本。没有可信条目时不生成空的 known-issues 页。
+
+## 图示选择
+
+诊断步骤可用 flowchart TD，保留失败出口与下一步；不要画未经证实的根因链。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,51 @@
+---
+id: context.article.c07
+kind: procedure
+media-type: text/markdown
+program:
+  article: c07
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    entries: 问题到入口
+    identity: 源码身份与版本
+    reading: 推荐阅读顺序
+    boundaries: 外部边界
+    evidence: 进一步证据
+---
+
+# C07 从知识继续查源码
+
+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.
+
+适用：入口优先的业务知识包，尤其是只持有 dist 的消费 Agent。建议章节为 **问题到入口的映射 → 源码身份与版本 → 推荐阅读顺序 → 外部边界 → 何时需要进一步证据**。
+
+定位记录：仓库身份、仓内路径／符号、证据版本、已证明到哪一层、接着读什么。在包内返回可执行的阅读指引；工作区 inspect 与包外源码归因遵循各自现有能力和授权，不声称普通 dist query 会自动 clone。无需在每篇文章重复整套工作流，只保留本篇起点和相关指引链接。
+
+## 图示选择
+
+源码坐标优先表格，阅读顺序可用 text 树；跨边界路径有证据再画 flowchart，并写下一步。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。
+
+## 从现象进入代码，而不是罗列源码
+
+优先给 **问题／现象 → 第一入口 → 下一份证据 → 分支条件**。例如：
+
+| 现象 | 第一入口 | 下一步证据与分支 |
+| --- | --- | --- |
+| 页面不可见 | 已确认的路由／菜单注册位置 | 检查访问控制与功能配置；先确认页面是否被挂载 |
+| 提交无结果 | 页面事件处理与请求调用点 | 请求未发出则查前端条件；已发出再核对响应和服务端入口 |
+| 生成类型不一致 | 实际生成配置和消费位置 | 比对输入版本与生成差异；不能用声明证明页面实际调用 |
+
+表中的具体文件应来自本篇证据，示例不替代取证。已证实调用链要求逐跳证据；调查路线
+允许某一跳未知，但必须标明“待查”以及如何定位，不能画成已经发生的调用。
+跨模块 composer 因证据不足不产出完整链路时，本篇仍保留已知入口和明确的证据缺口。
+
+给出仓库、版本和精确搜索范围。确有相应工具时可提供命令，例如
+`rg -n --fixed-strings 'SubmitOrder' apps/orders/src`，说明如何根据命中进入实现／调用方，
+以及无命中时该查别名、生成客户端还是外部依赖。使用真实符号替换例子，避免无范围全仓搜索。
+
+包内文章用可解析链接，交付后检查实际目标；源码位置使用 repo@revision:path#symbol，
+不要把工作区 knowledge 路径或反引号文本当成 dist 中可跳转的链接。文件名改变后的导航
+遵循现有打包映射，不手改 dist 或虚构尚未交付的文章。

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

@@ -0,0 +1,31 @@
+---
+id: context.article.d01
+kind: procedure
+media-type: text/markdown
+program:
+  article: d01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 领域职责
+    services: 服务分工
+    entries: 入口与调用边界
+    collaboration: 数据与事件协作
+    references: 阅读导航
+---
+
+# D01 领域架构与服务地图
+
+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 LR，分组只表示归属，调用必须另有带标签的边及来源。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,32 @@
+---
+id: context.article.d02
+kind: procedure
+media-type: text/markdown
+program:
+  article: d02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    trigger: 场景与触发
+    actors: 参与方
+    flow: 主流程
+    branches: 分支与状态
+    failures: 失败和下一步
+    sources: 源码链路与证据边界
+---
+
+# D02 业务流程与跨层链路
+
+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.
+
+生成条件：有具体业务动作且相关来源已登记。适用于后端跨服务流程，也可跨前后端组织。
+
+建议章节：**场景与触发 → 参与方 → 主流程 → 关键分支与状态 → 失败和下一步 → 源码链路与证据边界**。
+
+步骤表列：动作、实现位置、输入／输出、下游、终止或继续条件。sequence／flow 图只绘制已证明的边；对授权范围外的服务终止在具名边界并提供入口。入口优先版本可仅写已有首跳，深度闭环作为后续增强。
+
+## 图示选择
+
+业务主流程用 flowchart TD，跨层交互用 sequenceDiagram；两图承担不同问题，避免重复。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,32 @@
+---
+id: context.article.d03
+kind: procedure
+media-type: text/markdown
+program:
+  article: d03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 业务与版本
+    catalog: 规则分类
+    conditions: 条件与结果
+    implementation: 执行位置
+    conflicts: 例外与冲突
+    references: 相关流程
+---
+
+# D03 业务规则
+
+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 TD；精确规则与例外保留表格，未知分支明确说明。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,38 @@
+---
+id: context.article.d04
+kind: procedure
+media-type: text/markdown
+program:
+  article: d04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    scope: 工程边界
+    commands: 构建与测试入口
+    delivery: 环境与交付
+    conventions: 兼容与研发约定
+    environment: 运行与环境
+    configuration: 配置定位
+    observability: 日志指标与追踪
+    diagnosis: 诊断路径
+    recovery: 恢复与回滚
+    verification: 验证依据
+---
+
+# D04 运维与排障入口
+
+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.
+
+生成条件：有维护脚本、配置、指标注册或已保存的 SOP／事件记录。
+
+建议章节：**运行与环境 → 配置定位 → 日志／指标／追踪 → 常见现象与诊断路径 → 恢复／回滚 → 验证依据**。
+
+表格列：问题／配置类别、代码使用点、查询入口、适用环境、下一步。平台标识不等于当前配置值，存在监控调用不等于告警已配置。读取脚本可以产生文档，不代表获得执行线上操作的授权。
+
+**工程基础设施／研发规范变体**：承接技术基础设施、研发规范和后端构建部署资料。章节为 **工程边界 → 构建与测试入口 → 环境和交付 → 兼容与研发约定 → 排障定位**。有独立维护资料且内容足够时单独成篇；否则并入服务运行说明。操作事实、团队规范和 Agent 建议分清来源，不遗漏后端工程知识，也不复制前端命令。
+
+## 图示选择
+
+工程交付或故障诊断用 flowchart TD；部署依赖图仅在有实际配置依据时采用。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,50 @@
+---
+id: context.article.f01
+kind: procedure
+media-type: text/markdown
+program:
+  article: f01
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    architecture: 架构总览
+    stack: 技术栈与运行方式
+    startup: 启动与分层
+    crosscutting: 关键横切能力
+    deployment: 部署边界
+    references: 相关入口
+---
+
+# F01 架构
+
+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 LR，按启动、宿主和请求层分组，每条边有来源。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。
+
+## 多模块工程地图写法
+
+以已确认的模块为行，给出 **仓内路径 → 职责 → 首要注册／启动入口 → 深入位置**。
+一级工程先区分宿主、应用、共享库和工具，再按需要展开业务子模块；不把每个子目录
+自动认作一个应用。相同框架的模块合并说明，只展开有实际差异的运行边界。
+
+匿名示例（路径只示范组织方式，不是默认框架约定，产出时替换为实际证据）：
+
+| 模块 | 职责 | 首要入口 | 下一步 |
+| --- | --- | --- | --- |
+| apps/portal | 装载页面与公共导航 | src/bootstrap.ts | 路由注册、访问控制和模块装载位置 |
+| apps/portal/modules/orders | 订单查询与详情 | src/routes.ts | 对应页面的数据请求与状态分支 |
+| packages/widgets | 跨页面组件 | src/index.ts | 组件消费说明与实际调用方 |
+
+将路由、权限、请求、状态、宿主桥接等横切入口集中说明，业务模块页回链并写自身差异。
+结构图用于解释关系，定位表用于找文件，两者无需互相复述。目录中无法证实的职责标为待查，
+不按目录名编造业务能力。大范围材料只提供地图时，说明样本与未读范围。

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

@@ -0,0 +1,33 @@
+---
+id: context.article.f02
+kind: procedure
+media-type: text/markdown
+program:
+  article: f02
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    organization: 路由组织
+    routes: 页面登记表
+    access: 参数与访问控制
+    layout: 布局和全局兜底
+    references: 页面详情导航
+---
+
+# F02 路由与页面地图
+
+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.
+
+生成条件：已定位显式路由表、文件路由规则或页面注册机制。
+
+建议章节：**路由组织 → 页面登记表 → 参数与访问控制 → 布局和全局兜底 → 页面详情导航**。
+
+登记表列：业务页面名、完整／相对路由及 base、入口文件、layout／guard、主要数据边界、详情或源码链接。声明 route、导航可达与运行权限分别说明；没有本地 guard 不能推出没有权限控制。生成路由必须指出规则来源和消费点。
+
+最小入口不要求解释所有按钮；至少让 Agent 从页面找到入口及父层条件。目录名本身不能充当页面登记证据。
+
+## 图示选择
+
+路由优先表格，layout/guard 层级可用 text 树或 flowchart；注册不代表运行可达。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,38 @@
+---
+id: context.article.f03
+kind: procedure
+media-type: text/markdown
+program:
+  article: f03
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    identity: 页面定位
+    access: 路由参数与权限
+    components: 主要组件与依赖
+    flow: 页面内流程
+    state: 状态与数据流
+    api: API 边界
+    rules: 业务条件
+    feedback: Loading Empty Error
+    references: 知识与源码
+  contract_table: contract_api
+---
+
+# F03 页面／用户任务详情
+
+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 边界 → 业务条件 → Loading／Empty／Error → 相关知识与源码**。
+
+按证据增加埋点／监控。每个主要动作记录触发位置、调用入口、结果处理；已读取的禁用／隐藏条件说明对应来源，未读深层逻辑则给出具体继续位置。组件树只保留解释任务需要的节点。
+
+最低产出为“入口、父层访问控制、主要交互处理位置、下一步”，不要求预先证明整条业务闭环。API 参数表使用规范契约产物，页面只解释绑定和使用差异。
+
+## 图示选择
+
+页面行为用 flowchart TD；跨组件请求时序有证据再用 sequenceDiagram，保留父层条件和失败出口。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,32 @@
+---
+id: context.article.f04
+kind: procedure
+media-type: text/markdown
+program:
+  article: f04
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    ownership: 状态归属
+    initialization: 初始化与读取
+    writes: 写入与派生
+    async: 异步与缓存
+    lifecycle: 清理与生命周期
+    references: 定位与排障
+---
+
+# F04 状态与数据流
+
+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.
+
+生成条件：跨页面／组件状态、缓存或宿主上下文影响行为。
+
+建议章节：**状态分层 → 核心状态表 → 读写与派生关系 → 请求缓存及刷新 → 持久化与恢复 → 排查入口**。
+
+状态表列：状态身份、来源／owner、作用范围、初始化、主要写入者、使用者、清理／刷新入口。区分本地状态、URL、服务端缓存和宿主注入；不强行要求 Redux、Jotai 或任何特定框架。仅当可证明状态与转移时绘制状态图。
+
+## 图示选择
+
+数据流用带读写标签的 flowchart；stateDiagram-v2 仅用于有触发条件和转移证据的状态。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

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

@@ -0,0 +1,32 @@
+---
+id: context.article.f05
+kind: procedure
+media-type: text/markdown
+program:
+  article: f05
+  policies:
+    - compact
+    - standard
+    - expanded
+  sections:
+    clients: 请求层与客户端
+    catalog: 接口与调用入口
+    mapping: 输入输出与转换
+    errors: 错误与重试
+    boundaries: 契约与外部边界
+    references: 源码入口
+---
+
+# F05 API 集成
+
+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.
+
+生成条件：已定位请求封装、契约定义或实际调用位置中的至少一类。只有定义时可提供契约／检索入口，但不得把它描述为已确认的页面调用；调用目录只列已证实关系。
+
+建议章节：**请求架构 → 按能力分组的调用目录 → 参数与上下文注入 → 响应、错误和重试 → 契约来源与生成方式 → 服务端阅读入口**。
+
+目录列：页面／能力、调用符号、method/path 或 RPC identity、调用位置、契约来源、已知后端入口。客户端定义与实际调用分列，远程 SDK 内部未知调用不得列为已证实接口。跨仓链只延伸到已登记且有证据的边界。
+
+## 图示选择
+
+请求章节按已证实调用用 sequenceDiagram；参数和 API 坐标保留表格，契约定义不等于调用发生。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。