@chengzhao-dev/dsh-cpp-workflow 0.5.0 → 0.5.1

package/README.en.md

@@ -19,13 +19,13 @@ The exception material follows the C++ Core Guidelines' Error handling section a
 Pinned npm install:
 
 ```bash
-dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.5.0
+dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.5.1
 ```
 
 The matching Git tag:
 
 ```bash
-dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.5.0
+dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.5.1
 ```
 
 The desktop app owns the `desktop` profile. If the command-line `add` is rejected, add the plugin in the app settings and use the same pinned npm version. A Git tag install uses the prebuilt `lib/` committed in the repository and runs no build on the target machine; the package has no install script that needs approval.

package/README.md

@@ -19,13 +19,13 @@
 npm 安装钉死版本：
 
 ```bash
-dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.5.0
+dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.5.1
 ```
 
 同版本的 Git 标签：
 
 ```bash
-dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.5.0
+dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.5.1
 ```
 
 桌面应用独占 `desktop` profile。命令行 `add` 被拒绝时，在应用设置里添加插件，地址填同一个 npm 版本。Git 标签安装使用仓库内已构建的 `lib/`，不在目标机器上重新构建；包内也不含需要授权执行的安装脚本。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chengzhao-dev/dsh-cpp-workflow",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "C++11–C++23 工程流程技能包：源码四步、CMake 三步与构建三步，按项目声明的环境组合校验 · C++11–C++23 workflow skills for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",

package/skills/building-cpp/SKILL.md

@@ -38,6 +38,14 @@ metadata:
 
 每步只打开同号的一个步骤文件。判不准才打开 `examples/` 里与该步对应的案例；`references/` 保存完整条文，只在排错、整目录重构，或步骤里明确指向某一条文时按需打开。链接、rpath 与产物布局读 `references/linking.md`；CMake 的 target、标准和函数写法读 `../configuring-cmake/references/`，可复用片段在 `../configuring-cmake/assets/cmake/`。
 
+本轮激活按三条上限走：
+
+- 只开当前步对应的一个步骤文件；本轮已经开了别的技能，就不再开第二个技能的步骤。
+- 条文只开该步点名的一份；同号案例留到下一次激活。
+- 标准档只打开项目技能声明的那一档，没有声明时用本技能已有的新工程默认，不把其余标准档读进来。
+
+项目技能列出了检查命令时只跑那一条，没有时跑本技能自己的 `scripts/checking-environment.mjs` 与 `scripts/checking-encoding.mjs`；退出码为 0 后在同一轮结束 goal，不再继续走没有失败的步骤。
+
 ### 四类改动
 
 先认这次改的是哪一类，再决定从哪一步进；一次改动混了两类时，按「写作 → 布局 → 排版 → 润色」的次序拆开做。

package/skills/configuring-cmake/SKILL.md

@@ -34,6 +34,14 @@ metadata:
 
 每步只打开同号的一个步骤文件。判不准才打开 `examples/cmake.md`；`references/cmake.md` 保存 target、链接、输出、RPATH、依赖与反模式的完整条文，`references/cxx-standard.md` 保存 C++11–C++23 的标准映射，`references/modules.md` 保存函数与模块契约。可复制的函数在 `assets/cmake/`：`CompileSettings.cmake` 放标准与警告，`LinkSettings.cmake` 放构建期 RPATH 与 GoogleTest 依赖；一个文件按性质收一组函数。
 
+本轮激活按三条上限走：
+
+- 只开当前步对应的一个步骤文件；本轮已经开了别的技能，就不再开第二个技能的步骤。
+- 条文只开该步点名的一份；同号案例留到下一次激活。
+- 标准档只打开项目技能声明的那一档，没有声明时用本技能已有的新工程默认，不把其余标准档读进来。
+
+项目技能列出了检查命令时只跑那一条，没有时跑插件根目录的 `npm test`；退出码为 0 后在同一轮结束 goal，不再继续走没有失败的步骤。
+
 五档标准的语言设施、工具映射与降档仍由 `building-cpp/references/standards/` 维护；本技能只负责这些标准在 CMake 里怎么写。
 
 ### 四类改动

package/skills/developing-cpp/SKILL.md

@@ -35,6 +35,14 @@ metadata:
 
 每步只打开同号的一个步骤文件。判不准才打开 `examples/` 里与该步对应的案例；`references/` 保存完整条文，只在排错、整目录重构，或步骤里明确指向某一条文时按需打开。性能问题读 `references/performance.md`，标准库设施选型读 `references/standard-library.md`，链接与产物的细节读 `building-cpp` 的 `references/linking.md`。
 
