القائمة
为 ASCO 模块编写单元测试与中文文档。用于新增模块、补齐测试覆盖、补写 API/模块说明、整理行为语义说明。重点产出 tests 下的用例与 docs/zh-cn/src 下的专业文档，文档只描述语义、约束和可观察行为，不描述实现细节。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
为 ASCO 仓库清理头文件依赖与 include 顺序。用于删除多余 include、补齐缺失的直接依赖，并按项目既有顺序规范整理 include 块；未指定范围时默认处理用户当前打开的 C++ 源文件，默认只做局部诊断，不主动构建或跑测试。
为 ASCO 仓库做代码审查。用于三种模式：全量 review、排除当前未提交修改的全量 review、review 当前未提交修改（包含未追踪文件）。如果用户没有明确指出模式，则默认 review 当前未提交修改。重点输出 bug、风险、行为回归和缺失测试。
为 ASCO 项目进行配置、构建和测试。用于本仓库的本地开发构建流程、测试执行、构建失败排查、以及新增测试后的接入检查。优先使用 VS Code 的 CMake Tools 扩展；只有用户明确说明不使用该扩展时，才回退到终端命令。
| name | asco-test-doc |
| description | 为 ASCO 模块编写单元测试与中文文档。用于新增模块、补齐测试覆盖、补写 API/模块说明、整理行为语义说明。重点产出 tests 下的用例与 docs/zh-cn/src 下的专业文档，文档只描述语义、约束和可观察行为，不描述实现细节。 |
| argument-hint | 说明目标模块、需要覆盖的公开接口、是否已有实现，以及文档目标页或章节 |
tests/CMakeLists.txt 以纳入统一 tests 目标。docs/zh-cn/src/ 下的合适位置；默认不产出英文文档。docs/zh-cn/src/SUMMARY.md 与对应章节 README.md 的导航入口。开始前先确认这些信息；若缺失，先向用户追问：
先阅读目标模块及其相邻测试、文档，整理以下内容：
如果无法只凭现有代码判断公开语义，暂停并向用户确认，不要擅自把内部实现推断写进文档。
围绕“可观察行为”列出测试点，优先覆盖：
测试命名应直接对应行为，不要用含糊名称。
遵循当前仓库的测试习惯：
ASCO_TEST(...) 定义用例。ASCO_CHECK(...) 断言，并让错误信息直接说明预期与实际。yield 轮询，不依赖无边界阻塞。决策规则：
tests/CMakeLists.txt。文档只描述语义、约束和行为，不描述实现过程、内部数据结构或优化策略。
写作要求：
避免写入以下内容：
新增文档页面时检查：
docs/zh-cn/src/SUMMARY.md 是否已加入入口。README.md 是否需要补充链接。若本次只更新已有页面，不要无意义调整其他导航结构。
提交前逐项检查：
tests/CMakeLists.txt。满足以下条件才算完成：
如果用户没有说明，不应将以下内容作为完成标准：
asco/sync/mutex.h 补齐测试和中文文档，只描述语义和行为，不解释实现。