메뉴
feature 流程的超轻量通道——不写 design / checklist 直接动手，但先指引 AI 查 kflow 知识库再开工。触发：用户说"快速模式"、"fastforward"、"别那么多步骤"、"直接开干"，且需求小到不值得走 design 流程。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
维护 `.kflow/architecture/` 这份只记现状的系统地图，三种模式 update / check / backfill。触发：用户说"刷新 architecture"、"做架构检查"、"补这个模块的架构文档"、"方案和代码对得上吗"，或 feature 阶段需要先做架构动作。不写未来规划（走 k-roadmap）。
feature 流程阶段 3——验收闭环：对照 design 核实现 + 回写 architecture / requirement / roadmap，最后产出 {slug}-acceptance.md。触发：用户说"功能写完了验收一下"、"做最后检查"、"准备 merge"、"出验收报告"。前置依赖 k-feat-impl 完成。
feature 流程阶段 1——为新功能起草 {slug}-design.md 作为后续实现和验收的唯一输入，拍板后抽出 checklist。触发：用户说"开始设计方案"、"写 design doc"、"准备实现 XX"，前提是已知道做什么、为谁、怎么算成功。
feature 流程阶段 2——按 {slug}-checklist.yaml 里 design 切好的 paradigm 维度 steps 推进，每步具体改哪个文件由 implement 自决，写完用统一格式汇报。触发：用户说"方案确认了开始实现"、"按方案写代码"、"开工"。前提是 design 已 approved 且有 checklist。遇到方案外情况要回方案谈不要硬冲。
issue 流程阶段 2——读 report + 读代码定位根因、评估风险，给用户 2-3 个修复方案让 TA 拍板。这一步不改代码。触发：用户说"分析这个 bug"、"找根因"、"定位问题"，且已有 {slug}-report.md。
issue 流程阶段 3——按已确认根因和方案定点修复、验证、写 {slug}-fix-note.md 落档。两个入口：标准路径从 analyze 来，快速通道从 report 直接来。触发：用户说"开始修 bug"、"按分析修"、"动手改代码"。只动方案声明的文件，不顺手优化。
| name | k-feat-ff |
| description | feature 流程的超轻量通道——不写 design / checklist 直接动手，但先指引 AI 查 kflow 知识库再开工。触发：用户说"快速模式"、"fastforward"、"别那么多步骤"、"直接开干"，且需求小到不值得走 design 流程。 |
开始任何判断或动作前，先读取 .kflow/attention.md；缺失则视为骨架不完整，提示先补齐或运行 k-onboard。
用户让你做小功能时本来 AI 就会直接动手——这个技能不改变这件事。它只做一件事：动手前把项目里已沉淀的 kflow 知识指给你，按需搜一下，写出来的代码就比裸写多一层保护；动手后回写一份最简的 {slug}-ff-note.md 让这次工作可追溯、可被 k-arch / k-req backfill 看到、能纳入 scoped-commit 提交。
很轻：没有 design doc / checklist / 验收清单 / 动手前的用户确认。看完指引，该读代码读、该写代码写、写完回写一段话。
Glob .kflow/ 发现可用目录和文档，按需取用：
architecture/ — ARCHITECTURE.md 总入口 + 子系统 doc。改跨模块的东西前看一眼避免违反边界compound/ — learning / trick / decision / explore 四类沉淀：
python .kflow/tools/search-yaml.py --dir .kflow/compound --filter doc_type=learning --query "关键词"
python .kflow/tools/search-yaml.py --dir .kflow/compound --filter doc_type=decision --query "关键词"
python .kflow/tools/search-yaml.py --dir .kflow/compound --filter doc_type=trick --query "关键词"
requirements/ — 有相关 req 时读边界features/ — 有同类 feature 时参考其 designreference/ — shared-conventions.md 索引 / tools.md动手前问 2 个问题：
compound/ 的 learningcompound/ 的 decision + 看 architecture/ 相关子系统命中就把结论融进实现（按约束来写，不是抄）。没命中按自己判断写很正常。搜不到换几个关键词再试。
design / implement 的硬约束在 fastforward 的精简版。没 design doc 不代表可以不讲——这些是让你"直接动手"时不偏向 AI 默认会踩的坑。
30 秒回答：这次要加的东西在项目结构里属于哪儿？
默认坑：不思考就往眼前最顺手的文件里加——加完就成"什么都装的筐"。
开写前看一眼：文件多长？承担几件事？类有多少方法？新加的是自然扩展还是把它推向"什么都能干"？
健康就直接加；要先收拾（拆长文件 / 抽重函数）就先收拾再加，范围锁死为"只搬不改行为"；结构性问题（职责重划 / 模块拆合）→ 停下来回 design 流程。
只写用户明确要的。不顺手加：
判据：写完觉得"是不是还得加点 X"——X 是不是用户能感知到的？不是就别加。多出来的代码不是中性的，是后人维护的负担。
只改要改的函数。同文件里别的函数丑 / 命名怪——除非和这次冲突，否则别碰。新代码风格匹配当前文件已有写法。看到值得改的别处 → "顺手发现：{文件:行号} {问题}，不在本次范围"让用户决定。
会被其他地方引用 → 新文件；只一处用的小工具函数 → 就近放。
冒出 if (特殊情况) { 特殊处理 } → 停。这种分支基本只因为思路没覆盖到这种情况，硬写下去得到的是"为让代码能跑而加的特殊逻辑"。要么改数据结构让它不需要特殊处理，要么明确承认是边界情况并注释说明为什么特殊。
fastforward 不要求严格 TDD，但必须有运行时测试。不强制先后顺序，但代码写完时必须有对应测试通过。"手工验证过了"不算。完整测试口径看 .kflow/reference/shared-testing.md。
utils.ts / helpers.ts 万能 util 堆东西完整清单看 .kflow/reference/shared-reflection.md。
{slug}-ff-note.md代码写完、验证完、用户确认效果 OK 之后才动这一步——动手前先建空壳会破坏 ff 的轻体感。
不问用户。规则：
最终路径：.kflow/features/YYYY-MM-DD-{slug}/{slug}-ff-note.md，日期用今天。
---
doc_type: feature-ff-note
feature: {slug}
date: YYYY-MM-DD
requirement: {req-slug 或留空}
tags: [...]
---
## 做了什么
{1-3 句：解决什么需求 / 加了什么能力，业务视角}
## 改了哪些
- {file:行号区间或函数名} — {一句话说改了什么}
- ...
## 怎么验证的
{1-2 句：跑了哪些验证 / 浏览器走通了哪条路径 / 跑了什么测试}
## 顺手发现（可选，不阻塞）
- {文件:行号} {问题简述} — 不在本次范围
写得真的轻：每节就那么几行，不要把它写成迷你 design / 迷你 acceptance。这份文档的目标是"半年后有人看 git log 能跳进来 30 秒搞清楚做了啥"，不是替代标准流程。
落盘后告诉用户："已写 {slug}-ff-note.md，本次 fastforward 闭环。"
k-feat-design.kflow/ 里留 {slug}-ff-note.md 之外的新文件——除非发现值得沉淀的坑 / 技巧，另起对话用 k-learn / k-trick 写干到一半发现下面任一情况，停下来告诉用户"这比想象的复杂，建议切回完整流程"：
.kflow/architecture/ 既定的模块边界切回方式：触发 k-feat-design。已写的代码在 design 里标"已部分实现"即可。
{slug}-ff-note.md 已落盘且四节填齐（顺手发现可省）按 .kflow/reference/shared-closeout.md"scoped-commit"规则执行。本通道：
{slug}-ff-note.md按 shared-closeout.md"feature-ff"收尾推荐顺序逐项一句话提示（用户"不用"立即跳过）：
k-learn）"k-decide）"