@michaelxwb/code-flow 0.8.1 → 1.0.0

package/src/adapters/codex/skills/cf-task-note/SKILL.md

@@ -1,245 +0,0 @@
----
-name: cf-task-note
-description: Discuss #NOTES annotations in task files or design briefs, propose solutions with context, resolve questions collaboratively, and merge conclusions back removing the #NOTES marker. Use when files have unresolved #NOTES markers.
----
-
-> **命令面状态（0.8）**：alias — 等价于 `cf-task-status --notes`；保留一个 minor，0.9.0 移除。
-
-## 背景
-
-用户在 review 文件时，直接在有问题的位置**就地标注** `#NOTES`，格式：
-
-任务文件中：
-```markdown
-### Checklist
-- [ ] 实现用户注册接口
-- [ ] 密码加密存储  #NOTES 用 bcrypt 还是 argon2？
-- [ ] 编写单元测试
-
-### Description
-实现 JWT 认证  #NOTES token 过期时间设多少合适？
-```
-
-设计简报中：
-```markdown
-## Database Design
-
-### users 表
-| Column | Type | Constraints | Notes |
-|--------|------|-------------|-------|
-| email | VARCHAR(255) | UNIQUE NOT NULL | 登录凭证 #NOTES 需要支持手机号登录吗？ |
-
-## API Design
-
-### POST /auth/register
-- Request: `{ email: string, password: string }`  #NOTES 需要用户名字段吗？
-```
-
-`#NOTES` 是临时讨论标记，解决后必须消失，结论直接融入原文。
-
-## 输入
-
-- `cf-task-note <file>` — 讨论指定文件中所有 `#NOTES`
-- `cf-task-note <file> TASK-001` — 只讨论指定子任务中的 `#NOTES`（仅限任务文件）
-
-其中 `<file>` 可省略日期目录前缀和 `.md` 后缀。
-
-查找逻辑：用 `rg --files` 或 `find` 搜索 `.code-flow/tasks/**/<file>.md` 和 `.code-flow/tasks/**/<file>*.design.md`（`*` 兼容旧 `<file>.design.md` 与域后缀 `<file>.frontend.design.md` / `<file>.backend.design.md`），从结果中排除包含 `archived/` 的路径。如果匹配到多个结果（如全栈需求的前后端 design），输出警告列出所有匹配项，让用户指定要讨论的具体文件；如果只有一个结果，直接使用。
-
-## 执行步骤
-
-### 0. 判断文件类型
-
-读取匹配到的文件后，判断类型：
-- 文件路径以 `.design.md` 结尾 → **设计简报模式**
-- 其他 → **任务文件模式**
-
----
-
-## 任务文件模式
-
-### 1. 扫描 #NOTES 标记
-
-1. 用 `rg --files` 或 `find` 定位任务文件，读取全文
-2. 用正则扫描所有包含 `#NOTES` 的行，记录：
-   - 所在的子任务（`## TASK-xxx`）
-   - 所在的段落（Description / Checklist / 其他）
-   - 原始行内容
-   - `#NOTES` 后的问题描述
-3. 如果没有找到 `#NOTES`，提示"无待讨论的标记"，结束
-
-输出扫描结果：
-```
-找到 3 个 #NOTES 标记:
-
-TASK-001:
-  1. [Checklist] 密码加密存储  #NOTES 用 bcrypt 还是 argon2？
-  2. [Description] 实现 JWT 认证  #NOTES token 过期时间设多少合适？
-
-TASK-002:
-  3. [Checklist] 调用支付 SDK  #NOTES 用哪个版本的 SDK？
-
-开始逐条讨论...
-```
-
-### 2. 加载上下文
-
-1. 读取当前子任务的 `Source` 字段，解析章节引用
-2. 按行号范围读取详设文档的对应章节
-3. 将详设上下文作为讨论背景
-
-### 3. 逐条讨论
-
-对每个 `#NOTES`，展示上下文并给出建议方案，与用户对话：
-
-```
---- #NOTES 1/3 ---
-位置: TASK-001 / Checklist
-原文: 密码加密存储  #NOTES 用 bcrypt 还是 argon2？
-
-详设参考 (§3.1 L95-L98):
-  "用户密码必须加密存储，推荐使用行业标准算法"
-
-分析:
-  - bcrypt: 成熟稳定，生态支持好，Node.js 原生支持
-  - argon2: 更现代，抗 GPU 攻击更强，但依赖 C 编译
-
-建议: bcrypt（项目技术栈为 Node.js，无需额外编译依赖）
-
-是否采纳？或提出你的方案:
-```
-
-等待用户回应。
-
-### 4. 沉淀结论并清除标记
-
-用户确认方案后：
-
-1. 用 apply_patch 将该行中的 `#NOTES xxx` 删除，并将结论融入原文
-   - 修改前：`- [ ] 密码加密存储  #NOTES 用 bcrypt 还是 argon2？`
-   - 修改后：`- [ ] 密码使用 bcrypt 加密存储`
-2. 如果结论需要新增步骤 → 用 apply_patch 追加 Checklist 条目或补充 Description
-3. 在 `### Log` 追加：`- [<当前日期>] resolved #NOTES: <结论摘要>`
-
-**apply_patch 边界约束（必须遵守）**：
-- `old_string` 必须严格限定在当前 TASK 段落内，**绝对禁止**匹配到 `---` 分隔线或下一个 `## TASK-xxx` 标题
-- Log 追加时，`old_string` 只匹配 Log 段落的最后一行内容，不要向下延伸到段落外
-- 如果 Log 是当前 TASK 的最后一个段落，其内容到 `---` 分隔线之前结束；`old_string` 不得包含 `---` 及其后的任何内容
-- 示例（正确）：`old_string = "- [2026-03-23] created (draft)"` → 只匹配 Log 末行
-- 示例（错误）：`old_string = "- [2026-03-23] created (draft)\n\n---\n\n## TASK-003"` → 越界，会删除下一个 TASK 标题
-
-### 5. 完成检查
-
-所有 `#NOTES` 讨论完毕后：
-
-1. 再次扫描文件，确认无残留 `#NOTES` 标记
-2. 如果子任务之前因 `#NOTES` 被标记为 `blocked`，清除当前阻塞条目后调用 `code-flow task resume --root "$PWD" --task-dir "<需求目录>" --task TASK-001 --json`。命令检查依赖和残留 Notes，同步 marker 与任务状态；不得从历史 Log 猜测状态后只改 Markdown。失败保留 blocked 并报告原因。
-3. 更新文件头 `Updated` 日期
-
-### 6. 输出摘要
-
-```
-#NOTES 讨论完成: auth-module
-
-已解决:
-  1. TASK-001 密码加密 → 使用 bcrypt
-  2. TASK-001 token 过期 → 设为 7 天，支持 refresh
-  3. TASK-002 SDK 版本 → 使用 v3.2.1
-
-文件已更新，所有 #NOTES 标记已清除。
-可执行 cf-task-start auth-module 开始编码。
-```
-
----
-
-## 设计简报模式
-
-### 1. 扫描 #NOTES 标记
-
-1. 读取 `.design.md` 全文
-2. 用正则扫描所有包含 `#NOTES` 的行，记录：
-   - 所在的章节（`## Goal` / `## Database Design` / `## API Design` 等）
-   - 原始行内容
-   - `#NOTES` 后的问题描述
-3. 如果没有找到 `#NOTES`，提示"无待讨论的标记"，结束
-
-输出扫描结果：
-```
-找到 2 个 #NOTES 标记 (设计简报):
-
-[Database Design]:
-  1. email 字段  #NOTES 需要支持手机号登录吗？
-
-[API Design / POST /auth/register]:
-  2. Request schema  #NOTES 需要用户名字段吗？
-
-开始逐条讨论...
-```
-
-### 2. 加载上下文
-
-设计简报本身就是设计文档，无需加载外部 Source。上下文来自：
-
-1. 读取 `.design.md` 中该 `#NOTES` 所在章节的完整内容
-2. 扫描代码库中与该问题相关的现有实现（如用 `rg` 搜索现有 model/route/middleware）
-3. 将代码库上下文 + 设计文档上下文作为讨论背景
-
-### 3. 逐条讨论
-
-对每个 `#NOTES`，展示上下文并给出建议方案，与用户对话：
-
-```
---- #NOTES 1/2 ---
-位置: Database Design / users 表
-原文: email 字段  #NOTES 需要支持手机号登录吗？
-
-当前设计: users 表仅有 email 字段作为登录凭证
-代码库参考: 现有 User model 无手机号字段，mailer 模块仅支持邮件
-
-分析:
-  - 仅邮箱: 与现有 mailer 模块一致，MVP 足够
-  - 支持手机号: 需新增 phone 字段、SMS 服务依赖、双凭证登录逻辑
-
-建议: 仅邮箱（与 Non-goals 中"保持 MVP 精简"一致，手机号可后续迭代）
-
-是否采纳？或提出你的方案:
-```
-
-### 4. 沉淀结论并清除标记
-
-用户确认方案后：
-
-1. 用 apply_patch 将该行中的 `#NOTES xxx` 删除，并将结论融入原文
-   - 修改前：`| email | VARCHAR(255) | UNIQUE NOT NULL | 登录凭证 #NOTES 需要支持手机号登录吗？ |`
-   - 修改后：`| email | VARCHAR(255) | UNIQUE NOT NULL | 登录凭证（仅邮箱，手机号后续迭代） |`
-2. 如果结论影响其他章节（如 Database Design 的结论影响 API Design），同步更新相关章节
-
-### 5. 完成检查
-
-所有 `#NOTES` 讨论完毕后：
-
-1. 再次扫描文件，确认无残留 `#NOTES` 标记
-2. 无 Log 段落需更新（设计简报没有 Log）
-
-### 6. 输出摘要
-
-```
-#NOTES 讨论完成: user-auth.design.md
-
-已解决:
-  1. [Database Design] 登录凭证 → 仅邮箱，手机号后续迭代
-  2. [API Design] 注册接口 → 不加 username 字段，保持 email + password
-
-文件已更新，所有 #NOTES 标记已清除。
-可执行 cf-task-plan .code-flow/tasks/2026-04-06/user-auth.design.md 拆解任务。
-```
-
-<!-- code-flow:runtime-commands start -->
-
-运行时命令示例（由命令契约生成；实际参数见各命令 --help）：
-
-```bash
-code-flow task resume --help
-```
-
-<!-- code-flow:runtime-commands end -->