| name | technical-app-note-generator |
| description | Convert technical discussions into structured, atomic Application Notes. Generates independent txt files optimized for technical documentation. Language adapts to user preference (Chinese or English). |
Technical Application Note Generator
将技术讨论内容转化为结构化、原子化的应用笔记（Application Notes），每篇笔记生成独立的TXT纯文本文件。语言根据用户偏好自动适配。
何时使用
- 整理嵌入式系统、RTOS、电源管理等技术讨论内容
- 需要生成专业、简洁的技术文档片段
- 要求输出为纯文本格式，便于版本控制
- 需要每篇笔记聚焦单一技术概念
使用方法
输入参数
- topic: 技术主题或核心概念（如"FreeRTOS电源管理"）
- key_points: 需要展开的技术要点列表，每个要点对应一个独立TXT文件
- max_words_per_note: 单篇笔记正文字数上限（默认300字）
- output_directory: TXT文件输出目录路径（默认"./notes"）
工作流程
- 分析输入要点: 解析key_points，确保每个要点具备独立成篇的技术深度
- 生成元数据: 为每个要点创建技术标题（5-15个字符或术语），并生成对应的txt文件名。标题语言与用户输入语言保持一致
- 检查现有笔记: 扫描output_directory目录，查找相似或相关的现有笔记
- 比较标题关键词和技术概念重叠度
- 若发现相似度>70%的现有笔记，向用户报告并询问：
- 是否合并到现有笔记
- 还是另起新文件名（用户提供新标题）
- 还是取消生成
- 显示现有笔记的标题、文件路径和内容摘要供用户参考
- 禁止自动添加版本号（如_v2、_v3），必须由用户决定最终文件名
- 撰写正文: 撰写250-300字的技术正文
- 质量校验: 检查字数、扫描表情符号、验证原子性
- 文件生成: 根据用户选择执行操作（合并、新建或取消）
内容结构
- 首句: 定义概念或阐明原理
- 中段: 技术细节、实现机制或关键参数
- 末段: 设计影响、约束条件或最佳实践
文件名格式（SEO优化）
{seo_title}.txt
文件名生成规则：
- 语言适配：根据用户使用语言决定（中文用户使用中文术语，英文用户使用英文术语）
- 格式：主题关键词 + 核心概念 + 技术要点
- 长度：15-30个字符（不含扩展名）
- 使用下划线连接各部分
- 包含关键搜索词，便于AI智能体检索
文件名示例（中文）：
FreeRTOS电源管理_电源管理器任务优先级设置.txtSTM32时钟系统_PLL锁相环配置详解.txt嵌入式低功耗设计_引用计数实现机制.txt
文件名示例（English）：
FreeRTOS_Power_Manager_Task_Priority_Configuration.txtSTM32_Clock_System_PLL_Configuration_Guide.txtEmbedded_Low_Power_Reference_Counting_Mechanism.txt
冲突处理：若文件名重复或检测到相似笔记，必须由用户决定：合并到现有文件、另起新文件名，或取消生成。禁止自动添加版本号后缀
输出格式
纯文本格式，仅包含标题和正文：
[标题]
[正文内容，250-300字]
约束规则
- 原子性: 每篇笔记严格遵循"一事一议"
- 字数: 正文控制在250-300字之间
- 结构: 仅两级结构（标题+正文），禁止三级标题或列表嵌套
- 纯净文本: 严禁使用表情符号、ASCII艺术、富文本标记
- 技术语调: 专业、客观，避免口语化，禁止人称代词
- 文件隔离: 每个要点生成独立的.txt文件
参考
- 详细规则和示例:
references/detailed-rules.md
- 输出示例:
references/examples.md
