- 本目录是活动前期准备的独立工作目录。只在本目录内修改项目文件。
- 本 workspace 位于
QiYuan/workspace/，采用MustRead/（核心必读与视觉图解）、Example/（三套独立技能示例与通用模板）、Tools/（工具包、一键构建脚本、仿真测试与运行环境）、Doc/（规则文档与报告）及根目录说明的清晰结构。父目录..中 workspace 以外的原有文件只读；不要改动、清理、重命名、回退它们。 - 本 workspace 中的文档、dev kit、技能源码和产物均是实际副本；不得改成指向原目录的符号链接、junction、硬链接或 Git worktree。
- 使用
Tools/.venv/Scripts/python.exe。构建与测试从本目录执行；详细流程见MustRead/01_从零开发Q1_T1技能_SOP.md与Doc/04_赛前准备状态与命令说明.md。 Doc/01_活动说明_实操任务.md、MustRead/02_机器人运行时契约与避坑必读.md和Tools/primehub_dev_kit/SKILL_PUBLISH_GUIDE.md是活动与运行时契约的依据，主代理亲自阅读。- 技能仅用 Python 3.10 标准库和运行时注入的
robot；不导入robot、rclpy 或 ROS2。 - 未经真机验收不得将离线测试描述为真机跑通。发布前按准备说明完成机型、动作、播音、两轮运行及安全验收。
- 发布凭证默认在本 workspace 的
.local/ph_token.txt，不打印或提交真实凭证。extract_token.py现支持 Chrome / Edge / Brave / Chromium / Firefox 自动提取及--token传入，浏览器账号登录仍由本人完成。 - 遵循会话中用户提供的子代理及 PowerShell 编辑安全要求；子代理只读，主代理负责修改和最终验证。
AI AGENT RULES · 赛博紧箍咒
Workspace 范围
给 Claude Code / Cursor / Codex 等 AI 助手划定的安全结界与规矩
😜 调皮课代表大白话划重点（30 秒读懂核心）
想让 AI 帮你写代码又怕它胡来？这页就是给 AI 戴上的「防呆紧箍咒」：只准在工作台内折腾、只准用 Python 3.10 标准库和老管家注入的全局
robot、绝不许写 import robot/rclpy、绝不许把电脑离线模拟吹牛说成真机跑通，登录凭证更是半个字都不许往外漏！