feat: 更新 knowledge-base-manager skill,添加完整 ID 映射和严格目录限制

This commit is contained in:
oliver 2026-05-16 22:27:57 +08:00
parent acfb2cf73b
commit 807679aaaa
21 changed files with 753 additions and 1580 deletions

View file

@ -1,83 +1,91 @@
---
name: self-improvement
description: 将纠错、错误与能力缺口写入 Wiki 以持续改进。适用于操作失败、用户反馈纠正、问题复发、或需要沉淀并推动的新能力需求场景。
metadata:
# self-improvement — 自我改进 (Self-Improvement)
> 将纠错、错误与能力缺口写入 Wiki 以持续改进,形成"犯错→记录→不再犯"的闭环。
> 本技能完全基于 `memory_wiki_*` 工具,不依赖本地文件或外部脚本。
---
# 自我改进(仅 Wiki)
## 触发条件 (Triggers)
本技能仅使用 Wiki,不使用本地 `.learnings/` 文件。
出现以下情况时启用:
## 存储路径
1. 命令或操作出现非预期失败
2. 用户对回答进行纠正
3. 用户提出缺失能力需求
4. 同类问题再次复发
5. 发现更优且可复用的方法
6. 每轮对话结束时(强制三问反思)
- `improvement/learnings.md`
- `improvement/errors.md`
- `improvement/feature-requests.md`
## 必要流程 (Required Workflow)
## 触发条件
```
1. memory_wiki_search → 检索 improvement/* 看是否已有记录
2. memory_wiki_get → 读取目标文件上下文
3. memory_wiki_apply → 追加结构化条目 (action=append)
4. memory_wiki_lint → 质量检查
5. lint 报错 → 立即修复
```
出现以下情况时启用本技能:
## 条目路由 (Entry Routing)
1. 命令或操作出现非预期失败。
2. 用户对错误回答进行纠正。
3. 用户提出缺失能力需求。
4. 同类问题再次复发。
5. 发现更优且可复用的方法。
| 内容类型 | 目标文件 | 示例 |
|---------|---------|------|
| 纠错/洞见/最佳实践 | `improvement/learnings.md` | 用户纠正了某个认知错误 |
| 运行时/工具/API 失败 | `improvement/errors.md` | 某个工具调用报错 |
| 能力缺口/功能请求 | `improvement/feature-requests.md` | 用户问"你能做 X 吗?" |
| 长篇经验沉淀 (>300 字) | `improvement/learnings/<topic>.md` | 一次完整的技能安装流程 |
## 必要流程
每次触发都执行以下流程:
1. 用 `memory_wiki_search` 检索历史相关记录。
2. 用 `memory_wiki_get` 读取目标文件上下文。
3. 用 `memory_wiki_apply`(`action=append`)追加结构化条目。
4. 对目标文件执行 `memory_wiki_lint`。
5. 若 lint 报错,立即用 `memory_wiki_apply` 修复。
## 条目路由
- 纠错 / 洞见 / 最佳实践 -> `improvement/learnings.md`
- 运行时 / 工具 / API 失败 -> `improvement/errors.md`
- 能力请求 / 缺失功能 -> `improvement/feature-requests.md`
## 条目模板
## 条目模板 (Entry Template)
```markdown
## [ID] <标题>
**Logged**: ISO-8601 时间戳
## [ID] 标题 (Title)
**Logged**: ISO-8601 时间戳 (Timestamp)
**Priority**: low | medium | high | critical
**Status**: pending
**Status**: pending | resolved | promoted_to_skill
**Area**: frontend | backend | infra | tests | docs | config
### Summary
### 摘要 (Summary)
一句话摘要。
### Details
### 详情 (Details)
发生了什么、为什么重要、可执行改进建议。
### Metadata
- Source: conversation | error | user_feedback
### 元数据 (Metadata)
- Source: conversation | error | user_feedback | reflection
- Related Files: path/to/file.ext
- See Also: <optional-id>
```
ID 格式:
### ID 格式 (ID Format)
- Learning: `LRN-YYYYMMDD-XXX`
- Error: `ERR-YYYYMMDD-XXX`
- Feature request: `FEAT-YYYYMMDD-XXX`
## 提升目标
XXX = 当天序号,从 001 开始。
当条目已具备广泛复用价值时,将精炼规则提升到:
## 提升路径 (Promotion Path)
- `AGENTS.md`(工作流模式)
- `SOUL.md`(行为模式)
- `TOOLS.md`(工具易错点)
- `.github/copilot-instructions.md`(共享编码约定)
当某个条目被验证有广泛复用价值时:
## 安全规则
| 到达条件 | 提升目标 |
|---------|---------|
| 可用作行为约定 | `core/principles.md` |
| 可用作维护规则 | `core/maintenance.md` |
| 可提炼为独立技能 | 使用 `skill-creator` 创建新技能 |
| 某个工具易错点 | 标注在 SKILL.md 或 REFERENCES.md |
- 不记录密钥、令牌、凭据或原始敏感信息。
- 敏感输出使用脱敏摘要,不保留完整原文。
- 未验证事实不得当作已确认规则持久化。
## 会话结束三问 (End-of-Session Reflection)
每轮对话结束前执行:
1. **学到了什么?** → `improvement/learnings.md`
2. **有什么可优化?** → `improvement/feature-requests.md` 或 `core/principles.md`
3. **用户画像有更新吗?** → `users/current.md`
## 安全规则 (Security Rules)
- 不记录密钥、令牌、凭据或原始敏感信息
- 敏感输出使用脱敏摘要,不保留完整原文
- 未验证事实不得当作已确认规则持久化
- 涉及用户偏好写入时需有明确的对话证据,不推测