+本轮激活按三条上限走：
+
+- 只开当前步对应的一个步骤文件；本轮已经开了别的技能，就不再开第二个技能的步骤。
+- 条文只开该步点名的一份；同号案例留到下一次激活。
+- 标准档只打开项目技能声明的那一档，没有声明时用本技能已有的新工程默认，不把其余标准档读进来。
+
+项目技能列出了检查命令时只跑那一条，没有时跑本技能自己的 `scripts/checking-comments.mjs`；退出码为 0 后在同一轮结束 goal，不再继续走没有失败的步骤。
+
 ### 四类改动
 
 先认这次改的是哪一类，再决定从哪一步进；一次改动混了两类时，按「写作 → 布局 → 排版 → 润色」的次序拆开做，前一类落定并经检查再进下一类。

package/skills/developing-cpp/examples/{comments.md → comments-declaration.md}

@@ -1,4 +1,4 @@
-# 正反例：注释
+# 正反例：声明注释与文件头
 
 ## 文件头
 
@@ -204,56 +204,6 @@ GameResult result_ = GameResult::kInProgress;  // 对局结果；落子被拒时
 
 行尾写「存什么 + 初值含义 + 什么时候变」，同类成员对齐。
 
-## 实现注释
-
-**差**：
-
-```cpp
-// 遍历所有空格
-for (const auto& position : empty_cells) {
-  // 尝试落子
-  const bool wins = game.Board().CompletesLine(position, cell_type);
-  // 如果能赢
-  if (wins) {
-    // 返回这一手
-    return position;
-  }
-}
-```
-
-每行都在复述代码。
-
-**好**：
-
-```cpp
-// 先找能立刻赢的格子：启发式只在「马上赢」和「马上挡」之间做选择，
-// 不在这里做更深的前瞻，深搜留给 MinimaxAi。
-for (const auto& position : empty_cells) {
-  if (game.CompletesLine(position, CellType::kX)) {
-    return position;
-  }
-}
-```
-
-解释「为什么停在这一层」，不翻译语句。
-
-## TODO
-
-**差**：
-
-```cpp
-// TODO: 参考 xxx
-// FIXME: 这里可能有问题
-```
-
-**好**：
-
-```cpp
-// TODO: 阶段 5 - 给 MinimaxAi 加置换表，减少重复局面的搜索。
-```
-
-有定位、有动作、能搜索。
-
 ## 配置注释
 
 **差**：

package/skills/developing-cpp/examples/comments-implementation.md

@@ -0,0 +1,53 @@
+# 正反例：实现注释
+
+实现注释只写本层为什么停在这里；声明注释、文件头与配置注释见 `comments-declaration.md`。
+
+## 实现注释
+
+**差**：
+
+```cpp
+// 遍历所有空格
+for (const auto& position : empty_cells) {
+  // 尝试落子
+  const bool wins = game.Board().CompletesLine(position, cell_type);
+  // 如果能赢
+  if (wins) {
+    // 返回这一手
+    return position;
+  }
+}
+```
+
+每行都在复述代码。
+
+**好**：
+
+```cpp
+// 先找能立刻赢的格子：启发式只在「马上赢」和「马上挡」之间做选择，
+// 不在这里做更深的前瞻，深搜留给 MinimaxAi。
+for (const auto& position : empty_cells) {
+  if (game.CompletesLine(position, CellType::kX)) {
+    return position;
+  }
+}
+```
+
+解释「为什么停在这一层」，不翻译语句。
+
+## TODO
+
+**差**：
+
+```cpp
+// TODO: 参考 xxx
+// FIXME: 这里可能有问题
+```
+
+**好**：
+
+```cpp
+// TODO: 阶段 5 - 给 MinimaxAi 加置换表，减少重复局面的搜索。
+```
+
+有定位、有动作、能搜索。

package/skills/developing-cpp/steps/03-declaration.md

@@ -30,4 +30,4 @@
 
 - 命名、访问器、语义角色：`examples/naming.md`。
 - 异常声明与返回值选择：`examples/exceptions.md`。
-- 声明注释写成了实现说明：`examples/comments.md`「声明注释」。
+- 声明注释写成了实现说明：`examples/comments-declaration.md`。

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

@@ -33,6 +33,6 @@
 
 ## 正反例指针
 
-- 实现注释复述代码、分组混乱：`examples/comments.md`「实现注释」。
+- 实现注释复述代码、分组混乱：`examples/comments-implementation.md`「实现注释」。
 - 异常类型与结果类型混用：`examples/exceptions.md`「什么时候抛」。
 - `std::format` 与流输出混用得当：`examples/exceptions.md`「异常类型与消息」。