@chengzhao-dev/dsh-cpp-workflow 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@chengzhao-dev/dsh-cpp-workflow",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "C++20 工程流程技能包：源码四步与构建三步，按项目声明的环境组合校验 · C++20 workflow skills for DeepSeek Harness",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "lib",
+    "skills",
+    "cordis.patch.yml",
+    "locale",
+    "icon.svg",
+    "README.md",
+    "README.en.md",
+    "LICENSE",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.0-rc.1 <0.3.0-0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "catalog": {
+      "category": "skill",
+      "summary": {
+        "zh": "按项目声明的环境组合，推进 C++20 源码与构建流程",
+        "en": "Advance C++20 source and build work with a project-declared environment"
+      },
+      "capabilities": [
+        "skills"
+      ]
+    }
+  },
+  "icon": "./icon.svg",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node scripts/checking-skill-links.mjs && node --test tests/*.test.mjs",
+    "check": "npm test",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "cpp",
+    "c++",
+    "cplusplus",
+    "cmake",
+    "ninja",
+    "clang",
+    "gcc",
+    "skills"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chengzhao-dev/dsh-cpp-workflow.git"
+  },
+  "homepage": "https://github.com/chengzhao-dev/dsh-cpp-workflow#readme",
+  "bugs": {
+    "url": "https://github.com/chengzhao-dev/dsh-cpp-workflow/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-skill": ">=0.2.0-rc.1 <0.3.0-0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-skill": ">=0.2.0-rc.1 <0.3.0-0",
+    "@types/node": "^22.20.5",
+    "typescript": "^5.9.3"
+  }
+}

package/skills/building-cpp/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: building-cpp
+description: 用 CMake、Ninja、clang-format、clang-tidy、clangd 配置、构建和检查 C++20 工程时使用；按定构建、定工具配置、通过检查三步推进。不用于只改源码语义、文档、Python 或与 C++ 无关的文件。
+metadata:
+  short-description: C++20 构建三步
+---
+
+# building-cpp
+
+## 适用场景
+
+管 `CMakeLists.txt`、`cmake/`、`running-build.sh`、`.clang-format`、`.clang-tidy`、`.clangd`、`.vscode/` 和 `environment.json`。函数体、类型、命名、异常和源码注释只开 `developing-cpp`；一次改动同时越过库与程序的边界时，先做完 `developing-cpp` 的第 2 步，再开本技能。`.qmd`、仓库 README、Python 和非 C++ 文档不打开本技能。
+
+编译失败先分因：诊断指向函数体，回 `developing-cpp` 的定实现；诊断指向声明或类型，回定声明；诊断是找不到头、链接失败、没有编译数据库或工具不在 PATH，留在本技能的定构建或定工具配置。
+
+存在项目技能 `cpp-workflow-project` 时先读它的 `SKILL.md`、`environment.json` 和 `stages/stage-table.md`。三个轴为空或组合非法时停在定构建，不猜 WSL、Clang 或构建目录；环境组合空着时源码四步仍可做，只是不能构建。
+
+## 两种走法
+
+| 走法 | 什么时候用 | 怎么做 |
+| --- | --- | --- |
+| 增量修正 | 用户点了一条链接错误、一个工具配置或一条诊断 | 先判断属于定构建还是定工具配置，只改那一处，不动无关 target 和配置 |
+| 整段重构 | 新工程、新阶段、换环境组合，或第一次接构建 | 同样三步；先定 target 和目录，再改工具文件，最后跑完整检查 |
+
+共同不变量：不发明项目没有声明的环境轴、命令和 target；只改格式或配置时不改可观察行为；不覆盖已有源码、`CMakeLists.txt` 和 `.clang-*`；不安装工具链；代理侧不写 `wsl` 或 `bash -lc`。后一步发现前一步没做完，退回那一步。拿不准先用增量修正；发现环境轴、编译器或构建目录需要改，退回整段，从定构建重走。
+
+## 步骤
+
+| 步 | 名称 | 文件 | 一句话 |
+| --- | --- | --- | --- |
+| 1 | 定构建 | `steps/01-build.md` | 一次配置一个编译器，Ninja，target-based CMake，编译数据库 |
+| 2 | 定工具配置 | `steps/02-tooling.md` | 格式化、静态检查、clangd 各管一段，互不越界 |
+| 3 | 通过检查 | `steps/03-check.md` | 先跑环境脚本的 `--live`，再跑项目入口，按失败位置分诊 |
+
+每步只打开同号的一个步骤文件。判不准才打开 `examples/` 里与该步对应的案例；`references/` 保存完整条文，只在排错、整目录重构，或步骤里明确指向某一条文时按需打开。
+
+## 完成判据
+
+- 项目 `environment.json` 的三个轴齐全且是合法组合；没有靠猜。
+- 配置命令固定 Ninja 和单一编译器，`build/<compiler>/compile_commands.json` 存在，根 `build/compile_commands.json` 指向当前编译器。
+- 标准写在 target 上，`CXX_EXTENSIONS OFF`，没有全局 `include_directories()` 或 GLOB。
+- `clang-format --dry-run --Werror` 与 `clang-tidy` 在项目源码上零告警；只扫描项目源码和项目头。
+- CTest 全绿，程序从该编译器的构建目录启动；失败时报告的是具体角色和原因。
+- 没有改源码语义，没有覆盖已有工程文件，也没有安装或下载任何工具。

package/skills/building-cpp/assets/cmake/applying-warnings.cmake

@@ -0,0 +1,10 @@
+# 给一个 target 施加团队警告；不污染全局 CMAKE_CXX_FLAGS。
+function(cpp_workflow_apply_warnings target)
+  target_compile_options(${target} PRIVATE
+    -Wall
+    -Wextra
+    -Werror
+    -Wold-style-cast
+    -Wshadow
+  )
+endfunction()

package/skills/building-cpp/assets/cmake/fetching-googletest.cmake

@@ -0,0 +1,15 @@
+# 固定版本拉取 GoogleTest；只在 tests/ 需要时调用。
+include(FetchContent)
+
+function(cpp_workflow_fetch_googletest)
+  if(POLICY CMP0135)
+    cmake_policy(SET CMP0135 NEW)
+  endif()
+  FetchContent_Declare(
+    googletest
+    URL https://codeload.github.com/google/googletest/tar.gz/refs/tags/v1.17.0
+    URL_HASH SHA256=65fab701d9829d38cb77c14acdc431d2108bfdbf8979e40eb8ae567edf10b27c
+  )
+  set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
+  FetchContent_MakeAvailable(googletest)
+endfunction()

package/skills/building-cpp/assets/cmake/setting-rpath.cmake

@@ -0,0 +1,8 @@
+# 让构建目录里的程序直接找到同目录的共享库；安装规则另配。
+function(cpp_workflow_set_build_rpath target)
+  if(APPLE)
+    set_target_properties(${target} PROPERTIES BUILD_RPATH "@loader_path/../lib")
+  else()
+    set_target_properties(${target} PROPERTIES BUILD_RPATH "$ORIGIN/../lib")
+  endif()
+endfunction()

package/skills/building-cpp/assets/config/.clang-format

@@ -0,0 +1,40 @@
+# 100 列：模板与格式化串在 80 列下换行过碎；全工程统一。
+Language: Cpp
+BasedOnStyle: Google
+Standard: c++20
+ColumnLimit: 100
+ReflowComments: true
+AlignAfterOpenBracket: Align
+AlignOperands: Align
+BreakBeforeTernaryOperators: true
+DerivePointerAlignment: false
+PointerAlignment: Left
+AccessModifierOffset: -1
+EmptyLineBeforeAccessModifier: Always
+EmptyLineAfterAccessModifier: Never
+IndentWidth: 2
+TabWidth: 2
+UseTab: Never
+MaxEmptyLinesToKeep: 1
+KeepEmptyLinesAtTheStartOfBlocks: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+BreakAfterAttributes: Never
+AlwaysBreakTemplateDeclarations: Yes
+BreakConstructorInitializers: BeforeColon
+ConstructorInitializerIndentWidth: 4
+SpacesBeforeTrailingComments: 2
+IncludeBlocks: Regroup
+IncludeCategories:
+  # C 系统头先于 C++ 标准库；gtest 归第三方，不排到标准库前面。
+  - Regex: '^<[^/>]*\.h>'
+    Priority: 1
+  - Regex: '^<gtest/'
+    Priority: 3
+  - Regex: '^<.*>'
+    Priority: 2
+  # 其余引号头（本项目组件头）排最后。
+  - Regex: '.*'
+    Priority: 4

package/skills/building-cpp/assets/config/.clang-tidy

@@ -0,0 +1,92 @@
+#===--------------------------------------------------------------------------------------------===#
+# 与 .clang-format 同一套命名；关闭项及理由集中写在 Checks 上方。
+#===--------------------------------------------------------------------------------------------===#
+
+InheritParentConfig: false
+
+# 关闭项：
+# - bugprone-easily-swappable-parameters：相邻同型参数的顺序错误靠接口设计和 review，不靠命名噪声。
+# - modernize-use-trailing-return-type：Google 风格不要求尾置返回类型。
+# - portability-avoid-pragma-once：项目统一使用 #pragma once。
+# - readability-identifier-length：短循环变量和测试数据（i、x）是领域习惯。
+# - readability-magic-numbers 与 cppcoreguidelines-avoid-magic-numbers：阈值、尺寸和测试数据常直接写字面量。
+Checks: >
+  -*,
+  bugprone-*,
+  cppcoreguidelines-*,
+  misc-*,
+  modernize-*,
+  performance-*,
+  portability-*,
+  readability-*,
+  clang-analyzer-core.*,
+  google-build-using-namespace,
+  google-explicit-constructor,
+  google-global-names-in-headers,
+  google-readability-casting,
+  -bugprone-easily-swappable-parameters,
+  -cppcoreguidelines-avoid-magic-numbers,
+  -modernize-use-trailing-return-type,
+  -portability-avoid-pragma-once,
+  -readability-identifier-length,
+  -readability-magic-numbers
+
+WarningsAsErrors: '*'
+# 头文件过滤由调用方按项目目录传入；这里不写 .*，避免把第三方头纳入。
+FormatStyle: file
+UseColor: true
+
+CheckOptions:
+  # 类型与函数 PascalCase；变量 snake_case；私有成员尾随 _；常量 k 前缀。
+  - key: readability-identifier-naming.NamespaceCase
+    value: lower_case
+  - key: readability-identifier-naming.ClassCase
+    value: CamelCase
+  - key: readability-identifier-naming.StructCase
+    value: CamelCase
+  - key: readability-identifier-naming.EnumCase
+    value: CamelCase
+  - key: readability-identifier-naming.EnumConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.EnumConstantPrefix
+    value: 'k'
+  - key: readability-identifier-naming.FunctionCase
+    value: CamelCase
+  - key: readability-identifier-naming.TypeAliasCase
+    value: CamelCase
+  - key: readability-identifier-naming.TypedefCase
+    value: CamelCase
+  - key: readability-identifier-naming.TemplateParameterCase
+    value: CamelCase
+  - key: readability-identifier-naming.VariableCase
+    value: lower_case
+  - key: readability-identifier-naming.ParameterCase
+    value: lower_case
+  - key: readability-identifier-naming.FieldCase
+    value: lower_case
+  - key: readability-identifier-naming.PrivateMemberCase
+    value: lower_case
+  - key: readability-identifier-naming.PrivateMemberSuffix
+    value: '_'
+  - key: readability-identifier-naming.ConstexprVariableCase
+    value: CamelCase
+  - key: readability-identifier-naming.ConstexprVariablePrefix
+    value: 'k'
+  - key: readability-identifier-naming.GlobalConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.GlobalConstantPrefix
+    value: 'k'
+  - key: readability-identifier-naming.LocalConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.LocalConstantPrefix
+    value: 'k'
+  - key: readability-identifier-naming.MacroDefinitionCase
+    value: UPPER_CASE
+  # 函数长度：Google 建议短函数，超过 40 行提示。
+  - key: readability-function-size.LineThreshold
+    value: 40
+  - key: readability-function-size.StatementThreshold
+    value: 50
+  # 空容器/默认构造成员不加 {}；与 NSDMI 规则配套。
+  - key: readability-redundant-member-init.IgnoreBaseInCopyConstructors
+    value: true

package/skills/building-cpp/assets/config/.clangd

@@ -0,0 +1,12 @@
+# 指向当前编译器目录；GCC 模式改成 build/gcc，不要两套并存。
+CompileFlags:
+  CompilationDatabase: build/clang
+  Add:
+    - -std=c++20
+    - -Wall
+    - -Wextra
+Diagnostics:
+  # 静态检查规则只在 .clang-tidy 里维护；这里不复制检查列表。
+  Suppress:
+    # 项目头由编译数据库提供；解析噪声不掩盖真实诊断。
+    - pp_file_not_found

package/skills/building-cpp/assets/config/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+  "recommendations": [
+    "llvm-vs-code-extensions.vscode-clangd",
+    "ms-vscode.cmake-tools"
+  ]
+}

package/skills/building-cpp/assets/config/.vscode/settings.json

@@ -0,0 +1,34 @@
+{
+  // 编译器驱动用绝对路径；GCC 模式改成 /usr/bin/g++。
+  // 只允许这一个驱动，不用 * 通配。
+  "clangd.arguments": [
+    "--query-driver=/usr/bin/clang++",
+    "--header-insertion=never",
+    "--background-index"
+  ],
+  "cmake.buildDirectory": "${workspaceFolder}/build/clang",
+  "cmake.generator": "Ninja",
+  "cmake.configureOnOpen": false,
+  // 格式化统一交给 clangd，避免 cpptools 与 clang-format 两套结果。
+  "C_Cpp.intelliSenseEngine": "disabled",
+  "editor.formatOnSave": true,
+  "[cpp]": {
+    "editor.defaultFormatter": "llvm-vs-code-extensions.vscode-clangd"
+  },
+  "[c]": {
+    "editor.defaultFormatter": "llvm-vs-code-extensions.vscode-clangd"
+  },
+  "files.associations": {
+    "*.h": "cpp"
+  },
+  "files.encoding": "utf8",
+  "files.eol": "\n",
+  "files.exclude": {
+    "**/build": true,
+    "**/.cache": true
+  },
+  "search.exclude": {
+    "**/build": true,
+    "**/.cache": true
+  }
+}

