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