| name | fast-note-execute-dev-plan |
| description | 按 fastnote 的开发计划文档执行研发任务并交付代码、自动化测试与状态回写。用于用户提出“按任务ID开发/根据开发计划落地实现/补自动化测试/执行并更新任务状态”类需求，输入通常是 `docs/开发计划/迭代计划与任务看板.md`、`docs/开发计划/组件与数据契约清单.md`、`docs/开发计划/测试与发布计划.md`。 |
fastnote 开发执行器（中文）
快速开始
- 读取开发计划输入：
docs/开发计划/迭代计划与任务看板.mddocs/开发计划/组件与数据契约清单.mddocs/开发计划/测试与发布计划.md
- 确定任务：
- 优先使用用户指定
任务ID。
- 未指定时默认选择首个
P0 且状态非“已完成”的任务。
- 按契约清单改代码，并补齐测试计划中该任务映射用例。
- 执行校验命令并修复失败项。
- 回写任务状态与测试覆盖状态。
工作流
1) 锁定任务范围
- 在看板中定位任务行：
任务ID/功能点/优先级/依赖/验收标准。
- 依赖未完成时先标记阻塞，不盲目开发。
- 默认单任务交付；用户要求可并行多任务。
2) 建立实现映射
- 在契约清单中定位该功能点对应的变更层：
UI -> fastnote/src/pages、fastnote/src/widgets编排 -> fastnote/src/processes、fastnote/src/features实体 -> fastnote/src/entities数据 -> fastnote/src/shared/lib/storage、fastnote/src/shared/api/pocketbase路由 -> fastnote/src/app/router后端宿主 -> backend
- 禁止绕过
entities/features/processes 直接在 UI 中改核心数据。
3) 实施开发变更
- 最小闭环：
代码实现 + 自动化测试 + 验证通过。
- 按任务验收标准逐条对齐实现。
- 涉及数据契约变更时，必须同步更新契约文档对应条目。
4) 补齐自动化测试
- 从
测试与发布计划.md 中提取该任务映射：
- 优先级规则：
P0：必须新增或更新自动化测试，且门禁为阻断。P1：默认自动化；若暂无法自动化需注明原因。P2：可手工优先，但需列出自动化候选。
- 若映射文件不存在，按计划路径创建测试文件骨架并实现最小用例。
5) 执行验证
- 默认执行：
cd fastnote && npm run lintcd fastnote && npm run test:unit -- --runcd fastnote && npm run build
- 若任务映射含 E2E，再执行：
cd fastnote && npm run test:e2e
- 若
测试与发布计划 命令与仓库脚本不一致，优先执行仓库可用命令并回写 [待确认]。
6) 回写状态与交付说明
- 回写
迭代计划与任务看板.md 的任务状态（建议：未开始/进行中/已完成/阻塞）。
- 回写
测试与发布计划.md 三向映射覆盖状态。
- 在交付说明中包含：
状态约定
- 任务状态：
未开始、进行中、已完成、阻塞。
- 覆盖状态：
未开始、进行中、已完成。
- 仅当代码与自动化测试通过后，任务状态才可改为
已完成。
fastnote 约束
- 保持 offline-first：本地可编辑和可读能力不被破坏。
Note 契约若改动，必须同步到 组件与数据契约清单.md。- 同步逻辑改动必须说明冲突策略与失败补偿。
- 公开访问链路改动需覆盖桌面与移动两条路径。
输出规则
- 默认输出中文。
- 优先直接落地代码与测试，不只停留在建议。
- 若信息不足，先标注
[待确认] 再给最小安全实现。
推荐检索命令
rg "T-FN-|任务ID|优先级|依赖|验收标准" docs/开发计划/迭代计划与任务看板.md
rg "任务ID|用例ID|测试文件路径|CI门禁级别" docs/开发计划/测试与发布计划.md
rg "功能点ID|UI|Features|Entities|Processes|Storage|PocketBase|Router|Backend" docs/开发计划/组件与数据契约清单.md
参考资料
references/dev-task-execution-checklist-zh.md：开发执行检查清单references/task-status-convention-zh.md：任务与覆盖状态回写规范
