init for mcpp

Author: Sunrisepeak

.agents/skills/README.md

@@ -1,11 +1,12 @@
-# mcpp-style-ref Agent Skills
+# mcpplibs template Agent Skills
 
-用于指导 Agent 在编写或审查 Modern/Module C++ 代码时遵循 mcpp-style-ref 规范的技能。
+用于指导 Agent 理解 mcpp/mcpplibs 模块库模板、查找外部资料，并在编写或审查 Modern/Module C++ 代码时遵循 mcpp-style-ref 规范。
 
 ## 可用技能
 
 | 技能 | 说明 |
 |------|------|
+| [more-details](more-details/SKILL.md) | mcpp、mcpplibs、包索引、依赖案例、xlings 等资料入口和任务指引 |
 | [mcpp-style-ref](mcpp-style-ref/SKILL.md) | 面向 mcpp 项目的 Modern/Module C++ (C++23) 命名、模块化与实践规则 |
 
 ## 使用方式
@@ -14,11 +15,13 @@
 
 ```bash
 mkdir -p .cursor/skills
+ln -s ../../skills/more-details .cursor/skills/more-details
 ln -s ../../skills/mcpp-style-ref .cursor/skills/mcpp-style-ref
 ```
 
 或安装为个人技能：
 
 ```bash
+ln -s /path/to/mcpp-template/.agents/skills/more-details ~/.cursor/skills/more-details
 ln -s /path/to/mcpp-style-ref/skills/mcpp-style-ref ~/.cursor/skills/mcpp-style-ref
 ```

.agents/skills/mcpp-style-ref/SKILL.md

