napkin

为每个代码仓库维护一份持续优化的运行手册,而非临时日志

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:napkin。
它的用途是:为每个代码仓库维护一份持续优化的运行手册,而非临时日志
完整的 Skill 内容见:https://321skill.com/skills/napkin/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我修复这个仓库的登录模块bug。” AI会先静默读取该仓库下的 `.claude/napkin.md` 文件,如果里面有记录如“**[2024-10-01] 本地测试需使用特定环境变量** Do instead: 运行 `export API_ENV=staging && make test-auth`”,AI就会自动应用这个指导,避免你再次踩坑。在整个调试过程中,如果发现新的可复用经验,AI会将其格式化后更新到 Napkin 文件中。

介绍

Napkin Skill 旨在解决开发者在不同会话间重复遇到相同问题、遗忘项目特定工作流或最佳实践的问题。它不是一个按时间顺序记录的日志,而是一份需要持续提炼、按优先级排序的“餐巾纸”运行手册,确保高价值、可复用的知识被沉淀下来。

使用方式非常简单:该技能在每次与AI的会话中都会自动激活。会话开始时,AI会先读取项目根目录下 .claude/napkin.md 文件,并立即根据规则对其进行整理(如去重、按重要性排序)。在工作过程中,每当AI学到可复用的经验(如常见陷阱、用户指令、有效技巧),就会以特定格式更新到这个文件中。

它非常适合长期维护特定项目的开发者、DevOps工程师或技术负责人。无论是处理复杂的遗留系统,还是需要遵循严格部署流程的项目,Napkin都能帮助团队将隐性的、容易遗忘的“部落知识”显性化、结构化。

与普通的笔记或日志类工具相比,Napkin的核心区别在于其严格的“持续策展”机制和“行动导向”的格式要求。它强制要求每次阅读时都必须重新整理,只保留高频、高价值的指导,并要求每个条目都必须包含明确的“Do instead”行动指令,从而确保文档始终精炼、可用,而非变成杂乱无章的记事本。

核心特点

核心区别在于其“强制策展”和“行动优先”的设计理念。它不是一个被动的日志记录器,而是一个主动的知识管理工具,每次会话都强制重新评估和整理内容,确保只保留最高频、最关键的“行动指南”,并严格限制每个类别最多10条,杜绝信息膨胀。

注意事项

不适合用于记录一次性的调试过程、详细的故障复盘或需要长篇大论解释的复杂背景知识。

常见问题

Napkin 和普通的项目 README 或文档有什么区别?

Napkin 是动态的、行动导向的运行手册,聚焦于高频、易忘的具体操作和陷阱;而 README 通常是静态的项目概述和入门指南。Napkin 的内容会随着每次工作会话被 AI 自动整理和更新。

它会影响 AI 处理我当前任务的速度吗?

几乎不会。AI 在会话开始时快速读取并内化 Napkin 内容,整个过程是静默的。它旨在通过提前提供关键指导来避免后续犯错,从而提升整体效率和可靠性。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/napkin/raw/index.md 读取 napkin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。