kld-sdd 2.4.7 → 2.4.9

package/templates/skills/opsx-propose/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: opsx-propose
 description: "业务意图文档技能 - 引导创建 proposal.md，定义变更的 Why 和上下文总览"
 argument-hint: "[change-name] [上下文文件...]"
@@ -28,9 +28,14 @@ allowed-tools:
 > **完成本阶段后，绝对禁止自动继续执行 spec/design/task 等后续阶段。**
 
 
+> **🖥️ 跨平台执行规则**
+> - 先确认当前终端工作目录是项目根目录；若不是，先 `cd` 到项目根目录。
+> - Telemetry 命令默认使用 `--project=.`，兼容 Windows、macOS、Linux。
+> - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
+> - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=propose --project=<项目根目录绝对路径> --change=<变更名称> --agent=<Agent类型>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --result=success|failure --summary="摘要" --project=<项目根目录绝对路径>`
+> - 阶段开始：`node skywalk-sdd/log.js start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

package/templates/skills/opsx-spec/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: opsx-spec
 description: "技术契约文档技能 - 为每个能力创建 spec.md，定义业务场景与技术规范"
 argument-hint: "[change-name] [上下文文件...]"
@@ -28,9 +28,14 @@ allowed-tools:
 > **完成本阶段后，绝对禁止自动继续执行 design/task 等后续阶段。**
 
 
+> **🖥️ 跨平台执行规则**
+> - 先确认当前终端工作目录是项目根目录；若不是，先 `cd` 到项目根目录。
+> - Telemetry 命令默认使用 `--project=.`，兼容 Windows、macOS、Linux。
+> - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
+> - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=spec --project=<项目根目录绝对路径> --change=<变更名称> --agent=<Agent类型>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --result=success|failure --summary="摘要" --project=<项目根目录绝对路径>`
+> - 阶段开始：`node skywalk-sdd/log.js start --command=spec --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=spec --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

package/templates/skills/opsx-task/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: opsx-task
 description: "局部任务拆解技能 - 针对单一 Capability 创建 DAG 任务清单"
 argument-hint: "[change-name] [capability-name] [上下文文件...]"
@@ -35,9 +35,14 @@ allowed-tools:
 > - ⛔ **隔离红线**：绝对禁止跨目录读取同级其他 Capability 的文档
 
 
+> **🖥️ 跨平台执行规则**
+> - 先确认当前终端工作目录是项目根目录；若不是，先 `cd` 到项目根目录。
+> - Telemetry 命令默认使用 `--project=.`，兼容 Windows、macOS、Linux。
+> - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
+> - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=task --project=<项目根目录绝对路径> --change=<变更名称> --agent=<Agent类型>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --result=success|failure --summary="摘要" --project=<项目根目录绝对路径>`
+> - 阶段开始：`node skywalk-sdd/log.js start --command=task --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=task --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

package/templates/skills/opsx-test/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: opsx-test
 description: "单元测试执行技能 - 自动检测并运行测试用例，输出结构化测试报告"
 argument-hint: "[test-scope] [options]"
@@ -23,9 +23,14 @@ allowed-tools:
 > - 用户可在完成代码实现后主动调用
 > - 输出标准化测试报告，便于质量追踪
 
+> **🖥️ 跨平台执行规则**
+> - 先确认当前终端工作目录是项目根目录；若不是，先 `cd` 到项目根目录。
+> - Telemetry 命令默认使用 `--project=.`，兼容 Windows、macOS、Linux。
+> - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
+> - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=test --project=<项目根目录绝对路径> --change=<变更名称> --agent=<Agent类型>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --result=success|failure --summary="摘要" --project=<项目根目录绝对路径>`
+> - 阶段开始：`node skywalk-sdd/log.js start --command=test --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=test --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---