From kflow
Appends short, stable project-specific facts (build flags, pre-run services, path traps, env conventions) to `.kflow/attention.md` so Claude always has them in context.
How this skill is triggered — by the user, by Claude, or both
Slash command
/kflow:k-noteThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
开始任何判断或动作前,先检查 `.kflow/attention.md`:存在就读取;缺 `.kflow/` 就提示先运行 `k-onboard`;只有 attention.md 缺失时,本技能可以先创建固定分节骨架再写入。
开始任何判断或动作前,先检查 .kflow/attention.md:存在就读取;缺 .kflow/ 就提示先运行 k-onboard;只有 attention.md 缺失时,本技能可以先创建固定分节骨架再写入。
k-learn / k-trick / k-decide 产出独立 markdown 文件,通过检索被读到;.kflow/attention.md 是 kflow 技能启动时的强制必读上下文。这两类信息归宿不同——本技能专管后者:把"短、稳、每次都要知道"的碎片追加到 attention 文件里。
不替代沉淀类技能,是补一个之前缺的入口。
判据:长度 + 频次 + 稳定度——三条都过才走 k-note。
| 项 | 进 k-note | 走别处 |
|---|---|---|
| 长度 | 一两行能讲清 | 超过半屏 / 需要展开背景 → k-learn |
| 频次 | 几乎每次会话都用得上 | 只在某类具体任务相关 → k-trick |
| 稳定度 | 项目长期生效的硬约束 | 临时绕过 / 短期 workaround → 写到 issue spec 或 feature spec |
| 拍板状态 | 已既成事实(不需要决策记录) | 需要记选型理由 / 拒方案 → k-decide |
✅ 典型该进:
pnpm run gen 生成 schema"docker compose up redis"npm install"bun test,不是 npm test"OPENAI_KEY 走 1Password,别从 .env.example 复制"❌ 典型不该进(会让 attention.md 膨胀):
判不准就反问用户一句:"这条以后是不是每次会话都要让 AI 知道?"答"不一定" → 不是 k-note。
目标文件固定为 .kflow/attention.md。
.kflow/ 不存在 → 本仓库还没接入 kflow,先提示用户运行 k-onboard.kflow/attention.md 不存在 → 视为骨架缺失,先创建最小骨架再写入attention.md 是项目注意事项的唯一权威源。跨平台 AI 通过 AGENTS.md(k-onboard 生成)发现并读取它。
为了防止文件膨胀成另一个胖文件,分节写死一组(不在列表里的不开新节):
## 项目碎片知识
<!-- k-note managed: 用 k-note 维护,新条目按下面分节追加 -->
### 编译与构建
### 运行与本地起服务
### 测试
### 命令与脚本陷阱
### 路径与目录约定
### 环境变量与凭证
### 其他
规则:
<!-- k-note managed --> 是本技能的识别锚——找不到就在文件末尾插入整块结构按上面"判据"表对一遍。任一项不过 → 引导到对应别的技能,本轮结束。
检查 .kflow/attention.md。缺 .kflow/ 就停止并提示先 k-onboard;只缺 attention.md 就创建本技能的固定分节骨架。
.kflow/attention.md,找 <!-- k-note managed --> 锚定位每条格式:
- {一句话事实 + 必要时一句话原因}
例:
- 编译前要先 `pnpm run gen`,否则 schema 类型对不上
- 别用 `npm install`,项目锁文件是 yarn berry 的
- src/legacy/ 是 2023 前的老代码,改之前先和 @ldz 确认
写完用户 review 一句确认就退出。不主动连写多条——一次一条,避免顺手把没拍板的也塞进去。
写完看一眼"项目碎片知识"段总行数:
只是提示,不替用户决定。
不要每次都问。只在两个明确信号触发时推一句:
k-note 一下?以后 AI 每次都能看到。"k-note 记一笔,下次会话直接知道。"用户说"不用了"立刻跳过,不重复推。
AGENTS.md / CLAUDE.md——k-note 只写 attention.md,入口文件由 k-onboard 统一管理npx claudepluginhub kunbo928/kflowCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.