补充任务自动提交脚本与工作流文档

docs/technical/README.md

@@ -9,6 +9,7 @@
 - [PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md](./PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md)：后端提示词收口到 `server-node/src/prompts/` 的目录方案、兼容策略与后续新增规则。
 - [SPACETIME_DEV_URI_HOTFIX_2026-04-20.md](./SPACETIME_DEV_URI_HOTFIX_2026-04-20.md)：修复开发默认配置把 Spacetime 连接误指向 Vite `3000` 端口的问题。
 - [SPACETIME_AUTH_TOKEN_FALLBACK_HOTFIX_2026-04-20.md](./SPACETIME_AUTH_TOKEN_FALLBACK_HOTFIX_2026-04-20.md)：本地 token 失效时自动降级匿名连接，并提示“登录已过期”的热修记录。
+- [TASK_AUTO_COMMIT_WORKFLOW_2026-04-20.md](./TASK_AUTO_COMMIT_WORKFLOW_2026-04-20.md)：任务完成后按文件边界自动提交的脚本与协作约定。
 - [NODE_DEV_STARTUP_HOTFIX_2026-04-20.md](./NODE_DEV_STARTUP_HOTFIX_2026-04-20.md)：`npm run dev` 启动失败的热修记录、根因与验证结果。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
 - [EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md](./EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md)：Express 后端当前 contract 冻结版本、热点文件编辑规则与集成窗口清单。

docs/technical/TASK_AUTO_COMMIT_WORKFLOW_2026-04-20.md

@@ -0,0 +1,71 @@
+# 任务完成自动提交工作流（2026-04-20）
+
+## 1. 目标
+
+为避免“任务已完成但改动长期停留在工作区”与“提交时把无关改动一并打包”的问题，仓库补充一条统一工作流：
+
+1. 当任务明确完成时，立即执行一次提交。
+2. 只提交当前任务相关文件。
+3. 提交信息使用中文简洁摘要。
+4. 不依赖 `git hook` 或后台自动监听。
+
+## 2. 实现方式
+
+新增脚本：
+
+- `scripts/commit-task.mjs`
+
+职责：
+
+1. 接收提交信息 `-m/--message`
+2. 接收本次任务要提交的文件列表
+3. 先检查这些文件是否确实存在未提交改动
+4. 只暂存传入文件
+5. 只在存在暂存内容时执行提交
+
+## 3. 使用方式
+
+命令格式：
+
+```bash
+node scripts/commit-task.mjs -m "中文提交摘要" <file...>
+```
+
+示例：
+
+```bash
+node scripts/commit-task.mjs \
+  -m "补充任务完成后自动提交协作约定" \
+  docs/experience/PROJECT_WORK_EXPERIENCE_PLAYBOOK.md \
+  docs/experience/README.md
+```
+
+## 4. 行为约束
+
+1. 不传 `-m` 会直接失败。
+2. 不传文件列表会直接失败。
+3. 指定文件没有改动时不会创建空提交。
+4. 脚本不会自动把未指定文件加入提交。
+5. 脚本不做 `amend`，不改写历史。
+
+## 5. 适用范围
+
+适用于：
+
+1. 单任务完成后的常规提交
+2. 工作区存在其他无关改动时的定向提交
+3. 需要明确控制提交边界的日常开发
+
+不适用于：
+
+1. 需要 squash 或改写历史的场景
+2. 需要交互式挑选 hunk 的场景
+3. 无法清晰界定当前任务文件边界的场景
+
+## 6. 当前协作约定
+
+默认规则：
+
+1. 用户明确表示任务完成，或直接要求提交时，优先使用这条工作流。
+2. 若当前任务文件边界清晰，则直接提交。
+3. 若边界不清晰，则先停下并说明风险，不强行提交。