{"skill":{"slug":"zrise-connect-release","displayName":"Zrise Connect Release","summary":"Connect and operate Zrise tasks via XML-RPC API using Lobster workflows for approval-based task execution and result writeback.","description":"# zrise-connect - Zrise Integration Skill v3.3\n\n## 🎯 Purpose\n\nKết nối và vận hành Zrise qua XML-RPC API.\n\n## ⚠️ QUAN TRỌNG — Quy tắc xử lý task\n\nKhi được yêu cầu \"làm task\", agent **PHẢI** dùng Lobster workflow. **KHÔNG** tự:\n- Generate kết quả luôn\n- Post kết quả lên Zrise mà chưa được approve\n- Kéo stage Done mà chưa được approve\n- Gọi script riêng lẻ\n\n### 🔄 Flow chuẩn (bắt buộc qua Lobster)\n\n```\nlobster run skills/zrise-connect/workflows/zrise-execute.lobster \\\n  --args-json '{\"task_id\": 42349, \"user_message\": \"viết giới thiệu công ty\"}'\n```\n\n**Flow steps:**\n```\n1. Fetch task từ Zrise\n2. AI phân tích intent + lên plan\n3. Post plan lên Zrise\n4. Kéo stage → In Process\n⏸️  APPROVAL: Review plan\n   → lobster(action=\"resume\", token=..., approve=true)  # approve\n   → lobster(action=\"resume\", token=..., approve=false) # reject\n5. AI execute task theo plan\n⏸️  APPROVAL: Review kết quả\n   → lobster(action=\"resume\", token=..., approve=true)  # approve → auto writeback + timesheet + Done\n   → lobster(action=\"resume\", token=..., approve=false) # reject → cần revise thủ công\n6. (auto) Writeback kết quả lên Zrise\n7. (auto) Fill timesheet\n8. (auto) Stage → Done\n```\n\n### Khi revise sau reject:\n```bash\nlobster resume --token \"...\" --approve false\n```\n\n---\n\n## 📦 Scripts (chỉ dùng cho debug/manual)\n\n```bash\n# Fetch task data\npython3 scripts/fetch_task_data.py <task_id>\n\n# Update stage\npython3 scripts/update_task_stage.py <task_id> \"In Process\" --comment \"Bắt đầu\"\n\n# Post comment\necho \"nội dung\" | python3 scripts/writeback_to_zrise.py --task-id <id> --workflow general\n\n# Fill timesheet\npython3 scripts/fill_timesheet.py --task-id <id> --hours 0.5 --description \"mô tả\"\n\n# Poll pending tasks (cron)\npython3 scripts/poll_employee_work.py --employee-id <ID> --limit 10 --json\n```\n\n## ⚠️ Zrise XML-RPC Gotchas\n\n```python\n# write(): [id, {vals}]\nmodels.execute_kw(db, uid, pwd, 'model', 'write', [id, {'field': val}])\n\n# message_post(): [[id]], {kwargs}\nmodels.execute_kw(db, uid, pwd, 'model', 'message_post', [[id]], {'body': '...', 'message_type': 'comment'})\n\n# Timesheet TRƯỚC stage Done (Zrise bắt buộc)\n```\n\n## 🔧 Lobster Setup\n\n```bash\n# Cài lobster (nếu chưa có)\ncd /tmp && git clone https://github.com/openclaw/lobster.git && cd lobster && npm install && npx tsc -p tsconfig.json\nexport PATH=\"$HOME/bin:$PATH\"\nln -sf /tmp/lobster/bin/lobster.js ~/bin/lobster\nlobster version\n```\n\n## 🔑 Key Concepts\n\n- **Employee ID** = `hr.employee.id` (not user ID)\n- **Task assignment** = `project.task.user_ids` (Many2many to `res.users`)\n- All scripts use `zrise_utils.connect_zrise()` (SSL-safe)\n","tags":{"latest":"3.3.1"},"stats":{"comments":0,"downloads":443,"installsAllTime":17,"installsCurrent":0,"stars":1,"versions":1},"createdAt":1774254259089,"updatedAt":1779078833521},"latestVersion":{"version":"3.3.1","createdAt":1774254259089,"changelog":"zrise-connect-release 3.3.1\n\n- Updated documentation in SKILL.md with a mandatory workflow process for task handling via Lobster, emphasizing agent approval steps.\n- Clearly outlined steps for task processing, review, approval, revision, and automation.\n- Added instructions and usage examples for relevant debug/manual scripts.\n- Provided practical notes on Zrise XML-RPC API usage and integration specifics.\n- Included key setup guidance for the Lobster workflow tool and clarified essential Zrise data concepts.","license":"MIT-0"},"metadata":null,"owner":{"handle":"khoabd","userId":"s171ahnahss0z6wgcvzr1pw22h83gcyh","displayName":"Khoa","image":"https://avatars.githubusercontent.com/u/103617700?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090046609}}