https://github.com/Johnbug/add-cihua-code-comments-skill
给关键代码配上古小说词话本风格的韵文注释——「有诗为证」,句句押韵,风格可选。
词话本小说(《金瓶梅词话》《水浒传》《红楼梦》……)每到关键时刻,便有「有诗为证」的韵文插话。把这个传统搬进代码注释:
// 正是:
// 禅杖打开危险路,戒刀杀尽不平人
// 一退一进三回合,方教妖雾散无痕
async function callWithRetry
for (let i = 0; i < maxTries; i++) {
try {
return await fn();
} catch (err) {
if (i === maxTries - 1) throw err; // 最后一回合,怒斩妖雾
await sleep(2 ** i * 100); // 且退一步,蓄势再来
}
}
}
代码干净如初,故事全在注释里。默认含蓄隐晦——风月味走双关借喻,露骨程度是使用者可调的旋钮。

BeadMaster - 拼豆大王
活跃UV +243