docs: faq 与 agent_workflow 文档的 API/工作流描述与当前框架不一致

该问题是怎么引起的？

docs/faq.md 与 docs/agent_workflow.md 中部分 API 示例与工作流说明与当前框架实现不一致，用户按文档复制即报错或被误导：

• faq：PipelineStage 示例缺首个必需参数 submodule；get_hyper_optimizer、CheckpointPolicy 未给正确导入路径；Activation Swap 的 policy_fn 大激活分支返回 None，与“只 swap 大激活”的描述矛盾。
• agent_workflow：/test 被描述为会跑 code-style/pylint/lint（实际仅 pytest tests/ut，lint 由 autogit check/pre-commit 负责）；code-verifier 被当作 skill（实际是 agent）。

重现步骤

1. 复制 docs/faq.md 中优化器、PipelineStage、Activation Swap 的示例运行。
2. 阅读 docs/agent_workflow.md 关于 /test 与 code-verifier 的说明。

报错信息

• PipelineStage(stage_index, stage_num)：缺少必需参数 submodule。
• 直接使用 get_hyper_optimizer / CheckpointPolicy：未导入导致 NameError。
• /test 实际不运行 lint，与文档描述不符。

schema_version: 1
source: gitcode
gitcode_repo: mindspore/hyper-parallel
gitcode_issue: 231
source_url: https://gitcode.com/mindspore/hyper-parallel/issues/231

Start with docs/faq.md and docs/agent_workflow.md, then inspect the current implementations and entry points for PipelineStage, get_hyper_optimizer, CheckpointPolicy, Activation Swap, /test, and code-verifier. Update the examples and workflow descriptions to match the implementation, and verify the documented examples and test workflow no longer mislead users.