feat(template): SRCP v1 standards, job_context/finish gold sample (v1.0.38, platform-kit 1.2.0)

Co-authored-by: Cursor <cursoragent@cursor.com>

scripts/service/task_service.py

@@ -13,10 +13,10 @@ import uuid
 from typing import Any, Dict, Optional
 
 from jiangchang_skill_core import collect_runtime_diagnostics, config, format_runtime_health_lines
-from jiangchang_skill_core.activity import emit
-from jiangchang_skill_core.rpa.video_session import RpaVideoSession
+from jiangchang_skill_core.activity import JobStopped, emit, finish, job_context
 
 from db import task_logs_repository as tlr
+from jiangchang_skill_core.rpa.video_session import RpaVideoSession
 from service.entitlement_service import check_entitlement
 from service.task_run_support import (
     _print_video_summary,
@@ -65,102 +65,127 @@ def cmd_run(target: Optional[str] = None, input_id: Optional[str] = None) -> int
     """通用任务执行入口模板。复制后请实现真实业务逻辑。"""
     log = _get_task_logger()
     task_type = "demo"
-    log.info(
-        "task_start task_type=%s target_id=%s input_id=%s",
-        task_type,
-        target,
-        input_id,
-    )
-    emit("开始处理任务", skill=SKILL_SLUG, stage="run")
-    try:
-        ok, reason = check_entitlement(SKILL_SLUG)
-        if not ok:
-            log.warning("entitlement_failed task_type=%s reason=%s", task_type, reason)
-            emit("鉴权失败，已记录诊断信息", type="warn", skill=SKILL_SLUG, stage="auth")
-            tlr.save_task_log(
-                task_type=task_type,
-                target_id=target,
-                input_id=input_id,
-                input_title="模板示例任务",
-                status="failed",
-                error_msg=reason,
-                result_summary=json.dumps({"stage": "auth", "error": reason}, ensure_ascii=False),
-            )
-            log.info(
-                "task_log_saved task_type=%s target_id=%s input_id=%s stage=auth status=failed",
-                task_type,
-                target,
-                input_id,
-            )
-            print(f"❌ {reason}")
-            return 1
 
-        log.info("task_run_demo_start target_id=%s input_id=%s", target, input_id)
-        rc, video_info = asyncio.run(_run_template_demo(target, input_id))
-        log.info("task_run_demo_done target_id=%s input_id=%s status=failed", target, input_id)
-        _print_video_summary(video_info)
-
-        summary_payload = merge_video_into_result_summary(
-            {
-                "template_demo": True,
-                "target": target,
-                "input_id": input_id,
-            },
-            video_info,
-        )
-        tlr.save_task_log(
-            task_type=task_type,
-            target_id=target,
-            input_id=input_id,
-            input_title="模板示例任务",
-            status="failed",
-            error_msg="模板仓库未实现真实业务",
-            result_summary=json.dumps(summary_payload, ensure_ascii=False),
-        )
+    with job_context(skill=SKILL_SLUG):
         log.info(
-            "task_log_saved task_type=%s target_id=%s input_id=%s status=failed",
+            "task_start task_type=%s target_id=%s input_id=%s",
             task_type,
             target,
             input_id,
         )
-
-        print("❌ 这是模板仓库，请复制后在 scripts/service/task_service.py 中实现 cmd_run 的真实业务逻辑。")
-        return rc
-    except Exception:
-        log.exception(
-            "task_failed task_type=%s target_id=%s input_id=%s",
-            task_type,
-            target,
-            input_id,
-        )
-        emit("任务失败，已记录诊断信息", type="warn", skill=SKILL_SLUG, stage="run")
+        emit("开始处理任务", skill=SKILL_SLUG, stage="run")
         try:
+            ok, reason = check_entitlement(SKILL_SLUG)
+            if not ok:
+                log.warning("entitlement_failed task_type=%s reason=%s", task_type, reason)
+                emit("鉴权失败，已记录诊断信息", type="warn", skill=SKILL_SLUG, stage="auth")
+                tlr.save_task_log(
+                    task_type=task_type,
+                    target_id=target,
+                    input_id=input_id,
+                    input_title="模板示例任务",
+                    status="failed",
+                    error_msg=reason,
+                    result_summary=json.dumps({"stage": "auth", "error": reason}, ensure_ascii=False),
+                )
+                log.info(
+                    "task_log_saved task_type=%s target_id=%s input_id=%s stage=auth status=failed",
+                    task_type,
+                    target,
+                    input_id,
+                )
+                finish(
+                    status="failed",
+                    message=reason,
+                    skill=SKILL_SLUG,
+                    error_code="ENTITLEMENT_DENIED",
+                    stage="auth",
+                )
+                print(f"❌ {reason}")
+                return 1
+
+            log.info("task_run_demo_start target_id=%s input_id=%s", target, input_id)
+            rc, video_info = asyncio.run(_run_template_demo(target, input_id))
+            log.info("task_run_demo_done target_id=%s input_id=%s status=failed", target, input_id)
+            _print_video_summary(video_info)
+
+            summary_payload = merge_video_into_result_summary(
+                {
+                    "template_demo": True,
+                    "target": target,
+                    "input_id": input_id,
+                },
+                video_info,
+            )
             tlr.save_task_log(
                 task_type=task_type,
                 target_id=target,
                 input_id=input_id,
                 input_title="模板示例任务",
                 status="failed",
-                error_msg="任务执行异常，详见统一日志",
-                result_summary=json.dumps(
-                    {"stage": "run", "error": "unexpected_exception"},
-                    ensure_ascii=False,
-                ),
+                error_msg="模板仓库未实现真实业务",
+                result_summary=json.dumps(summary_payload, ensure_ascii=False),
             )
             log.info(
-                "task_log_saved task_type=%s target_id=%s input_id=%s stage=run status=failed",
+                "task_log_saved task_type=%s target_id=%s input_id=%s status=failed",
                 task_type,
                 target,
                 input_id,
             )
+
+            finish(
+                status="failed",
+                message="模板仓库未实现真实业务",
+                skill=SKILL_SLUG,
+                template_demo=True,
+                target=target,
+                input_id=input_id,
+            )
+            print("❌ 这是模板仓库，请复制后在 scripts/service/task_service.py 中实现 cmd_run 的真实业务逻辑。")
+            return rc
+        except JobStopped:
+            raise
         except Exception:
             log.exception(
-                "task_log_save_failed task_type=%s target_id=%s input_id=%s",
+                "task_failed task_type=%s target_id=%s input_id=%s",
                 task_type,
                 target,
                 input_id,
             )
-        return 1
+            emit("任务失败，已记录诊断信息", type="warn", skill=SKILL_SLUG, stage="run")
+            try:
+                tlr.save_task_log(
+                    task_type=task_type,
+                    target_id=target,
+                    input_id=input_id,
+                    input_title="模板示例任务",
+                    status="failed",
+                    error_msg="任务执行异常，详见统一日志",
+                    result_summary=json.dumps(
+                        {"stage": "run", "error": "unexpected_exception"},
+                        ensure_ascii=False,
+                    ),
+                )
+                log.info(
+                    "task_log_saved task_type=%s target_id=%s input_id=%s stage=run status=failed",
+                    task_type,
+                    target,
+                    input_id,
+                )
+            except Exception:
+                log.exception(
+                    "task_log_save_failed task_type=%s target_id=%s input_id=%s",
+                    task_type,
+                    target,
+                    input_id,
+                )
+            finish(
+                status="failed",
+                message="任务执行异常，详见统一日志",
+                skill=SKILL_SLUG,
+                stage="run",
+            )
+            return 1
 
 
 def cmd_logs(

scripts/util/constants.py

@@ -1,6 +1,6 @@
 """技能标识、版本与平台公共库约束（复制后请修改 slug/version/logger）。"""
 
 SKILL_SLUG = "your-skill-slug"
-SKILL_VERSION = "1.0.32"
+SKILL_VERSION = "1.0.38"
 LOG_LOGGER_NAME = "openclaw.skill.your_skill_slug"
-PLATFORM_KIT_MIN_VERSION = "1.0.17"
+PLATFORM_KIT_MIN_VERSION = "1.2.0"