القائمة
对仓库做定向代码探索并把"提问→读代码→得结论"沉淀为可检索证据，三种类型 question / module-overview / spike。触发：用户说"先 explore 一下"、"这个仓库里 X 怎么实现"、"快速熟悉这个模块"、"把探索结果存档"。
التثبيت باستخدام 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-explore |
| description | 对仓库做定向代码探索并把"提问→读代码→得结论"沉淀为可检索证据，三种类型 question / module-overview / spike。触发：用户说"先 explore 一下"、"这个仓库里 X 怎么实现"、"快速熟悉这个模块"、"把探索结果存档"。 |
开始任何判断或动作前，先读取 .kflow/attention.md；缺失则视为骨架不完整，提示先补齐或运行 k-onboard。
同一个问题第一次花两小时查代码，第二次应该五分钟内找到答案——前提是第一次做完留下证据化的记录。k-explore 把"提问 → 读代码 → 得结论"沉淀成可检索的探索文档。
本技能只负责"看到了什么"的证据化记录。用户意图是别的（拍板 / 处方 / 修 bug）让用户按场景选对应子技能。
共享路径与命名约定看
.kflow/reference/shared-paths.md。产物写入.kflow/compound/，命名YYYY-MM-DD-explore-{slug}.md，frontmatter 带doc_type: explore。
frontmatter 的 type 字段：
| 类型 | 适用情境 |
|---|---|
question | 围绕一个具体问题查代码并给结论 |
module-overview | 快速梳理某模块结构 / 边界 / 入口 / 依赖 |
spike | 对多个可能方向做轻量技术探查（不做最终决策） |
frontmatter / 正文结构 / 各节写法说明和示例见同目录 reference.md。流程约束：
confidence 必须降为 medium 或 lowoutdated，新增当前版本最多两个问题：
用户描述已清楚直接进 Phase 1.5。
按 shared-archive.md 查重规则执行：
status: outdated + 新建一份（supersede）；只补证据 / 收紧结论但核心结论未变时走"更新已有"更新路径：读旧文档 → 按 Phase 2 补证据 → 改写速答节 → 写回原文件 + updated: YYYY-MM-DD。
文件:行号module-overview / spike 类型 → 准备一张 Mermaid 图放在速答节里为什么"够了就停"：探索不是穷举，是建立到"读者能信"为止的证据链。继续扩大只会让文档变长而不变可信。
.kflow/compound/YYYY-MM-DD-explore-{slug}.md，frontmatter 带 doc_type: exploreupdated: YYYY-MM-DDshared-archive.md supersede 规则；旧文档 status: outdated + superseded-by证据收齐后一句话提示下一步方向（"要不要基于这份 explore 去设计方案"）。用户说"不用"就跳过——下一步由用户自己决定。
完整语法见
.kflow/reference/tools.md。
# 按类型筛选
python .kflow/tools/search-yaml.py --dir .kflow/compound --filter doc_type=explore --filter type=module-overview --filter status=active
# 归档后查重叠
python .kflow/tools/search-yaml.py --dir .kflow/compound --filter doc_type=explore --query "{关键词}" --json
compound/归档类共享规则见
shared-archive.md。本技能特有反模式：
status 标注doc_type=explore 的文档——本技能只负责 explore