@double-codeing/flow2spec 2.2.0

package/templates/template//347/273/210/347/250/277/346/250/241/347/211/210.md

@@ -0,0 +1,93 @@
+> **「配置根」**：当前 agent 对应的 AI 工具配置目录（`flow2spec init` 写入，常见 **`.cursor/`**、**`.claude/`**、**`.codex/`**）。下文 **`配置根/...`** 指该目录下的相对路径。
+
+# 终稿概述模版
+
+> 本模板用于将「架构说明」「功能/技术方案」等文档整理为**终稿**形态，便于 **f2s-ctx-build** 技能生成 Rules、Skills 与文档索引。  
+> 适用：后端服务、前端/客户端、全栈、产品与设计说明等，按需保留或省略章节。  
+> **在 Flow2Spec 中**：本模版位于 **templates/template/**（与 docs 同级），init 时会将整目录复制到项目的 **`配置根/template/`**，本文件即 `配置根/template/终稿模版.md`。  
+> **执行 f2s-doc-final 技能时**：本模版仅作为**结构参考与写作提示**，不强制套用；转换以原文内容与逻辑为主，按需采纳章节建议。
+
+---
+
+## 核心概念
+
+| 概念 | 说明 |
+|------|------|
+| （名词一） | 定义与用途。 |
+| （名词二） | 定义与用途。 |
+
+用表格列出**术语、实体、关键 ID**，便于 AI 提炼到 Rules/Skills。若为架构说明，可包含目录约定、模块划分、公共能力入口等；若为功能方案，可包含领域实体、配置 key、接口/页面名称等。
+
+---
+
+## 状态与流转
+
+（若有状态、阶段或生命周期则填写；若无可简述或省略。）
+
+- **状态 A**：含义；何时转为状态 B/C。
+- **状态 B**：含义；后续流转。
+
+若无复杂状态，可写「主流程上的阶段」或「本说明无状态机，见关键流程」。
+
+---
+
+## 业务规则
+
+- 规则一：约束、限购、时效、权限等。
+- 规则二：校验维度、失败条件、边界情况。
+- 规则三：与配置/开关/环境的对应关系。
+
+写清**约束、校验、配置项**，便于生成 Rules 的「规则要点」。前后端、配置、数据一致性、错误处理等均可在此列出。
+
+---
+
+## 关键流程
+
+1. **流程一**：步骤简述；入口（接口/API/页面/事件）；结果。
+2. **流程二**：步骤简述；入口；结果。
+3. **流程三**：步骤简述；入口；结果。
+
+按「用户侧或系统侧」的主流程写，便于 AI 提炼到 Skills 的「关键流程」。可包含：接口调用顺序、页面跳转、事件触发、后台任务等。
+
+---
+
+## 接口 / API / 页面（可选）
+
+（按文档类型择一或多选：后端写接口，前端写页面/组件与数据流，全栈可都写。）
+
+### 接口 / API 名称或路径
+
+- **请求**：入参说明（体/查询/头）。
+- **返回**：出参说明；错误码或异常情况。
+- **内部调用**：项目内方法、服务或模块（若有）。
+
+### 页面 / 组件 / 路由（若有）
+
+- **入口**：路由、入口组件或事件。
+- **依赖数据**：接口、Store、本地状态。
+- **产出**：页面/组件职责与关键交互。
+
+---
+
+## 配置 / 数据 / 错误（可选）
+
+（按需选写，不必全部出现。）
+
+- **配置**：配置项、key、必传/可选、含义；配置中心或环境变量约定。
+- **数据**：核心数据模型、表结构、字段说明；或前端 Store/状态结构；与业务的对应关系。
+- **错误码或异常**：code、场景、说明；或前端错误态、兜底逻辑。
+
+---
+
+## 实现位置与对接方式
+
+- **实现位置**：代码/服务/仓库路径（如 `src/xxx/yyy`、服务名、仓库名），说明封装或实现所在位置。
+- **对接方式**：新功能/新业务如何接入：需做哪些配置、建表、注册路由、引用组件等；无需改封装时的最小接入步骤。
+
+---
+
+### 使用说明
+
+- 将上述括号内的占位替换为实际内容；与文档类型无关的章节可整节删除或标「（不适用）」。
+- 至少保留 **核心概念、业务规则、关键流程** 三个二级标题，其余按需增删。
+- 保存为 `配置根/stock-docs/<方案名>_终稿.md` 后，按 **f2s-ctx-build** 技能、以该路径为入参即可生成 Rules、Skills、文档索引。