@@ -119,7 +119,7 @@ void Error::test() {
 
 ## 项目环境配置
 
-安装 xlings 包管理器后，获取 GCC 15 工具链：
+安装 xlings 包管理器后，安装本模板固定的 mcpp 工具：
 
 #### Linux/MacOS
 
@@ -133,10 +133,12 @@ curl -fsSL https://raw.githubusercontent.com/d2learn/xlings/refs/heads/main/tool
 irm https://raw.githubusercontent.com/d2learn/xlings/refs/heads/main/tools/other/quick_install.ps1 | iex
 ```
 
-然后安装工具链(仅linux, 其中windows默认用msvc)：
+然后安装本模板固定的项目工具：
 
 ```bash
-xlings install gcc@15 -y
+xlings install
+export PATH="$PWD/.xlings/subos/_/bin:$PATH"
+mcpp --version  # mcpp 0.0.28
 ```
 
 > xlings详细信息可参考 [xlings](https://github.com/d2learn/xlings) 文档。
@@ -145,15 +147,18 @@ xlings install gcc@15 -y
 
 参考本仓库 `src/` 目录结构：
 
-- `xmake.lua`：配置 `set_languages("c++23")`、`set_policy("build.c++.modules", true)`
-- `add_files("main.cpp")`、`add_files("**.cppm")` 添加源文件
-- 可执行目标与静态库目标分离（如 `mcpp-style-ref` 主程序、`error` 静态库）
+- `.xlings.json`：固定项目工具环境，当前固定 `mcpp 0.0.28`
+- `mcpp.toml`：声明 `[package]` 与测试依赖；简单库目标可由 mcpp 从 `src/*.cppm` 自动推断
+- `src/mylib.cppm`：库主模块接口，默认 `export module mcpplibs.mylib;`
+- `tests/mylib_test.cpp`：`mcpp test` 自动发现的 gtest 测试；不要定义 `main()`
+- `examples/basic/`：独立 mcpp consumer 包，通过 path 依赖引用根库
 
 构建：
 
 ```bash
-xmake build
-xmake run
+mcpp build
+mcpp test
+cd examples/basic && mcpp run
 ```
 
 ## 适用场景

.agents/skills/more-details/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: more-details
+description: 为 mcpp/mcpplibs 模块库开发提供资料导航。适用于 Agent 需要了解 mcpp 工具、mcpp.toml、包索引、mcpplibs 生态、依赖案例、xlings 工具环境、或寻找更多外部资料链接时。
+---
+
+# more-details
+
+这是 mcpp/mcpplibs 模块库开发的资料入口 skill。它只负责引导 Agent 去哪里查资料；具体实现仍以本仓库文件、mcpp 官方文档和实际命令输出为准。
+
+## 使用原则
+
+- 先看本仓库入口，再跳外部资料。
+- 只读取当前任务需要的文档，不要一次性展开所有链接。
+- 涉及工具行为、包版本、索引内容时，以当前仓库文件和外部源的最新内容为准。
+- 写 C++23 模块代码时，同时使用 `mcpp-style-ref`。
+
+## 本仓库入口
+
+- `README.md`：模板使用入口、AI Agent 提示词、外部资源链接。
+- `docs/architecture.md`：项目结构、mcpp 约定、依赖添加方式。
+- `.xlings.json`：固定项目工具环境，当前固定 `mcpp 0.0.28`。
+- `mcpp.toml`：包信息、依赖和测试依赖。
+- `src/mylib.cppm`：库模块接口示例。
+- `tests/mylib_test.cpp`：符合 mcpp 规范的 gtest 测试示例。
+- `examples/basic/`：独立使用方示例。
+
+## 外部资源
+
+### mcpp 工具
+
+- mcpp 仓库：https://github.com/mcpp-community/mcpp
+- mcpp 文档：https://github.com/mcpp-community/mcpp/tree/main/docs
+- 快速开始：https://github.com/mcpp-community/mcpp/blob/main/docs/00-getting-started.md
+- 示例文档：https://github.com/mcpp-community/mcpp/blob/main/docs/01-examples.md
+- `mcpp.toml` 指南：https://github.com/mcpp-community/mcpp/blob/main/docs/05-mcpp-toml.md
+
+优先用这些资料确认：
+
+- `mcpp build`、`mcpp test`、`mcpp run` 的行为。
+- `src/*.cppm`、`src/main.cpp`、`tests/**/*.cpp` 的默认推断规则。
+- `[dependencies]`、`[dependencies.<namespace>]`、`[dev-dependencies]` 和目标覆盖配置。
+
+### 包索引与生态
+
+- mcpp 包索引：https://github.com/mcpp-community/mcpp-index
+- mcpplibs 组织：https://github.com/mcpplibs
+- 依赖库参考案例：https://github.com/mcpplibs/cmdline
+
+添加依赖时优先检查包索引；需要看真实库写法时参考 `mcpplibs/cmdline`。默认直接 `import <module>;`，不要在主模块里默认 `export import` 依赖。
+
+### 编码风格
+
+- mcpp-style-ref 仓库：https://github.com/mcpp-community/mcpp-style-ref
+- 本仓库风格 skill：`.agents/skills/mcpp-style-ref/SKILL.md`
+
+写或改 `.cppm` / `.cpp` 文件时，遵循 C++23 模块风格：`import std`、模块名稳定、公开 API 简洁、测试不写自定义 `main()`。
+
+### 工具环境
+
+- xlings：https://github.com/d2learn/xlings
+
+本模板通过 `.xlings.json` 固定 mcpp 版本。进入仓库后通常使用：
+
+```bash
+xlings install
+export PATH="$PWD/.xlings/subos/_/bin:$PATH"
+mcpp --version
+```
+
+## 常见任务指引
+
+- **了解模板结构**：读 `README.md` 和 `docs/architecture.md`。
+- **确认 mcpp 配置写法**：读 `mcpp.toml` 和 mcpp 的 `05-mcpp-toml.md`。
+- **新增依赖**：查 `mcpp-index`，再参考 `mcpplibs/cmdline`。
+- **新增模块 API**：读 `mcpp-style-ref`，再改 `src/*.cppm`。
+- **新增测试**：参考 `tests/mylib_test.cpp`，用 `mcpp test` 验证。
+- **新增示例**：参考 `examples/basic/`，用独立 `mcpp.toml` 和 path 依赖。

.github/workflows/ci.yml

@@ -15,82 +15,37 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  build-linux:
+  mcpp:
     runs-on: ubuntu-latest
-    timeout-minutes: 20
+    timeout-minutes: 30
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Setup xmake
-        uses: xmake-io/github-action-setup-xmake@v1
-        with:
-          xmake-version: latest
-          package-cache: true
-
-      - name: Install dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y build-essential
-
       - name: Install Xlings
         env:
           XLINGS_NON_INTERACTIVE: 1
         run: |
           curl -fsSL https://raw.githubusercontent.com/d2learn/xlings/refs/heads/main/tools/other/quick_install.sh | bash
-          echo "PATH=$HOME/.xlings/subos/current/bin:$PATH" >> "$GITHUB_ENV"
+          echo "$HOME/.xlings/subos/default/bin" >> "$GITHUB_PATH"
 
-      - name: Install GCC 15.1 with Xlings
+      - name: Install project tools
         run: |
-          xlings install gcc@15.1 -y
+          xlings install -y
+          echo "$GITHUB_WORKSPACE/.xlings/subos/_/bin" >> "$GITHUB_PATH"
 
-      - name: Build
+      - name: Verify mcpp version
         run: |
-          xmake f -m release -y -vv
-          xmake -y -vv -j$(nproc)
+          mcpp --version
+          mcpp --version | grep -q "mcpp 0.0.28"
 
-      - name: Test
-        run: xmake run templates_test
+      - name: Build library
+        run: mcpp build
 
-      - name: Run examples
-        run: xmake run basic
+      - name: Run tests
+        run: mcpp test
 
-  build-macos:
-    runs-on: macos-14
-    timeout-minutes: 20
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install dependencies
-        run: brew install xmake llvm@20
-
-      - name: Build
+      - name: Run example
         run: |
-          export PATH=/opt/homebrew/opt/llvm@20/bin:$PATH
-          xmake f --toolchain=llvm --sdk=/opt/homebrew/opt/llvm@20 -m release -y -vv
-          xmake -y -vv -j$(sysctl -n hw.ncpu)
-
-  build-windows:
-    runs-on: windows-latest
-    timeout-minutes: 20
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup xmake
-        uses: xmake-io/github-action-setup-xmake@v1
-        with:
-          xmake-version: latest
-          package-cache: true
-
-      - name: Build
-        run: |
-          xmake f -m release -y -vv
-          xmake -y -vv -j$env:NUMBER_OF_PROCESSORS
-
-      - name: Test
-        run: xmake run templates_test
-
-      - name: Run examples
-        run: xmake run basic
+          cd examples/basic
+          mcpp run