更新openspec

.opencode/instructions.md

@@ -0,0 +1,46 @@
+# 项目指令
+
+## ⚠️ 重要：任务完成后必须通知
+
+**当你完成任何后台任务时，必须执行以下命令通知 Clawdbot：**
+
+```bash
+clawdbot gateway call cron.wake --params '{"text":"✅ 任务完成：[简短描述]"}'
+```
+
+### 为什么必须通知？
+- Clawdbot 无法主动知道你何时完成任务
+- 只有你主动调用 wake 命令，Clawdbot 才会收到通知
+- 否则用户会一直等待，不知道任务是否完成
+
+### 正确示例：
+```bash
+clawdbot gateway call cron.wake --params '{"text":"✅ 环境变量设置脚本已完成"}'
+clawdbot gateway call cron.wake --params '{"text":"✅ API 文档生成完毕"}'
+clawdbot gateway call cron.wake --params '{"text":"✅ OpenSpec 工作流已完成：enterprise-card-authorization"}'
+```
+
+### ❌ 错误示例（不要使用）：
+```bash
+# 错误：没有 call 子命令
+clawdbot gateway wake --text "完成消息" --mode now
+
+# 错误：参数格式不对
+clawdbot gateway call cron.wake --text "完成消息"
+
+# 错误：忘记通知
+echo "✅ 任务完成"  # 只输出不通知
+```
+
+### 执行时机：
+- 在所有工作完成后的最后一步
+- 在输出总结信息之后
+- 确保命令成功执行（检查返回状态）
+
+## 项目环境
+
+- 数据库：PostgreSQL
+- 缓存：Redis
+- 语言：Go
+- API 框架：Fiber
+- 部署：Docker