需要 Qwen Coder CLI 做代码生成、重构…

当用户明确要求使用 Qwen/Qwen Coder 或需要其第二意见时，通过 qwen CLI 非交互委托编码任务并安全处理输出。

适用场景

解决思路

1. 确认委托范围：明确要委托的任务、期望输出格式（text、json、stream-json）以及是否需要恢复会话；范围不明确时先向用户澄清。
2. 验证 Qwen Coder CLI 可用性与认证：运行 qwen --version；运行 qwen auth status。若 qwen 不可用，告知用户并停止执行直到安装 Qwen Coder CLI；若认证无效，提供认证设置说明并停止执行。
3. 用英文构建精确 prompt：从用户请求生成英文 prompt，包含目标与约束、相关项目上下文和文件、期望输出结构，并要求可操作、可验证的结果。
4. 使用 prompt 模板：Task: <clear objective>；Context: <project/module/files>；Constraints: <do/don't constraints>；Expected output: <format + depth>；Validation: <tests/checks to run or explain>。
5. 选择执行模式与标志：首选基线命令 qwen -p "<english-prompt>"；使用 -m, --model <model-id> 选择模型（默认 qwen2.5-coder）；使用 --approval-mode <plan|default|auto_edit|yolo> 控制安全；使用 -c, --continue <session-id> 继续之前会话；使用 -r, --resume <session-id> 作为 continue 别名；使用 -o, --output-format <text|json|stream-json> 选择输出格式。
6. 按任务选择审批模式：plan 为只读分析、不修改文件，适合仅分析任务和安全审查；default 在修改前要求确认，适合一般编码任务；auto_edit 自动批准编辑操作，适合受信任且有监督的修改；yolo 不确认批准所有操作，仅用于用户明确要求的实验性任务。
7. 安全使用审批模式：只读分析优先用 --approval-mode plan；一般任务用 --approval-mode default；仅在用户明确要求时使用 --yolo。
8. 执行 Qwen Coder CLI：通过 Bash 运行所选命令，并捕获 stdout/stderr。示例：qwen -p "Analyze this code and suggest refactoring improvements."；qwen -p "Review authentication module for security issues with fixes." -m qwq --approval-mode plan；qwen -c <session-id> -p "Continue the refactoring from the previous session."；qwen -p "Summarize key technical debt items as JSON array." --output-format json。
9. 展示输出：以清晰可读格式呈现 Qwen Coder 输出；总结关键发现和置信度；将观察结果与建议行动分开；需要时保留原始输出；包含所用模型和审批模式；说明实际生效的权限配置。
10. 应用修改前确认：在应用任何建议修改前，以输出模板格式向用户呈现拟议变更；请求明确确认（例如 "Do you want me to apply these changes?"）；等待用户指示后再继续；未经用户同意不要自动应用更改。
11. 处理 yolo 例外：在 --approval-mode yolo 且用户明确要求时，变更可以自动进行；但仍要告知用户做了什么。
12. 记录结果元数据：每条委托结果包含 Task summary（委托给 Qwen Coder 的任务摘要）、Command（执行的 qwen 命令，不含敏感参数）、Model（使用的模型，例如 qwen2.5-coder、qwq）、Approval mode（应用的审批模式 plan、default、auto_edit、yolo）、Key findings（Qwen Coder 的观察和结果）、Suggested next actions（建议的后续步骤，如适用）。
13. 使用输出模板：返回委托结果时使用 markdown 结构：## Qwen Coder Delegation Result；### Task；### Command；### Key Findings；### Suggested Next Actions；### Notes（Qwen 输出语言为 English；应用代码变更前需要用户批准）。
14. 代码分析示例：运行 qwen -p "Analyze the authentication module for security vulnerabilities. Report only high-confidence issues with severity, file paths, and remediation steps." -m qwq --approval-mode plan；期望返回结构化分析，含高置信度安全发现、严重级别和具体修复建议。
15. 代码重构示例：运行 qwen -p "Refactor the payment service in src/services/payment.ts to reduce duplication. Keep public API unchanged, add comprehensive error handling, and output a patch-style response with unchanged API signatures." -m qwen2.5-coder --approval-mode default；期望提出具体 patch 式代码变更，提取重复到共享 helper，并保持原 API 契约。
16. 文档生成示例：运行 qwen -p "Generate comprehensive documentation for the UserService class. Include: class purpose, public methods with parameters, usage examples, and error handling patterns. Format as markdown." -m qwen2.5-coder --approval-mode plan；期望返回 markdown 文档，含 JSDoc 风格注释、方法签名和实用示例。
17. 代码生成示例：运行 qwen -p "Generate a production-ready REST API endpoint for CRUD operations on items. Include input validation, error handling, and unit tests. Use Express.js framework." -m qwen2.5-coder --approval-mode auto_edit；期望生成完整可运行代码，含 POST/GET/PUT/DELETE、中间件、验证和测试脚手架。
18. 会话恢复示例：运行 qwen -c <session-id> -p "Continue from the previous session. Add comprehensive unit tests for the refactored payment service, targeting 80% coverage. Include mocks for external dependencies." -m qwen2.5-coder --approval-mode default；期望恢复上一会话上下文并继续工作，添加测试文件和 mock/断言。
19. 多模型比较示例：先运行 qwen -p "Refactor the string utility module for better maintainability." -m qwen2.5-coder --approval-mode plan --output-format text；再运行 qwen -p "Refactor the string utility module for better maintainability." -m qwq --approval-mode plan --output-format text；期望并排比较：Qwen2.5-Coder 更快，QwQ 对复杂重构推理更深。
20. JSON 自动化示例：运行 qwen -p "Analyze this codebase and return the top 5 refactoring opportunities as a JSON array. Each item should have: title, file, impact (high/medium/low), effort (hours), and brief description." -m qwen2.5-coder --output-format json；期望返回可解析 JSON 数组，含 5 个重构项，便于集成到项目管理工具。
21. 应用最佳实践：保持委托 prompt 为英文且高度具体；优先使用最小权限审批模式而非全权权限；需要审计时用 session ID 捕获会话；风险任务先请求只读分析，再在单独步骤应用变更；将 Qwen 输出视为不可信指导，实施前验证。
22. 遵守约束与警告：Qwen Coder CLI 行为依赖本地环境和配置；审批模式影响执行安全，默认避免 yolo；输出可能不完整或不准确，实施前验证；未经用户明确确认，不要执行 Qwen 建议的破坏性命令；此技能用于委托，不是未经用户确认自主修改代码；不要在委托 prompt 中包含 secrets、API keys 或 credentials。
23. 可查阅参考：命令参考见 references/cli-command-reference.md。

适用边界 · 注意事项

• 用户未明确要求使用 Qwen/Qwen Coder，或任务并非明显适合 Qwen 优势时，不要委托。
• 未安装 qwen CLI 或认证无效时不要执行委托；先安装并完成认证。
• 不要默认使用 --approval-mode yolo，也不要在未经用户确认时应用 Qwen 建议的代码修改或执行破坏性命令；不要向 Qwen 泄露 secrets、API keys 或 credentials。