CraftKit/plugins/knowledge/skills/lessons/SKILL.md

name, description

name	description
lessons	初始化和维护 .craftkit 问题经验库，并按已确认的经验判据审计项目或提出规范提升建议。适用于经验条目的创建、合并、过时处理、回扫和提升；普通任务总结、直接修改代码或自动改写插件不应触发本 Skill。

项目问题经验

统一维护 .craftkit/knowledge/pitfalls/。经验必须来自可复核证据，并明确现象、根因、处理、验证和适用范围；不把猜测或一次性任务细节升级为长期规则。

选择模式

• init：首次建立经验索引，读取 初始化规则。
• curate：新增、合并、纠正或标记过时经验，读取 维护规则。
• audit：按条目中明确的扫描规则只读回扫项目，读取 审计规则。
• promote：把项目经验提炼为项目规范或 CraftKit 改进建议，读取 提升规则。

用户未说明模式时，根据目标提出建议并确认。初始化授权不包含重组，审计授权不包含修复，提升授权不包含修改目标规范或插件。

共同边界

• 先读取适用的 AGENTS.md、.craftkit/README.md、知识索引和已有经验，不建立第二套经验目录。
• 不预建空分类；条目较少时保持扁平，只有检索确有困难时才提议分类。
• 已有条目、索引和用户章节保守合并，不整文件覆盖。
• 重命名、合并、删除、纠正和移动条目前展示影响并取得确认。
• 不记录凭据、个人信息、机器绝对路径或大段源码与日志。
• 写入完成后报告实际文件和未采纳建议；不自动暂存、提交或推送。