|
47 | 47 | - 加载 one-time/setup/update-checker.md 获取检查指令 |
48 | 48 | - 根据安装源执行对应的检查策略 |
49 | 49 | - 如果发现新版本 → 礼貌提示用户更新 |
50 | | - - 如果检查失败 → 静默忽略,不影响正常使用 |
| 50 | + - 如果检查失败 → 自动忽略,不影响正常使用 |
51 | 51 | e. 检查完成后(无论成功失败),更新 last_check 为今天日期 |
52 | 52 | ``` |
53 | 53 |
|
|
56 | 56 | → 有:跳过 projects.yaml,直接读 PROJECT-STATUS.md 恢复上下文 |
57 | 57 | → 无:继续步骤 b |
58 | 58 | b. 检查 ~/.myknowledge/config/projects.yaml 是否存在 |
59 | | - → 不存在:首次使用,不提示(等用户说"创建知识库"或静默触发) |
| 59 | + → 不存在:首次使用,不提示(等用户说"创建知识库"或自动触发) |
60 | 60 | → 存在且非空:读取项目列表,礼貌询问"要恢复哪个项目?" |
61 | 61 | 列出格式:项目名(路径),用户选择后读对应 PROJECT-STATUS.md |
62 | 62 | c. 用户选择了项目 → 更新 projects.yaml 中该项目的 last_access |
|
65 | 65 |
|
66 | 66 | ## 加载时自检(AI 透明验证) |
67 | 67 |
|
68 | | -> 每次加载本 Skill 时,**静默执行**以下检查。如有异常,按指示处理。 |
| 68 | +> 每次加载本 Skill 时,**后台执行**以下检查。如有异常,按指示处理。 |
69 | 69 | > 目的:让用户无需手动操作即可获得"Skill 完整性"保障。 |
70 | 70 |
|
71 | 71 | **重要设计原则**(v1.1.4+): |
|
81 | 81 | - modules/commands/main.md ✓ |
82 | 82 | - modules/management/main.md ✓ |
83 | 83 | - modules/error/main.md ✓ |
84 | | - - modules/silent/main.md ✓ |
| 84 | + - modules/auto-track/main.md ✓ |
85 | 85 | - one-time/onboarding/main.md ✓ |
86 | 86 | - hooks/ 目录至少有一个子目录 ✓ |
87 | 87 | 缺失任何一个 → 提示用户:"Skill 文件不完整,建议重新安装" |
|
91 | 91 | - settings.yaml 可被解析 |
92 | 92 | 缺失或损坏 → 提示用户:"Skill 配置文件可能损坏,建议重新安装" |
93 | 93 |
|
94 | | -3. 检查 install-source 格式(静默): |
| 94 | +3. 检查 install-source 格式(后台): |
95 | 95 | - 读 ~/.myknowledge/config/install-source |
96 | 96 | - 如果是纯文本(非 YAML,不以 "source:" 开头)→ 加载 one-time/setup/install-source.md 触发重新检测 |
97 | 97 | - 检测完成后写入新 YAML 格式 |
98 | 98 | - 已经是 YAML 格式 → 跳过 |
99 | 99 |
|
100 | | -4. 检查项目迁移需求(静默,skill-state.yaml 存在时执行): |
| 100 | +4. 检查项目迁移需求(后台,skill-state.yaml 存在时执行): |
101 | 101 | - 读 projects.yaml,筛选 type: "project" 的旧条目 |
102 | 102 | - 发现旧条目 → 提示"检测到 {N} 个项目级知识库,v1.3.0 起默认使用全局知识库。是否迁移到 ~/.myknowledge/global/?" |
103 | 103 | - 用户确认 → 搬移文件到 global/ + 更新 projects.yaml(type 改为 global) |
|
107 | 107 | - 有 → 说明已有知识库但未注册,提示"检测到未注册的知识库,是否重新索引?" |
108 | 108 | - 无 → 跳过(真正首次使用) |
109 | 109 |
|
110 | | -5. 自检通过 → 静默继续,不向用户报告 |
| 110 | +5. 自检通过 → 后台继续,不向用户报告 |
111 | 111 | 自检失败 → 礼貌提示,但不阻断正常使用(缺失文件可能懒加载修复) |
112 | 112 | ``` |
113 | 113 |
|
114 | 114 | **原则**: |
115 | 115 | - ✅ 自检是**用户友好的**——失败时清晰提示 |
116 | | -- ✅ 自检是**静默的**——通过时不打扰 |
| 116 | +- ✅ 自检是**后台的**——通过时不打扰 |
117 | 117 | - ✅ 自检是**独立**的——不依赖 manifest 等"声明性"文件 |
118 | 118 | - ❌ 自检**不替代**完整 lint(lint 是开发者/平台侧) |
119 | 119 |
|
@@ -148,7 +148,7 @@ IF 用户问更新: |
148 | 148 | - ✅ 在 `~/.myknowledge/` 范围内创建/读取/修改文件 |
149 | 149 | - ✅ 按 `modules/commands/main.md` 的命令表响应用户请求 |
150 | 150 | - ✅ 跟踪 `REQ-YYYYMMDD-XXX` 格式的需求 |
151 | | -- ✅ 按 `settings.yaml` 的 `complex_task_detection` 规则静默记录 |
| 151 | +- ✅ 按 `settings.yaml` 的 `complex_task_detection` 规则自动记录 |
152 | 152 |
|
153 | 153 | **不做**(遇到此类请求要礼貌拒绝并说明): |
154 | 154 | - ❌ 联网、调用外部 API、上传数据 |
@@ -245,7 +245,7 @@ IF 用户请求导出/导入/分享/备份知识库: |
245 | 245 |
|
246 | 246 | ### 5. 自动检测模式 |
247 | 247 |
|
248 | | -> **详细说明**:`modules/silent/main.md` |
| 248 | +> **详细说明**:`modules/auto-track/main.md` |
249 | 249 |
|
250 | 250 | 当检测到复杂任务时,自动创建知识库并告知用户。 |
251 | 251 |
|
@@ -373,12 +373,12 @@ IF 用户提到需求 ID (REQ-XXX): |
373 | 373 | | 归档需求 | `📦 已归档 {id}:{title}` | 批量归档时列出所有 ID | |
374 | 374 | | 删除需求 | `🗑️ 已删除 {id}:{title}` | 删除前已确认,此反馈仅告知完成 | |
375 | 375 | | 自动会话记录 | `📋 已记录本次会话到 {id}` | 追加到需求文件后告知,不中断对话 | |
376 | | -| 静默创建 | `🔇 检测到复杂任务,已自动创建知识库「{name}」和需求 {id}` | 静默触发后的统一告知 | |
| 376 | +| 自动创建 | `🔇 检测到复杂任务,已自动创建知识库「{name}」和需求 {id}` | 自动触发后的统一告知 | |
377 | 377 |
|
378 | 378 | **不需要单独反馈的操作(伴随上述操作自动完成):** |
379 | 379 | - PROJECT-STATUS.md 的例行更新(已在上述反馈中覆盖) |
380 | 380 | - projects.yaml 的 last_access 更新(纯技术维护) |
381 | | -- 自检通过(静默) |
| 381 | +- 自检通过(后台) |
382 | 382 |
|
383 | 383 | --- |
384 | 384 |
|
@@ -406,7 +406,7 @@ IF 遇到错误: |
406 | 406 | | 需求管理 | `modules/management/main.md` | |
407 | 407 | | 错误处理 | `modules/error/main.md` | |
408 | 408 | | 导出/导入 | `modules/export/main.md` | |
409 | | -| 静默模式 | `modules/silent/main.md` | |
| 409 | +| 智能任务追踪 | `modules/auto-track/main.md` | |
410 | 410 | | 命令速查 | `modules/commands/main.md` | |
411 | 411 | | 模板 | `core/templates/`(共6个) | |
412 | 412 | | ├ 项目状态 | `core/templates/project-status-template.md` | |
|
0 commit comments