code-haikulisted

# code-haiku — 代码俳句生成器 读懂一段代码的「意图」,把它的神韵凝成一首俳句或打油诗——有意境、有幽默、可分享。 不是注释,不是文档,是诗。 ## 何时触发 用户说： - `/code-haiku` - "给这段代码写首诗" - "把这个函数写成俳句" - "这个 diff 怎么用诗表达" - "帮我写个 code haiku" - "这段代码有点意境,帮我写首诗" - "这个 PR 能用俳句总结吗" ## 工作流 ### 第一步：读懂代码的「意图」 **不逐行翻译**,而是问自己： - 这段代码在宏观上做什么?（排序?重试?缓存?认证?） - 它的处境是什么?（防御性代码?临时方案?核心逻辑?被人遗忘的 TODO?） - 它有没有让人会心一笑的特质?（递归的无限感、try/catch 的渡劫感、事件循环的虚无感） > 如果代码太长,只抓最有「诗感」的那一层意图。 ### 第二步：产出诗作 **标准输出格式：** ``` 【俳句】 <第一行，意象> <第二行，转折或深化> <第三行，落脚或余韵> 【英文 haiku】（可选，若能贴切翻译则附上） <line 1> <line 2> <line 3> 【诗解】 <一句话：这首诗对应代码的什么——哪个意象映射哪段逻辑> ``` **音节指引（中文俳句）：** - 三行，尽量贴近 5-7-5 音节，但意境优先于死抠音节。 - 用汉字时以「音节/字」计，不强制字数完全相同。 **英文 haiku（可选）：** - 只在翻译能增色时附上；若翻译失味，直接省略。 - 同样是三行，5-7-5 音节尽量贴近。 ### 第三步：变体（应要求） 若用户说「再来一个」或「换个风格」，可提供： - **写实风**：还原代码的实际处境（比如"凌晨上线、祈祷别崩"） - **禅意风**：用自然意象映射逻辑结构（递归→镜中镜、回调→深渊） - **自嘲风**：吐槽代码的技术债或命名混乱 - **史诗风**：把一行工具函数写出宇宙征程的气势 --- ## 示例库 ### 示例 A：递归函数 ```python def factorial(n): if n == 0: return 1 return n * factorial(n - 1) ``` **【俳句】** 自己召唤己 层层深入无尽处 零时方归来 **【英文 haiku】** calls itself again falling through the looking glass zero ends the dream **【诗解】** "自己召唤己"映射递归调用自身；"零时方归来"是 `n == 0` 的基础条件终止递归。 --- ### 示例 B：try/catch 吞掉所有异常 ```javascript try { await doSomethingRisky() } catch (e) { // TODO: handle this properly } ``` **【俳句】** 渡劫入火坑 TODO 轻描淡写 下次再说吧 **【英文 haiku】** fire swallowed whole "TODO: handle properly" next sprint, probably **【诗解】** "渡劫"是 try/catch 的意象；"TODO 轻描淡写"直指那行注释；"下次再说吧"是每个工程师都懂的技术债自嘲。 --- ### 示