@chengzhao-dev/dsh-cpp-workflow 0.1.0 → 0.2.0

package/skills/developing-cpp/steps/04-implementation.md

@@ -2,16 +2,16 @@
 
 ## 产出
 
-`.cpp` 中的函数体、操作顺序、分组空白和实现注释。实现只兑现第 1 步的行为和第 3 步的声明，不新增公共接口。
+`.cc` 中的函数体、操作顺序、分组空白和实现注释。实现只兑现第 1 步的行为和第 3 步的声明，不新增公共接口。
 
 ## 通用情况
 
 - 函数保持短小；一个函数只做一件事。超过约 40 行时先找可以命名的中间步骤，不要用注释把长函数切成几段。
 - 按「准备 → 操作 → 收尾」排列语句，用空行分组；组与组之间的空行表达阶段，不用大段叙述。
-- `.cpp` 第一个 include 是自己的配对头，然后直接包含本文件用到的标准库头；不要依赖公共头替本文件转发声明。若所用 clang-tidy 版本带 `misc-include-cleaner`，这类缺失会被报出来。
+- `.cc` 第一个 include 是自己的配对头，然后直接包含本文件用到的标准库头；不要依赖公共头替本文件转发声明。包含顺序见 `references/google-cpp-style.md`。
 - 实现注释只写「为什么这样做」「这里的边界条件」「这样排序的代价」，不复述代码。
-- 错误处理：可预期失败返回结果类型；合同违反抛异常。捕获异常时按 `const` 引用捕获，只处理能处理的类型，其余继续抛。
-- 组合输出用 `std::format`，再写入 `std::cout` / `std::cerr`；不要在库实现里直接打印。C++20 没有 `std::print`。
+- 错误处理：失败是调用方正常结果时返回结果类型、`bool` 或 `std::optional`；函数无法完成自己的任务时抛异常，不拿异常做正常分支。捕获时按 `const` 引用，只处理能处理的类型，其余继续抛。
+- 组合输出用 `std::format`，再写入 `std::cout` / `std::cerr`；不要在库实现里直接打印。C++23 且库支持时程序边界可用 `std::print`，C++20 及更早没有。
 - 不写 C 风格强制转换；用 `static_cast` / `std::bit_cast` 等具名转换。
 - 所有权用 `std::unique_ptr`；没有共享所有权的理由时不用 `std::shared_ptr`。
 - 只改注释时，不改可观察行为；只改实现时，不改公共声明。两者同时需要时，先改声明，再改实现。
@@ -24,10 +24,14 @@
 
 **重构**：一次只动一种东西（改名、抽函数、换容器）。每步都让测试保持绿色；行为句不变。
 
-**异常边界**：库内部可以让合同异常向上传播；程序入口捕获 `std::exception`，用 `std::format("错误: {}", error.what())` 打印，返回非零退出码。不要吞掉异常后继续用无效状态。
+**异常边界**：库内部让异常向上传播；程序入口捕获 `std::exception`，用 `std::format("错误: {}", error.what())` 打印，返回项目约定的非零退出码。不要吞掉异常后继续用无效状态。
+
+## 交回构建
+
+要补测试、新增或移动源文件时，交给 `building-cpp` 的定构建：把文件显式写进 CMake，再决定是否定工具配置，最后通过检查。不要只改完函数体就宣称完成。
 
 ## 正反例指针
 
 - 实现注释复述代码、分组混乱：`examples/comments.md`「实现注释」。
-- 合同异常与结果类型混用：`examples/exceptions.md`「抛还是返回」。
-- `std::format` 与流输出混用得当：`examples/exceptions.md`「消息格式」。
+- 异常类型与结果类型混用：`examples/exceptions.md`「什么时候抛」。
+- `std::format` 与流输出混用得当：`examples/exceptions.md`「异常类型与消息」。

package/templates/cpp-workflow-project/SKILL.md

@@ -18,7 +18,7 @@ metadata:
 | 组件名 | `<component-name>` |
 | 源码根 | `<src-root>` |
 
-同目录的 `environment.json` 三个轴必须填本工程的真实组合；留空时技能仍可能出现，但定构建会停。
+同目录的 `environment.json` 三个环境轴必须填本工程的真实组合；`standard` 默认 `c++23`，可改成 `c++11`–`c++23`。环境轴留空时技能仍可能出现，但定构建会停。
 
 ## 库与程序的边界
 

package/templates/cpp-workflow-project/environment.json

@@ -1,5 +1,6 @@
 {
   "host": "",
   "build_host": "",
-  "compiler": ""
+  "compiler": "",
+  "standard": "c++23"
 }

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

@@ -1,13 +0,0 @@
-#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

@@ -1,8 +0,0 @@
-#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/greeting/src/greeting.cpp

@@ -1,13 +0,0 @@
-#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

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

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

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

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

@@ -1,13 +0,0 @@
-#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/static-library/src/main.cpp

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