华为云使用中遇到报错或体验差时…

当用户在使用华为云工具/服务时遇到错误、被拒绝的请求或想反馈建议时，用脚本采集、脱敏、去重并投递为 GitCode Issue。

适用场景

解决思路

1. 所有脚本执行都必须用 `skill-quality-cli run --skill-name huawei-cloud-vod-collector -- ` 包裹（例如 `skill-quality-cli run --skill-name huawei-cloud-vod-collector -- python <SKILL_DIR>/scripts/md_io.py write-feedback ...`），禁止裸跑 python/md_io.py/vod_sanitize.py/vod_deliver.py/vod_install.*/curl；唯一例外是安装器 ensure_cli.sh / install_cli.sh 在 CLI 尚未安装时可裸跑。
2. 先安装 Python 依赖：`pip install -r <SKILL_DIR>/requirements.txt`；若缺少 skill-quality-cli，运行 `bash <SKILL_DIR>/scripts/ensure_cli.sh`（幂等，已存在则跳过），升级用 `skill-quality-cli upgrade`，关闭遥测用 `SKILL_QUALITY_REPORT=0`。
3. 采集原始反馈：`skill-quality-cli run --skill-name huawei-cloud-vod-collector -- python <SKILL_DIR>/scripts/md_io.py write-feedback --output .vod/feedbacks/`（write-feedback 会自动脱敏密钥）；如需手动脱敏已有文件：`... python <SKILL_DIR>/scripts/vod_sanitize.py file --path <file>`。
4. 会话内去重：写入时若同一 `session_id + command + error_type` 落在 `capture.dedup_window_sec` 窗口内，则递增 `recurrence_count` 而不新建文件；跨会话去重：投递前用 LLM 扫描最近 10 条反馈查重。
5. Phase 2 由 Agent（LLM）直接完成，无独立脚本；用 `write-feedback` 更新字段或直接编辑 markdown 文件，字段与章节对应：`error_stack`→`## Error Information → error_stack`（从错误上下文提取 traceback/退出码）；`user_intent`→`## Context → user_intent`（用户想做什么，而非怎么做）；`scenario`→`## User Report → scenario`（还原用户当时在做什么）；`expected_behavior`→`## User Report → expected_behavior`（显式则取对话，否则从错误推断）；`product_name`→标题前缀 `【Product】`（优先级：annotation > agent_action > error_message）；`environment`→`## Context → environment`（平台、OS、session ID、Python 版本）；`dialog_context`→`## Context → dialog_context`（问题点前后 3-5 个关键轮次，保留原语言）。
6. 投递单条反馈为 GitCode Issue：`skill-quality-cli run --skill-name huawei-cloud-vod-collector -- python <SKILL_DIR>/scripts/vod_deliver.py deliver --feedback-id <id> --feedbacks-dir .vod/feedbacks`；投递后更新状态：`... vod_deliver.py update-status --feedback-id <id> --status delivered --feedbacks-dir .vod/feedbacks`。
7. `repo_url` 只能从 `assets/config.yaml` 的 `delivery.channels.gitcode.repo_url` 读取，绝不能用 `git remote`，也不要问用户。
8. 当 `deliver` 返回 `"need_login": true` 时先走 MCP 捷径：检查 `devspace-connector` MCP server 是否暴露 `gitcode_create_issue`（或 `create_issue`）工具，若存在且可调用则直接用它建 issue（deliver 响应会带 `repo_url`、`issue_title`、`issue_body`），建完后执行 `update-status --status delivered`，跳过二维码登录步骤。
9. 若 MCP connector 因任何原因不可用（未连接、未配置、工具缺失或调用失败），直接静默回退到二维码登录流程，不要询问用户是否连接 MCP，也不要提供“启用/连接 connector”的选项。
10. 二维码登录前必须先告知用户：登录使用开源项目 AtomGit-GO（MIT 许可），源码 https://gitcode.com/weixin_45218422/AtomGit-GO。
11. 登录步骤 1：检查并安装——`skill-quality-cli run --skill-name huawei-cloud-vod-collector -- bash <SKILL_DIR>/scripts/vod_install.sh`（Linux/macOS）或 `... powershell <SKILL_DIR>/scripts/vod_install.ps1`（Windows）。
12. 步骤 2：启动服务——`... python <SKILL_DIR>/scripts/vod_deliver.py server-start`，从 JSON 输出取 `pid`。
13. 步骤 3：发起扫码登录——`... curl -s -X POST http://localhost:8080/login/start`，从 JSON 取 `login_url`、`qr_code`、`session_id`。
14. 步骤 4：向用户展示 `login_url` 和 ASCII `qr_code`，并说明“🔐 首次登录需要 AtomGit 授权，请扫码或在浏览器打开该 URL”。
15. 步骤 5：等待授权——`... python <SKILL_DIR>/scripts/vod_deliver.py login-wait --session-id <session_id>`，阻塞至扫码完成（最长 60s），不要问用户是否已扫码，直接等待。
16. 步骤 6：收到 `SCAN_SUCCESS` 后进入步骤 7，并必须输出安全提示：AtomGit-GO 登录流程仅把 token 持久化到 `${ATOMCODE_HOME:-$HOME/.atomcode}/auth.toml`（仅属主可读，mode 0600），任何能访问该文件的人都能冒充你，请勿分享；仅存于本地 AI Shell 环境，不会上传到任何外部服务器；可手动删除该文件，或在环境资源回收时被清理。
17. 步骤 7：停止服务——`... python <SKILL_DIR>/scripts/vod_deliver.py server-stop --pid <pid>`。
18. 步骤 8：重新执行原来的 `deliver` 命令。
19. 行为约束：取消时只清理当前文件，绝不删除 `.vod/` 或其他记录；拒绝时静默跳过，不抑制未来触发；只接受产品/服务类问题，拒绝空内容或极简内容（如 "test"、"hello"）；每会话最多 `storage.max_feedbacks_per_session`（默认 5）条，超出则告知用户；更新只能原地进行，ID 不可变，状态机为 `open → delivered → promoted → resolved` 或 `open → delivered → discarded`（`delivered` 由 `update-status --status delivered` 写入）；`.vod/` 首次使用时自动创建，绝不覆盖。
20. 存储路径为 `<CWD>/.vod/feedbacks/`，文件格式为 `VOD-YYYYMMDD-NNNN.md`。
21. 可配置参数：`--feedbacks-dir` / `--output`（反馈存储目录，默认 `.vod/feedbacks/`，write-feedback 用 `--output`，vod_deliver.py 用 `--feedbacks-dir`）；`--atomgit-home` / `ATOMCODE_HOME`（AtomGit-GO 配置目录，默认 `~/.atomcode`）；`delivery.channels.gitcode.repo_url`（仅从 `assets/config.yaml` 读取）；`capture.dedup_window_sec`（会话内去重窗口秒数）；`storage.max_feedbacks_per_session`（默认 5）；脚本内可选日志/调试开关。
22. KooCLI 调用接受全局参数 `--cli-region=<region>`（如 `hcloud ECS ListServers --cli-region=cn-north-4`）；本技能所有 `hcloud` 调用都经 `scripts/hcloud-run.sh`，当设置了 `HW_CLI_REGION` 且命令未自带该参数时会自动注入 `--cli-region`。
23. Token 来自开源 AtomGit-GO，明文保存到 `~/.atomcode/auth.toml`（mode 0600）；GitCode API v5 要求把 `access_token` 作为 URL 查询参数，可能出现在代理/负载均衡/服务器日志中（错误响应已脱敏，正常请求 URL 未脱敏，这是 GitCode API 的限制）；可用 `--atomgit-home <path>` 覆盖；缺失或过期时脚本返回 `"need_login": true`，按 Phase 3.1 自动登录处理；绝不把 token 写到 `~/.atomcode/auth.toml` 以外的任何文件。

适用边界 · 注意事项

• 非华为云相关的问题或反馈（本技能只处理华为云工具/服务的问题）。
• 空内容或极简内容（如 "test"、"hello"）的反馈，以及非产品/服务类问题。
• 同一会话内反馈数已超过 `storage.max_feedbacks_per_session`（默认 5）时，需先告知用户而非继续写入。