阅读材料: 附录 B. Qwen Code 兼容性

模块「附录 B. Qwen Code 兼容性」中第 1 / 5 节课

您正在未登录状态下查看课程。请登录，以保存进度并参加测试。

来源

附录 B. Qwen Code 兼容性

第二卷描述了围绕 Qwen Code 的生产流程。其中部分流程已内置于 Qwen Code，另一部分则需要在项目中以自定义命令、技能（skills）、钩子（hooks）、MCP 服务器或普通脚本的形式实现。本附录明确了这一边界，以便读者不会将所设计的流程误认为是标准 CLI 命令。

规范成熟度等级

第二卷使用三个成熟度等级。这不是对想法质量的评估，而是对读者期望的边界设定。

等级	含义	实现层级
标准（Standard）	可在普通 Qwen Code 中直接复现，无需额外平台。这是课程的基础内容。	Qwen Code 内置功能
建议（Recommendation）	如果流程重复出现，建议在项目中进行封装。需要仓库文件：自定义命令、技能、钩子或脚本。	自定义命令、项目脚本
前沿（Frontier）	围绕 Qwen Code 的生产编排。仅适用于实际接入外部 API、SRE 流程和模型预算管理的团队。	外部编排器、MCP、外部服务

与四个层级的对应关系如下：Qwen Code 内置功能属于标准；自定义命令和项目脚本属于建议；外部编排器属于前沿。如果示例中使用了 Kubernetes、Grafana、PagerDuty 或独立的文件仲裁执行器，这属于教学模型的前沿层级，而非完成本卷的强制要求。

Qwen Code 内置层级

以下功能可直接使用：

/plan — 规划模式，不执行编辑和 shell 操作。
/review — 内置代码审查，具有确定性检查和并行审查代理。
/skills — 查看和显式运行技能。
/memory、/remember、/forget — 内存管理和 QWEN.md（/dream 作为显式整合命令可能在后续版本中出现；如果您的版本没有该命令，请将整合封装为自定义命令）。
/mcp 和 qwen mcp add — 连接 MCP 服务器。
@path — 将文件或目录添加到上下文。
!command — 交互式会话中的 shell 命令。
qwen -p "..." — 无头（headless）模式，用于 CI、批量检查和脚本。

自定义命令

如果您需要 /specify、/tasks、/validate、/constitution 或类似命令，请显式创建它们：

.qwen/
  commands/
    sdd/
      specify.md
      tasks.md
      validate.md
      constitution.md

然后命令将以 /sdd:specify、/sdd:tasks、/sdd:validate、/sdd:constitution 的形式调用。Markdown 文件中存储包含 {{args}}、指向 @specs/... 的链接以及停止规则的提示词。

/clarify 同样以此方式封装：在第一卷中，该命令用作规划前的需求澄清步骤，但它并非 Qwen Code 内置命令。在第二卷中，针对相同场景请创建项目自定义命令（例如 .qwen/commands/sdd/clarify.md），以 /sdd:clarify 的形式调用。行为和停止契约应在提示词中明确规定，以便第一卷中的 /clarify 步骤能够在无隐式假设的情况下复现。

项目脚本

需要无需模型即可复现的检查，请封装为普通脚本：

scripts/
  spec_ci/
    check_coverage.py
    validate_schema.py
  stress_mutator/
    mutate_specs.py
    fake_validator.py
    immunity_score.py
  tribunal/
    run_duel.py
    check_invariants.py

write_judgment.py
  budget/
    compile.py
    simulate.py
    inspect.py

Qwen Code 可以帮助编写和运行这些脚本，但绿色状态应取决于检查代码本身，而非模型回答的说服力。

钩子

对于防护栏（guardrails），请使用 Qwen Code 官方事件：PreToolUse、PostToolUse、UserPromptSubmit、SessionStart、Stop、SubagentStop、Notification、PreCompact 等。在第二卷正文中请使用这些确切名称，而非 pretooluse 等自由变体。确切的事件列表和配置格式请查阅 Qwen Code 最新文档（见附录末尾链接）。

MCP 和外部 API

生产 API 不应成为无限制的 shell 命令。对于 Grafana、PagerDuty、Kubernetes、Jira 或内部 API，最好创建带有工具许可清单（allowlist）的 MCP 服务器：

仅用于分类和检查的只读权限；
单独的安全操作写入工具；

明确的确认和回滚条件；
禁止在提示词、跟踪记录和 QWEN.md 中传递密钥。

第二卷术语

章节中的术语	Qwen 项目中的实现

参考链接

应用卷 README 仅保留为简短路线图，因此外部来源在此汇总。

Qwen Code commands: https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/
Qwen Code headless mode: https://qwenlm.github.io/qwen-code-docs/en/users/features/headless/

Qwen Code hooks: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks/
Qwen Code skills: https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/
Qwen Code memory: https://qwenlm.github.io/qwen-code-docs/en/users/features/memory/
Qwen Code MCP: https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/
Qwen Code approval mode: https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode/
Qwen Code code review: https://qwenlm.github.io/qwen-code-docs/en/users/features/code-review/
GitHub Spec Kit: https://github.com/github/spec-kit
AWS Kiro documentation overview: https://aws.amazon.com/documentation-overview/kiro/
OWASP Top 10 for LLM Applications: https://owasp.org/www-project-top-10-for-large-language-model-applications/
Google SRE book: https://sre.google/sre-book/
Goodhart's law: https://en.wikipedia.org/wiki/Goodhart%27s_law