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

# 项目问题经验

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

## 选择模式

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

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

## 共同边界

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