asco-build

name	asco-build
description	为 ASCO 项目进行配置、构建和测试。用于本仓库的本地开发构建流程、测试执行、构建失败排查、以及新增测试后的接入检查。优先使用 VS Code 的 CMake Tools 扩展；只有用户明确说明不使用该扩展时，才回退到终端命令。
argument-hint	说明要做配置、构建、测试中的哪些步骤，是否使用 VS Code CMake Tools 扩展，以及是否需要实际执行命令

配置、构建和测试 ASCO 项目

何时使用

• 需要为本项目配置本地构建环境。
• 需要构建当前仓库或排查构建失败。
• 需要运行测试，或确认新增测试是否已正确接入。
• 需要回答“本项目应如何在本地配置、构建、测试”。

目标产出

• 一套与当前仓库一致的配置、构建和测试步骤。
• 在用户要求实际执行时，完成对应的配置、构建或测试动作。
• 在用户没有要求执行时，只给出准确步骤和决策建议，不主动运行命令。
• 若本次改动新增了测试文件，确认 tests/CMakeLists.txt 已同步更新。

输入信息

开始前先确认这些信息；若对当前任务有影响但信息缺失，先向用户确认：

• 用户是要“解释流程”，还是要“实际执行配置、构建、测试”。
• 用户是否使用 VS Code 的 CMake Tools 扩展。
• 本次只需要配置、只需要构建、只需要测试，还是需要完整流程。
• 是否新增了测试源文件。

决策规则

1. 先判断是否实际执行

• 如果用户是在问流程、约定或排查思路，只说明步骤，不主动运行配置、构建或测试。
• 如果用户明确要求执行配置、构建或测试，再进入执行阶段。

2. 优先使用 VS Code 的 CMake Tools 扩展

• 对于本地开发，默认优先使用 VS Code 的 CMake Tools 扩展进行配置、构建和测试。
• 如果用户明确说明自己不使用 CMake Tools 扩展，才改用终端命令。
• 不要把终端命令当成默认首选方案；它是明确的回退路径。

3. 配置、构建和测试是三个独立步骤

• 配置：确保从仓库根目录生成或更新 build/ 下的构建目录。
• 构建：编译当前仓库，不修改 build/ 下的生成文件。
• 测试：运行当前仓库注册的 tests CTest 目标，或用户明确指定的测试范围。

执行流程

1. 读取当前约定

先以这些项目事实为准：

• 本项目要求 C++23。
• 当前仓库使用 CMake，测试通过 CTest 运行。
• 当前只注册了一个名为 tests 的 CTest 目标。
• 新增测试文件时，通常需要同步更新 tests/CMakeLists.txt。
• 不要手工编辑 build/ 下的生成文件。

2. 使用 CMake Tools 扩展时

• 优先通过 VS Code 的 CMake Tools 扩展执行 configure、build 和 test。
• 如果用户只要求其中一步，只执行对应一步，不隐式补跑其他高成本步骤。
• 如果用户要求排查构建或测试失败，先读取失败信息，再基于报错定位源码或配置问题。

3. 用户明确不使用 CMake Tools 扩展时

使用终端命令时遵循当前仓库推荐流程：

cmake -B build -G Ninja
cmake --build build
ctest --test-dir build --output-on-failure

执行规则：

• 配置只需要运行第一条命令。
• 构建需要在已配置的前提下运行第二条命令。
• 测试需要在已有可用构建产物的前提下运行第三条命令。
• 若用户只要求测试，不要无条件先重配或全量重建，除非当前状态已不足以运行测试。

4. 新增测试时的额外检查

如果这次改动新增了测试源文件，结束前必须检查：

• 新文件是否已加入 tests/CMakeLists.txt。
• 测试是否仍归入统一的 tests 目标。
• 若用户还新增了文档，不要忘记对应文档导航维护，但这不属于本 skill 的核心产出。

5. 失败时的处理顺序

• 先区分失败发生在配置、构建还是测试阶段。
• 优先根据错误输出定位到具体文件、目标或缺失接入项。
• 如果失败与 asco/core、并发、取消、生命周期或资源释放路径相关，必须提醒用户不要盲目相信生成的修改，并由用户自行核对语义、边界条件和失败路径。
• 不要顺手修 unrelated 的错误；只处理与当前任务直接相关的问题。

完成标准

满足以下条件才算完成：

• 给出的流程与当前仓库约定一致。
• 本地开发场景下，把 VS Code 的 CMake Tools 扩展作为默认推荐方案。
• 只有在用户明确说明不使用 CMake Tools 扩展时，才给出或执行终端配置与构建命令。
• 若涉及新增测试文件，已检查 tests/CMakeLists.txt 的接入。
• 已明确提醒用户不要盲目相信修改结果，尤其是运行时语义相关改动。

常见分支

用户只问“怎么做”

• 提供步骤和注意事项。
• 不主动执行配置、构建或测试。

用户要求“帮我构建/跑测试”

• 直接执行用户要求的步骤。
• 优先走 VS Code 的 CMake Tools 扩展流程。

用户新增了测试但测试没跑到

• 先检查 tests/CMakeLists.txt 是否遗漏新文件。
• 再检查测试代码是否正确注册进统一 tests 可执行文件。

用户说自己不用 CMake Tools 扩展

• 直接切换到终端命令流程。
• 默认使用 cmake -B build -G Ninja、cmake --build build、ctest --test-dir build --output-on-failure。

推荐提示词

• 为这个仓库配置并构建项目，优先使用 VS Code 的 CMake Tools 扩展。
• 我不用 CMake Tools 扩展，告诉我这个仓库如何在终端里配置、构建和测试。
• 帮我检查新加的测试为什么没有被当前仓库的 tests 目标跑到。
• 只告诉我本项目的本地构建与测试流程，不要实际执行命令。