My Code Io

基于给定代码入口，分析并撰写多章节技术介绍文章。支持两个参数：`（必选，文件路径、文件夹路径或功能描述）和 `（可选，输出文件路径或目录，缺省时用默认路径）。

执行步骤

1. 解析入口：

• 若 `` 是存在的文件或文件夹路径 → 直接作为入口。
• 若 ` 是描述（非路径）→ 搜索匹配的代码位置；命中多个或不确定时，用 AskUserQuestion`（单选）列出候选让用户选定，选项为各候选的路径 + 一句话说明。
• 若 ` 为空 → 从对话上下文推断入口，用 AskUserQuestion`（单选）确认，选项含推断的入口与"换一个（在 Other 填写）"。

1. 分析代码：Read references/analysis-framework.md，根据入口类型和对话上下文确定分析模式（静态分析/模块深挖/过程复盘/外部信息），再按模式对应的维度收集信息。
2. 规划大纲与写入位置（a→b→c 顺序执行，c 与 d 之间可循环多次，直至用户认可）：

• a. 初版大纲：Read references/writing-guide.md 获取大纲规划、语言风格、代码引用规范，据分析结果设计初版章节结构。
• b. 推导保存位置候选（原步骤 6 的路径逻辑前移至此）：备好各档写入位置候选，供 c 排成选项——
• **` 位置**（仅当提供参数 ）：以 / 结尾或为已存在目录 → 目录，文件名用文章标题（中文）+ .md；否则视为完整文件路径（无后缀补 .md`）。
• 默认规则位置：~/Documents/claude//.md（`` 为当前目录名）。
• 自己填：由用户填目录或提示词。
• c. 确认：用 AskUserQuestion 确认——
• 大纲：选项如"按此大纲撰写"、"调整章节（在 Other 描述改动）"。
• 写入位置：按 b 的候选依次排为选项——有 ` 时 3 个（ 位置 → 默认规则位置 → 自己填目录或提示词，末项走 Other），无 ` 时 2 个（默认规则位置 → 自己填）。
• 预计超 300 行时，一并按 writing-guide 确认合并一篇 / 拆分多篇。

（循环回来时，只就 d 指出的待确认项发问。）

• d. 按反馈处理（有调整则处理后回 c；大纲与位置均定案则进入步骤 4）：
• 要求改大纲 → 调整章节结构，回 c。
• 位置选"自己填"且内容是提示词（非明确目录/路径）→ 据提示词推断具体位置，回 c 就该推断位置确认一次。
• 位置为明确项（``、默认规则、或自己填的明确目录/路径）→ 位置定案，不再就位置发问。

1. 撰写文章：按 writing-guide 中的语言风格和引用规范撰写正文。
2. 插入图表：每处需要可视化的内容先做初级分流——

• tree 类（目录树、层级结构）、极简无分支线性流程等简单内容 → Read references/ascii-diagram.md，按其规范绘制（含汉字宽度规则与转 my-mermaid 的二次分流出口）；
• 其余一律用 Skill 工具调用 my-mermaid（传入该图要表达的内容描述），拿回带配色代码直接嵌入——不得自行手写 mermaid 代码，也不自行选图类型（自绘会丢失配色与分组，图类型由 my-mermaid 决定）。

1. 保存文章：写入步骤 3 确认的位置（父目录不存在则创建）。仅将文章目录结构（各级标题）打印到对话，不打印完整正文。
2. 多篇拆分（仅步骤 3 中用户选择拆分时）：每篇独立命名到同一目录，各自用 AskUserQuestion 确认大纲后撰写保存。若 `` 指向单一文件，则改用其所在目录容纳多篇。

格式与约束

• 文章标题用 #（一级），章节用 ## 至 #####。
• 代码块标注语言（``` `python ``` 等），代码注释保持原样不翻译。
• 术语首次出现可用 （英文原文） 标注，后续直接用中文或英文。
• emoji 仅在绘图、表格或语义贴合的正文处使用，标题中慎用。数学公式：行内 $...$，独立 $$...$$。
• 禁止输出 ★ Insight、─── 等 CLI 高亮装饰块。这些是 Claude Code 终端内的 UI 元素，不应出现在文章中。
• 执行全程不得修改当前工作目录（递归）下的任何文件，也不得在工作目录下写入新文件。文章仅输出到对话和指定保存路径。不生成额外的 README 或说明文件。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yanqd0
• Source: yanqd0/my-claude
• License: MIT

Install and usage instructions live in the source repository linked above.