package/skills/building-cpp/assets/templates/projects/common/running-build.sh

@@ -0,0 +1,152 @@
+#!/usr/bin/env bash
+#===--------------------------------------------------------------------------------------------===#
+# 配置、构建、格式化、静态检查、测试并运行当前 C++20 工程。
+#
+# 用法：./running-build.sh [clang|gcc]；省略时用 clang。
+# 构建目录：build/<compiler>；编译数据库：build/<compiler>/compile_commands.json
+# 适用于 Linux、macOS 和 Windows + WSL；Windows 原生组合需要另写 PowerShell 版本。
+#===--------------------------------------------------------------------------------------------===#
+
+set -euo pipefail
+cd "$(dirname "$0")"
+
+readonly APP_NAME="app"
+readonly BUILD_ROOT="build"
+
+COMPILER="${1:-clang}"
+case "${COMPILER}" in
+  clang)
+    readonly CXX="clang++"
+    ;;
+  gcc)
+    readonly CXX="g++"
+    ;;
+  *)
+    printf '用法: %s [clang|gcc]\n' "$0" >&2
+    exit 2
+    ;;
+esac
+readonly COMPILER CXX
+readonly BUILD_DIR="${BUILD_ROOT}/${COMPILER}"
+
+#===--------------------------------------------------------------------------------------------===#
+# 输出辅助
+#===--------------------------------------------------------------------------------------------===#
+
+header() {
+  printf '\n== %s ==\n' "$1"
+}
+
+err() {
+  printf '错误: %s\n' "$1" >&2
+}
+
+trap 'status=$?; printf "失败（退出码 %s）：%s\n" "${status}" "${BASH_COMMAND}" >&2' ERR
+
+#===--------------------------------------------------------------------------------------------===#
+# 项目源码
+#===--------------------------------------------------------------------------------------------===#
+
+collect_sources() {
+  find . \
+    \( -type d \( -name .git -o -name .cache -o -name node_modules \
+       -o -name third_party -o -name external -o -name vendor \
+       -o -name build -o -name temp -o -name templates \) -prune \) -o \
+    -type f \( -name '*.c' -o -name '*.cc' -o -name '*.cpp' -o -name '*.cxx' \
+       -o -name '*.h' -o -name '*.hh' -o -name '*.hpp' -o -name '*.hxx' \) -print0
+}
+
+# 只让项目自身目录的头文件诊断进入结果。顶层目录从项目文件推导，
+# 不硬编码 include/src；项目根同时覆盖 clang-tidy 输出的绝对路径。
+# 第三方头即使被包含，也不在项目根 + 顶层目录的白名单里。
+header_filter_for() {
+  local tops=()
+  local file rel top
+  for file in "$@"; do
+    rel="${file#./}"
+    case "${rel}" in
+      */*)
+        top="${rel%%/*}"
+        tops+=("${top}")
+        ;;
+    esac
+  done
+  local root
+  root="$(pwd -P)"
+  if [[ ${#tops[@]} -eq 0 ]]; then
+    printf '^(%s/)?[^/]+$' "${root}"
+    return 0
+  fi
+  printf '^(%s/)?((%s)/|[^/]+$)' "${root}" "$(printf '%s\n' "${tops[@]}" | sort -u | paste -sd '|' -)"
+}
+
+#===--------------------------------------------------------------------------------------------===#
+# 主流程
+#===--------------------------------------------------------------------------------------------===#
+
+main() {
+  header "配置 (${COMPILER})"
+  cmake -S . -B "${BUILD_DIR}" -G Ninja \
+    -DCMAKE_BUILD_TYPE=Debug \
+    -DCMAKE_C_COMPILER="${COMPILER}" \
+    -DCMAKE_CXX_COMPILER="${CXX}" \
+    -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
+
+  header "构建"
+  cmake --build "${BUILD_DIR}"
+
+  header "编译数据库"
+  rm -f "${BUILD_ROOT}/compile_commands.json"
+  ln -s "${COMPILER}/compile_commands.json" "${BUILD_ROOT}/compile_commands.json"
+
+  local format_sources=()
+  local tidy_sources=()
+  local file
+  while IFS= read -r -d '' file; do
+    format_sources+=("${file}")
+    case "${file}" in
+      *.c|*.cc|*.cpp|*.cxx) tidy_sources+=("${file}") ;;
+    esac
+  done < <(collect_sources)
+
+  header "换行检查"
+  if [[ ${#format_sources[@]} -gt 0 ]]; then
+    local crlf
+    crlf=$(grep -Il $'\r' "${format_sources[@]}" || true)
+    if [[ -n "${crlf}" ]]; then
+      err "以下文件含 CRLF，请改成 LF：${crlf}"
+      return 1
+    fi
+  fi
+
+  header "格式检查"
+  if [[ ${#format_sources[@]} -gt 0 ]]; then
+    clang-format --dry-run --Werror "${format_sources[@]}"
+  else
+    err "没有找到项目源码，跳过 clang-format"
+  fi
+
+  header "静态检查"
+  if [[ ${#tidy_sources[@]} -gt 0 ]]; then
+    local header_filter
+    local tidy_args=(--warnings-as-errors='*')
+    header_filter="$(header_filter_for "${format_sources[@]}")"
+    if [[ -n "${header_filter}" ]]; then
+      tidy_args+=(--header-filter="${header_filter}")
+    fi
+    clang-tidy -p "${BUILD_DIR}" "${tidy_args[@]}" "${tidy_sources[@]}"
+  else
+    err "没有找到 C++ 源文件，跳过 clang-tidy"
+  fi
+
+  header "测试"
+  ctest --test-dir "${BUILD_DIR}" --output-on-failure
+
+  header "运行 ${APP_NAME}"
+  (
+    cd "${BUILD_DIR}/bin"
+    "./${APP_NAME}"
+  )
+}
+
+main "$@"

package/skills/building-cpp/assets/templates/projects/multi/CMakeLists.txt

@@ -0,0 +1,18 @@
+cmake_minimum_required(VERSION 3.20)
+project({{PROJECT_NAME}} VERSION 0.1.0 LANGUAGES CXX)
+
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+enable_testing()
+
+add_executable(app
+  src/main.cpp
+  src/greeting.cpp
+)
+target_include_directories(app PRIVATE include)
+target_compile_features(app PRIVATE cxx_std_20)
+set_target_properties(app PROPERTIES CXX_EXTENSIONS OFF)
+target_compile_options(app PRIVATE -Wall -Wextra -Werror)
+
+add_test(NAME app_smoke COMMAND app)

package/skills/building-cpp/assets/templates/projects/multi/include/greeting.h

@@ -0,0 +1,10 @@
+#pragma once
+
+#include <string>
+#include <string_view>
+
+namespace greeting {
+
+[[nodiscard]] std::string MakeGreeting(std::string_view name);
+
+}  // namespace greeting

package/skills/building-cpp/assets/templates/projects/multi/src/greeting.cpp

@@ -0,0 +1,13 @@
+#include "greeting.h"
+
+#include <format>
+#include <string>
+#include <string_view>
+
+namespace greeting {
+
+std::string MakeGreeting(std::string_view name) {
+  return std::format("Hello, {}!", name);
+}
+
+}  // namespace greeting

package/skills/building-cpp/assets/templates/projects/multi/src/main.cpp

@@ -0,0 +1,8 @@
+#include <iostream>
+
+#include "greeting.h"
+
+int main() {
+  std::cout << greeting::MakeGreeting("C++20") << '\n';
+  return 0;
+}

package/skills/building-cpp/assets/templates/projects/shared-library/CMakeLists.txt

@@ -0,0 +1,24 @@
+cmake_minimum_required(VERSION 3.20)
+project({{PROJECT_NAME}} VERSION 0.1.0 LANGUAGES CXX)
+
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib")
+
+enable_testing()
+
+add_subdirectory(greeting)
+
+add_executable(app src/main.cpp)
+target_compile_features(app PRIVATE cxx_std_20)
+set_target_properties(app PROPERTIES CXX_EXTENSIONS OFF)
+target_link_libraries(app PRIVATE greeting)
+target_compile_options(app PRIVATE -Wall -Wextra -Werror)
+
+add_test(NAME app_smoke COMMAND app)
+
+if(APPLE)
+  set_target_properties(app PROPERTIES BUILD_RPATH "@loader_path/../lib")
+else()
+  set_target_properties(app PROPERTIES BUILD_RPATH "$ORIGIN/../lib")
+endif()

package/skills/building-cpp/assets/templates/projects/shared-library/greeting/CMakeLists.txt

@@ -0,0 +1,5 @@
+add_library(greeting SHARED src/greeting.cpp)
+target_include_directories(greeting PUBLIC include)
+target_compile_features(greeting PUBLIC cxx_std_20)
+set_target_properties(greeting PROPERTIES CXX_EXTENSIONS OFF)
+target_compile_options(greeting PRIVATE -Wall -Wextra -Werror -Wold-style-cast -Wshadow)

package/skills/building-cpp/assets/templates/projects/shared-library/greeting/include/greeting.h

@@ -0,0 +1,10 @@
+#pragma once
+
+#include <string>
+#include <string_view>
+
+namespace greeting {
+
+[[nodiscard]] std::string MakeGreeting(std::string_view name);
+
+}  // namespace greeting

package/skills/building-cpp/assets/templates/projects/shared-library/greeting/src/greeting.cpp

@@ -0,0 +1,13 @@
+#include "greeting.h"
+
+#include <format>
+#include <string>
+#include <string_view>
+
+namespace greeting {
+
+std::string MakeGreeting(std::string_view name) {
+  return std::format("Hello, {}!", name);
+}
+
+}  // namespace greeting

package/skills/building-cpp/assets/templates/projects/shared-library/src/main.cpp

@@ -0,0 +1,8 @@
+#include <iostream>
+
+#include "greeting.h"
+
+int main() {
+  std::cout << greeting::MakeGreeting("C++20") << '\n';
+  return 0;
+}

package/skills/building-cpp/assets/templates/projects/single/CMakeLists.txt

@@ -0,0 +1,14 @@
+cmake_minimum_required(VERSION 3.20)
+project({{PROJECT_NAME}} VERSION 0.1.0 LANGUAGES CXX)
+
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
+
+enable_testing()
+
+add_executable(app src/main.cpp)
+target_compile_features(app PRIVATE cxx_std_20)
+set_target_properties(app PROPERTIES CXX_EXTENSIONS OFF)
+target_compile_options(app PRIVATE -Wall -Wextra -Werror)
+
+add_test(NAME app_smoke COMMAND app)

package/skills/building-cpp/assets/templates/projects/single/src/main.cpp

@@ -0,0 +1,9 @@
+#include <format>
+#include <iostream>
+#include <string>
+
+int main() {
+  const std::string name = "C++20";
+  std::cout << std::format("Hello, {}!\n", name);
+  return 0;
+}