@cteno/sdk-linux-x64 0.0.0-stage → 2.10.13

package/skills/pptx/tests/test_powerpoint_skill.py

@@ -0,0 +1,477 @@
+"""End-to-end tests for the powerpoint skill helper scripts.
+
+Runs entirely offline. Exercises create, read, template-fill (with
+non-ASCII values), and edit (text + chart data + remove/move slide).
+"""
+import json
+import os
+import subprocess
+import sys
+
+import pytest
+
+SKILL = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+SCRIPTS = os.path.join(SKILL, "scripts")
+
+
+def run(script, *args):
+    env = dict(os.environ, LC_ALL="C", PYTHONIOENCODING="utf-8")
+    proc = subprocess.run(
+        [sys.executable, os.path.join(SCRIPTS, script), *args],
+        capture_output=True, text=True, encoding="utf-8", env=env, check=False)
+    assert proc.returncode == 0, f"{script} failed: {proc.stderr}"
+    return json.loads(proc.stdout)
+
+
+def write_json(path, obj):
+    with open(path, "w", encoding="utf-8") as fh:
+        json.dump(obj, fh, ensure_ascii=False)
+
+
+@pytest.fixture(scope="module")
+def workdir(tmp_path_factory):
+    return tmp_path_factory.mktemp("pptx")
+
+
+@pytest.fixture(scope="module")
+def sample_png(workdir):
+    # 1x1 red PNG, hardcoded bytes -> no Pillow dependency.
+    import base64
+    data = base64.b64decode(
+        "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGP4"
+        "z8DwHwAFBQIAX8jx0gAAAABJRU5ErkJggg==")
+    path = workdir / "red.png"
+    path.write_bytes(data)
+    return str(path)
+
+
+@pytest.fixture(scope="module")
+def deck(workdir, sample_png):
+    """Create a deck exercising every create feature."""
+    spec = {
+        "slide_size": "16:9",
+        "slides": [
+            {"layout": "title", "title": "Annual Review",
+             "subtitle": "Fiscal year 2026",
+             "notes": "Welcome the audience."},
+            {"layout": "title_content", "title": "Agenda",
+             "bullets": [
+                 "Overview",
+                 {"text": "Details", "level": 1, "bold": True,
+                  "size": 20, "color": "CC0000", "font": "Arial"},
+                 {"text": "Deep dive", "level": 2, "italic": True},
+             ],
+             "notes": "Keep this under two minutes."},
+            {"layout": "blank", "title": None,
+             "images": [{"path": sample_png, "left": 0.5, "top": 0.5,
+                         "width": 2, "height": 2}],
+             "tables": [{"left": 3, "top": 1, "width": 6, "height": 2,
+                         "rows": [["Region", "Sales"],
+                                  ["North", "120"], ["South", "80"]]}],
+             "shapes": [{"type": "rounded_rectangle", "left": 10,
+                         "top": 1, "width": 2.5, "height": 1,
+                         "fill": "4472C4", "text": "Callout",
+                         "text_color": "FFFFFF"}]},
+            {"layout": "title_only", "title": "Charts",
+             "charts": [
+                 {"type": "bar", "left": 0.5, "top": 1.5, "width": 4,
+                  "height": 3, "title": "Sales",
+                  "categories": ["Q1", "Q2"],
+                  "series": {"North": [10, 20], "South": [7, 13]}},
+                 {"type": "line", "left": 4.7, "top": 1.5, "width": 4,
+                  "height": 3, "categories": ["Jan", "Feb", "Mar"],
+                  "series": {"Trend": [1, 3, 2]}},
+                 {"type": "pie", "left": 8.9, "top": 1.5, "width": 4,
+                  "height": 3, "categories": ["A", "B", "C"],
+                  "series": {"Share": [50, 30, 20]}}]},
+        ],
+    }
+    spec_path = workdir / "deck.json"
+    write_json(spec_path, spec)
+    out = workdir / "deck.pptx"
+    result = run("pptx_create.py", str(spec_path), str(out))
+    assert result["ok"] and result["slides"] == 4
+    return str(out)
+
+
+def test_create_and_outline(deck):
+    outline = run("pptx_read.py", deck, "--outline")
+    assert outline["slide_count"] == 4
+    assert outline["slide_size_inches"][0] == pytest.approx(13.333, abs=0.01)
+    s0, s1, s2, s3 = outline["slides"]
+    assert "Annual Review" in s0["texts"]
+    assert "Fiscal year 2026" in s0["texts"]
+    assert s0["notes"] == "Welcome the audience."
+    # bullets present on slide 1
+    assert any("Deep dive" in t for t in s1["texts"])
+    # table content
+    assert s2["tables"][0][0] == ["Region", "Sales"]
+    assert s2["tables"][0][2] == ["South", "80"]
+    # image inventory + shape text
+    assert len(s2["images"]) == 1 and s2["images"][0]["ext"] == "png"
+    assert "Callout" in s2["texts"]
+    # three charts with correct data
+    assert len(s3["charts"]) == 3
+    bar = s3["charts"][0]
+    assert bar["categories"] == ["Q1", "Q2"]
+    north = next(s for s in bar["series"] if s["name"] == "North")
+    assert north["values"] == [10.0, 20.0]
+
+
+def test_create_43_size(workdir):
+    spec_path = workdir / "small.json"
+    write_json(spec_path, {"slide_size": "4:3",
+                           "slides": [{"layout": "title", "title": "T"}]})
+    out = workdir / "small.pptx"
+    run("pptx_create.py", str(spec_path), str(out))
+    outline = run("pptx_read.py", str(out))
+    assert outline["slide_size_inches"] == [10.0, 7.5]
+
+
+def test_notes_mode(deck):
+    result = run("pptx_read.py", deck, "--notes")
+    assert result["notes"][1] == "Keep this under two minutes."
+
+
+def test_image_export(deck, workdir):
+    out_dir = workdir / "exported"
+    result = run("pptx_read.py", deck, "--images", str(out_dir))
+    assert len(result["exported"]) == 1
+    exported = result["exported"][0]
+    assert os.path.getsize(exported) > 0
+    with open(exported, "rb") as fh:
+        assert fh.read(8) == b"\x89PNG\r\n\x1a\n"
+
+
+def test_template_fill_non_ascii(workdir):
+    """Template token fill with non-ASCII values, forced under LC_ALL=C."""
+    tpl_spec = workdir / "tpl.json"
+    write_json(tpl_spec, {"slides": [
+        {"layout": "title", "title": "{{city}} report",
+         "subtitle": "Prepared by {{author}}",
+         "notes": "Deck for {{city}}."},
+        {"layout": "title_content", "title": "Data",
+         "tables": [{"rows": [["Site", "{{city}}"]]}]},
+    ]})
+    template = workdir / "template.pptx"
+    run("pptx_create.py", str(tpl_spec), str(template))
+
+    values = workdir / "values.json"
+    write_json(values, {"city": "Z\u00fcrich \u2014 \u2018Bericht\u2019",
+                        "author": "Beispiel GmbH"})
+    out = workdir / "filled.pptx"
+    result = run("pptx_from_template.py", str(template), str(out),
+                 "--values", str(values))
+    assert result["tokens_filled"] == 4
+
+    outline = run("pptx_read.py", str(out))
+    expected = "Z\u00fcrich \u2014 \u2018Bericht\u2019"
+    assert f"{expected} report" in outline["slides"][0]["texts"]
+    assert outline["slides"][0]["notes"] == f"Deck for {expected}."
+    assert outline["slides"][1]["tables"][0][0][1] == expected
+
+
+def test_template_add_slides(workdir):
+    template = workdir / "template.pptx"
+    add_spec = workdir / "add.json"
+    write_json(add_spec, {"slides": [
+        {"layout": 1, "title": "Appended", "bullets": ["from layout"],
+         "notes": "appended slide"}]})
+    out = workdir / "appended.pptx"
+    run("pptx_from_template.py", str(template), str(out),
+        "--add-slides", str(add_spec))
+    outline = run("pptx_read.py", str(out))
+    assert outline["slide_count"] == 3
+    assert "Appended" in outline["slides"][2]["texts"]
+
+
+def test_edit_replace_text(deck, workdir):
+    edited = workdir / "edited.pptx"
+    result = run("pptx_edit.py", deck, "--output", str(edited),
+                 "--replace-text", "Annual Review", "Semi-Annual Review",
+                 "--replace-text", "South", "West")
+    assert result["replacements"] == 2  # title + table cell
+    outline = run("pptx_read.py", str(edited))
+    assert "Semi-Annual Review" in outline["slides"][0]["texts"]
+    assert outline["slides"][2]["tables"][0][2][0] == "West"
+    # formatting survives a run-level replace: red bold bullet untouched
+    assert any("Deep dive" in t for t in outline["slides"][1]["texts"])
+
+
+def test_edit_chart_data(deck, workdir):
+    spec = workdir / "chart_update.json"
+    write_json(spec, {"slide": 3, "chart": 0,
+                      "categories": ["Q3", "Q4"],
+                      "series": {"North": [30, 40], "South": [21, 34]}})
+    edited = workdir / "chart_edited.pptx"
+    run("pptx_edit.py", deck, "--output", str(edited),
+        "--chart-data", str(spec))
+    outline = run("pptx_read.py", str(edited))
+    bar = outline["slides"][3]["charts"][0]
+    assert bar["categories"] == ["Q3", "Q4"]
+    north = next(s for s in bar["series"] if s["name"] == "North")
+    assert north["values"] == [30.0, 40.0]
+
+
+def test_edit_remove_and_move_slide(deck, workdir):
+    edited = workdir / "reordered.pptx"
+    run("pptx_edit.py", deck, "--output", str(edited),
+        "--remove-slide", "2", "--move-slide", "2", "0")
+    outline = run("pptx_read.py", str(edited))
+    assert outline["slide_count"] == 3
+    # charts slide (was index 3, then 2 after removal) moved to front
+    assert len(outline["slides"][0]["charts"]) == 3
+    assert "Annual Review" in outline["slides"][1]["texts"]
+
+
+def test_edit_swap_image(deck, workdir):
+    import base64
+    blue = base64.b64decode(
+        "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGNg"
+        "YPj/HwADAgH/p5UronAAAAAASUVORK5CYII=")
+    blue_path = workdir / "blue.png"
+    blue_path.write_bytes(blue)
+    run("pptx_read.py", deck)
+    # find picture shape name via python-pptx directly
+    sys.path.insert(0, SCRIPTS)
+    from pptx import Presentation
+    from pptx.enum.shapes import MSO_SHAPE_TYPE
+    prs = Presentation(deck)
+    name = next(s.name for s in prs.slides[2].shapes
+                if s.shape_type == MSO_SHAPE_TYPE.PICTURE)
+    edited = workdir / "swapped.pptx"
+    run("pptx_edit.py", deck, "--output", str(edited),
+        "--swap-image", "2", name, str(blue_path))
+    out_dir = workdir / "swapped_images"
+    result = run("pptx_read.py", str(edited), "--images", str(out_dir))
+    with open(result["exported"][0], "rb") as fh:
+        assert fh.read() == blue
+
+
+def test_help_flags():
+    for script in ("pptx_create.py", "pptx_read.py", "pptx_edit.py",
+                   "pptx_from_template.py"):
+        proc = subprocess.run(
+            [sys.executable, os.path.join(SCRIPTS, script), "--help"],
+            capture_output=True, text=True, encoding="utf-8", check=False)
+        assert proc.returncode == 0 and "usage" in proc.stdout.lower()
+
+
+# ---------------------------------------------------------------------------
+# parity features: render, run-merge replace, chart ops, duplication,
+# polish (background/hyperlink/slide-number/footer), notes editing
+# ---------------------------------------------------------------------------
+
+def run_raw(script, *args):
+    env = dict(os.environ, LC_ALL="C", PYTHONIOENCODING="utf-8")
+    return subprocess.run(
+        [sys.executable, os.path.join(SCRIPTS, script), *args],
+        capture_output=True, text=True, encoding="utf-8", env=env, check=False)
+
+
+def test_render_all_slides(workdir):
+    import shutil
+    spec_path = workdir / "render_spec.json"
+    write_json(spec_path, {"slides": [
+        {"layout": "title", "title": "One"},
+        {"layout": "title_content", "title": "Two", "bullets": ["b"]},
+        {"layout": "blank"}]})
+    deck3 = workdir / "render_me.pptx"
+    run("pptx_create.py", str(spec_path), str(deck3))
+    out_dir = workdir / "render_out"
+    result = run("pptx_render.py", str(deck3), "--outdir", str(out_dir))
+    sys.path.insert(0, SCRIPTS)
+    from render import find_soffice
+    have_tools = find_soffice() and (
+        shutil.which("pdftoppm") or shutil.which("pdftocairo"))
+    if have_tools:
+        assert result["rendered"] is True
+        assert len(result["files"]) == 3
+        for png in result["files"]:
+            with open(png, "rb") as fh:
+                assert fh.read(8) == b"\x89PNG\r\n\x1a\n"
+    else:
+        assert result["rendered"] is False
+        assert result["missing"]
+        assert "guidance" in result
+
+
+def test_replace_across_identically_formatted_runs(workdir):
+    """A match split mid-word into equal-format runs keeps formatting."""
+    import copy as cp
+    from pptx import Presentation
+    from pptx.dml.color import RGBColor
+    from pptx.util import Inches, Pt
+
+    prs = Presentation()
+    slide = prs.slides.add_slide(prs.slide_layouts[6])
+    box = slide.shapes.add_textbox(Inches(1), Inches(1),
+                                   Inches(6), Inches(1))
+    para = box.text_frame.paragraphs[0]
+    run_obj = para.add_run()
+    run_obj.text = "Say TotalWord now"
+    run_obj.font.bold = True
+    run_obj.font.size = Pt(20)
+    run_obj.font.color.rgb = RGBColor.from_string("CC0000")
+    # simulate PowerPoint's spell-check split: same rPr, seam mid-match
+    second = cp.deepcopy(run_obj._r)
+    run_obj._r.addnext(second)
+    run_obj.text = "Say Total"
+    para.runs[1].text = "Word now"
+    path = workdir / "split_runs.pptx"
+    prs.save(str(path))
+
+    edited = workdir / "split_runs_edited.pptx"
+    result = run("pptx_edit.py", str(path), "--output", str(edited),
+                 "--replace-text", "TotalWord", "MergedWord")
+    assert result["replacements"] == 1
+
+    prs2 = Presentation(str(edited))
+    para2 = prs2.slides[0].shapes[0].text_frame.paragraphs[0]
+    assert "".join(r.text for r in para2.runs) == "Say MergedWord now"
+    for r in para2.runs:
+        assert r.font.bold is True
+        assert r.font.size == Pt(20)
+        assert str(r.font.color.rgb) == "CC0000"
+
+
+def test_chart_surgical_ops(deck, workdir):
+    from pptx import Presentation
+    spec = workdir / "chart_ops.json"
+    write_json(spec, {"slide": 3, "chart": 0, "ops": [
+        {"op": "update_series", "name": "North", "values": [99, 88]},
+        {"op": "add_series", "name": "East", "values": [1, 2]},
+        {"op": "remove_series", "name": "South"},
+        {"op": "rename_category", "from": "Q1", "to": "Q1 FY26"},
+        {"op": "set_title", "title": "Updated Sales"}]})
+    edited = workdir / "chart_ops.pptx"
+    run("pptx_edit.py", deck, "--output", str(edited),
+        "--chart-data", str(spec))
+    outline = run("pptx_read.py", str(edited))
+    bar = outline["slides"][3]["charts"][0]
+    assert bar["categories"] == ["Q1 FY26", "Q2"]
+    names = [s["name"] for s in bar["series"]]
+    assert "South" not in names and "East" in names
+    north = next(s for s in bar["series"] if s["name"] == "North")
+    assert north["values"] == [99.0, 88.0]
+    east = next(s for s in bar["series"] if s["name"] == "East")
+    assert east["values"] == [1.0, 2.0]
+    chart = next(s.chart for s in Presentation(str(edited)).slides[3].shapes
+                 if s.has_chart)
+    assert chart.chart_title.text_frame.text == "Updated Sales"
+
+
+def test_chart_op_unknown_series_fails(deck, workdir):
+    spec = workdir / "chart_bad.json"
+    write_json(spec, {"slide": 3, "chart": 0, "ops": [
+        {"op": "update_series", "name": "Nowhere", "values": [1, 2]}]})
+    proc = run_raw("pptx_edit.py", deck, "--output",
+                   str(workdir / "never.pptx"), "--chart-data", str(spec))
+    assert proc.returncode != 0
+    assert "Nowhere" in proc.stderr
+
+
+def test_duplicate_image_slide_is_independent(deck, workdir):
+    import base64
+    dup = workdir / "dup.pptx"
+    result = run("pptx_edit.py", deck, "--output", str(dup),
+                 "--duplicate-slide", "2")
+    assert result["duplicated_to"] == 4
+    outline = run("pptx_read.py", str(dup))  # re-opens cleanly
+    assert outline["slide_count"] == 5
+    s4 = outline["slides"][4]
+    assert len(s4["images"]) == 1
+    assert s4["tables"][0][0] == ["Region", "Sales"]
+    assert "Callout" in s4["texts"]
+
+    # independence: swap the image on the COPY, original stays red
+    blue = base64.b64decode(
+        "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGNg"
+        "YPj/HwADAgH/p5UronAAAAAASUVORK5CYII=")
+    blue_path = workdir / "blue2.png"
+    blue_path.write_bytes(blue)
+    from pptx import Presentation
+    from pptx.enum.shapes import MSO_SHAPE_TYPE
+    prs = Presentation(str(dup))
+    name = next(s.name for s in prs.slides[4].shapes
+                if s.shape_type == MSO_SHAPE_TYPE.PICTURE)
+    run("pptx_edit.py", str(dup), "--swap-image", "4", name,
+        str(blue_path))
+    prs = Presentation(str(dup))
+    orig = next(s for s in prs.slides[2].shapes
+                if s.shape_type == MSO_SHAPE_TYPE.PICTURE)
+    copy_pic = next(s for s in prs.slides[4].shapes
+                    if s.shape_type == MSO_SHAPE_TYPE.PICTURE)
+    assert copy_pic.image.blob == blue
+    assert orig.image.blob != blue
+
+
+def test_duplicate_chart_slide_refused(deck, workdir):
+    proc = run_raw("pptx_edit.py", deck, "--output",
+                   str(workdir / "never2.pptx"), "--duplicate-slide", "3")
+    assert proc.returncode != 0
+    assert "chart" in proc.stderr.lower()
+
+
+def test_create_polish_features(workdir):
+    from pptx import Presentation
+    spec_path = workdir / "polish.json"
+    write_json(spec_path, {"slides": [
+        {"layout": "title_content", "title": "Polished",
+         "background": "112233", "footer": "Confidential draft",
+         "slide_number": True,
+         "bullets": [{"text": "Visit example",
+                      "link": "https://example.com/info"}]}]})
+    out = workdir / "polish.pptx"
+    run("pptx_create.py", str(spec_path), str(out))
+    prs = Presentation(str(out))
+    slide = prs.slides[0]
+    assert str(slide.background.fill.fore_color.rgb) == "112233"
+    ph_idx = [ph.placeholder_format.idx for ph in slide.placeholders]
+    assert 12 in ph_idx  # slide number enabled
+    footer = next(ph for ph in slide.placeholders
+                  if ph.placeholder_format.idx == 11)
+    assert footer.text_frame.text == "Confidential draft"
+    link_runs = [r for sh in slide.shapes if sh.has_text_frame
+                 for p in sh.text_frame.paragraphs for r in p.runs
+                 if r.hyperlink.address]
+    assert link_runs[0].hyperlink.address == "https://example.com/info"
+
+
+def test_edit_polish_features(deck, workdir):
+    from pptx import Presentation
+    edited = workdir / "polish_edit.pptx"
+    result = run("pptx_edit.py", deck, "--output", str(edited),
+                 "--set-background", "0", "004400",
+                 "--hyperlink", "1", "Overview", "https://example.com/x",
+                 "--enable-slide-number", "1",
+                 "--set-footer", "1", "Footer via edit")
+    assert result["background_set"] and result["footer_set"]
+    assert result["hyperlinked_runs"] == 1
+    assert result["slide_number_enabled"] is True
+    prs = Presentation(str(edited))
+    assert str(prs.slides[0].background.fill.fore_color.rgb) == "004400"
+    s1 = prs.slides[1]
+    assert any(ph.placeholder_format.idx == 12 for ph in s1.placeholders)
+    footer = next(ph for ph in s1.placeholders
+                  if ph.placeholder_format.idx == 11)
+    assert footer.text_frame.text == "Footer via edit"
+    links = [r.hyperlink.address for sh in s1.shapes if sh.has_text_frame
+             for p in sh.text_frame.paragraphs for r in p.runs
+             if r.hyperlink.address]
+    assert links == ["https://example.com/x"]
+
+
+def test_set_and_append_notes(deck, workdir):
+    edited = workdir / "notes_edit.pptx"
+    result = run("pptx_edit.py", deck, "--output", str(edited),
+                 "--set-notes", "0", "Fresh notes")
+    assert result["notes_set"]
+    run("pptx_edit.py", str(edited), "--append-notes", "0", "Second line")
+    notes = run("pptx_read.py", str(edited), "--notes")
+    assert notes["notes"][0] == "Fresh notes\nSecond line"
+
+
+def test_render_help_flag():
+    proc = run_raw("pptx_render.py", "--help")
+    assert proc.returncode == 0 and "usage" in proc.stdout.lower()

package/skills/skill-create/SKILL.md

@@ -0,0 +1,114 @@
+---
+id: skill-create
+name: skill-create
+description: "创建自定义 Skill（SKILL.md），定义可复用的工作流程和指导"
+when_to_use: "用户想创建新的自定义 Skill 时使用"
+version: "1.1.0"
+tags:
+  - skill
+  - skill-creation
+  - workflow
+user_invocable: true
+disable_model_invocation: false
+metadata:
+  display-name: "Skill 创建"
+---
+
+# Skill 创建
+
+## 流程
+
+1. **确认需求** — 询问用户：
+   - 这个 Skill 做什么？（名称 + 一句话描述）
+   - 项目级还是全局？
+     - **项目级**: `{workdir}/.cteno/skills/{name}/SKILL.md` — 仅当前项目可用
+     - **全局**: 用户 Skill 根目录 `~/.cteno/skills/{name}/SKILL.md`（开发实例为 `~/.cteno-dev/<key>/skills`）— 所有项目可用
+   - 用户要和 Claude Code、Codex 等其他 Agent 在同一项目里共用时，改放标准目录 `{workdir}/.agents/skills/{name}/`。Cteno 也读它，同名时 `.cteno/skills` 优先
+   - 不要写进 `~/.agents/skills` 或 app 包里的内置目录：前者已不被加载，后者每次升级会被替换
+   - 与内置 Skill 同 id 即"覆盖内置"，只在用户明确要改写内置行为时这样做；删除这份即恢复内置
+
+2. **设计 Skill** — 根据需求确定：
+   - `name`: 小写字母、数字和连字符，≤64 字符，不以连字符开头或结尾，不含连续连字符，**必须与目录名一致**（如 `code-review`、`deploy-staging`）
+   - `description`: ≤1024 字符，同时写清"做什么"和"什么时候用"，包含触发短语。其他 Agent 只读这个字段决定是否加载
+   - 中文显示名放 `metadata.display-name`
+   - 步骤拆解：每步必须有**成功标准**
+   - 是否需要参数（`$arg_name` 替换）
+
+3. **写入文件** — 用 `shell` 工具创建目录和 SKILL.md
+
+4. **确认** — 告知用户 Skill 已创建，如何激活使用
+
+## SKILL.md 格式
+
+```markdown
+---
+name: skill-name
+description: "一句话说明做什么，再说明何时使用。例：部署到 staging 环境。用户说部署、发布、上线时使用。"
+# 以下为 Agent Skills 标准可选字段：
+# license: MIT
+# compatibility: "需要 git 和 docker"   # 环境要求，≤500 字符
+# allowed-tools: Bash(git:*) Read      # 空格分隔，预授权工具（实验性）
+metadata:
+  display-name: "显示名称"
+  version: "1.0.0"
+# 以下为 Cteno 扩展字段，其他 Agent 会忽略：
+# when_to_use: "更详细的触发说明"
+# user_invocable: true            # 用户可通过 skill tool 手动激活（默认 true）
+# disable_model_invocation: false  # 禁止模型自动激活（默认 false）
+# argument_hint: "[file] [target]" # 参数提示
+# context: fork                    # 执行上下文：inline（默认）或 fork（子 agent）
+# agent: worker                    # fork 时使用的 AgentKind
+---
+
+# Skill 标题
+
+简要描述这个 Skill 做什么。
+
+## 输入（如有参数）
+- `$filename`: 要处理的文件
+- `$target`: 部署目标
+
+## 目标
+明确的目标和完成标准。最好有具体的交付物。
+
+## 步骤
+
+### 1. 步骤名称
+具体说明要做什么。包含命令示例。
+
+**成功标准**: 如何确认此步完成，可以进入下一步。
+
+### 2. 第二步
+...
+
+### 3a. 并行步骤 A（与 3b 同时进行）
+...
+
+### 3b. 并行步骤 B
+...
+
+### 4. [用户] 确认并审批
+需要用户介入的步骤用 `[用户]` 标注。用于不可逆操作（合并、发布、删除）。
+```
+
+## 设计原则
+
+- **`description` 是最重要的字段** — 决定模型（包括其他 Agent）何时激活。写清做什么、何时用和触发短语；`when_to_use` 只做补充
+- **只用标准字段就能跨 Agent 使用** — 需要 Cteno 专属行为时再加扩展字段
+- **SKILL.md 控制在 500 行内** — 长参考资料放 `references/`，脚本放 `scripts/`，正文里写相对路径按需读取
+- **每步必须有成功标准** — 模型需要知道何时可以进入下一步
+- **简单 Skill 保持简单** — 2 步的 Skill 不需要在每步加复杂注解
+- **可并行步骤用子编号** — 3a, 3b 表示可同时执行
+- **不可逆操作加 `[用户]`** — 合并 PR、发送消息、删除文件等
+
+## 内置 Skill 参考
+
+默认启用的内置 Skill（避免重复创建；内置 Skill 直接从 app 包读取，可在技能页禁用，`skill-create`、`mcp`、`cteno-host-cli` 除外）：
+
+| ID | 名称 | 用途 |
+|----|------|------|
+| `skill-create` | Skill 创建 | 创建自定义 Skill |
+| `agent-create` | Agent 创建 | 创建自定义 Agent |
+| `mcp` | MCP Skill | 解析 MCP 文档并自动安装/注册 MCP Server |
+| `cteno-host-cli` | Host CLI | 跨 session 能力的 CLI 指南 |
+| `docx` / `pptx` / `xlsx` / `pdf` | 文档 | Word / PPT / Excel / PDF 创建、编辑与渲染检查 |

package/skills/video-generation/SKILL.md

@@ -0,0 +1,27 @@
+---
+id: video-generation
+name: video-generation
+description: "使用独立于聊天模型的视频后端生成、查询与下载视频，保持操作身份并检查实际文件规格。"
+when_to_use: "用户请求生成短视频、动画镜头或使用内置视频模型时。"
+version: "1.1.0"
+tags: [video, generation, media]
+user_invocable: true
+disable_model_invocation: false
+metadata:
+  display-name: "视频生成"
+---
+
+# 视频生成
+
+- 工具入口是 `generate_video`，后端与协议来自用户配置或托管目录，不从聊天模型或模型名字猜测。
+- 配置单源是 `cteno-host-cli profile --help` 的公共契约，GUI 和工具复用 daemon 能力；不得直接改配置文件或拼供应商 HTTP 绕过工具。
+- 先核对用户目标、时长、画幅、声音和预算。收费生成必须遵守确认门禁，未知价格不猜测。
+- 工具提供 submit/status/download/cancel 契约，但取消须协议验证通过：当前没有已验证的条件取消API，cancel会明确拒绝。Ark DELETE同时可删除终态记录，先GET queued不能排除完成竞态，禁止自行拼DELETE绕过；不假称已取消或退款。
+- submit 只调用一次并保存返回的 operationId。超时或不确定提交禁止用新 identity 重试；查询已有任务或报告待核对。执行器会持久保留提交 claim 防止重复收费。
+- status 查询到 succeeded 后再 download；下载失败只重试下载，绝不重新生成。下载必须由执行 daemon 直取供应商字节，不经过 Happy 服务器中转媒体。
+- 下载成功也不是验收。用 ffprobe 检查实际时长、宽高、音轨，抽帧检查画面与文字；工具返回的规格不是文件事实。
+- 最终交付本地确认过的 artifact 和规格摘要，区分任务成功、计费结算、文件下载和内容验收。没有实际文件不声称交付成功。
+- BYOK 协议只有 `ark-video-tasks`（火山方舟）与 `dashscope-video-synthesis`（阿里云百炼万相异步任务）；`openai-videos` 已随 OpenAI 下线不再提供，旧配置只保留可读。
+- 参考素材用 `references: [{ref, role}]`。`ref` 为对话里标注的 `media:<12位hex>` 句柄、工作目录内路径或 https URL，不传 base64。role：`first_frame`/`last_frame`/`reference_image`/`reference_video`/`reference_audio`。
+- 方舟：首尾帧模式不能与 reference_* 混用，尾帧需有首帧，上限 9 图/3 视频/3 音频。万相：仅支持 `first_frame` 与 `reference_audio`（音频限 wan2.5/2.6）。
+- 本地视频/音频文件暂无上传通道，需用 https URL；后端或协议不支持某个 role 时工具报错，不会丢弃参考素材改成纯文生视频，如实转述。

package/skills/xlsx/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Cteno
+Portions Copyright (c) 2026 Nous Research (scripts/ and tests/ adapted from the Hermes Agent productivity skills)
+Portions Copyright (c) 2026 MiniMaxAI (references adapted from MiniMax-AI/skills)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/xlsx/NOTICE.md

@@ -0,0 +1,8 @@
+# Sources for the office skills (docx, pptx, xlsx, pdf)
+
+- **Scripts and tests**: adapted from Nous Research Hermes Agent `skills/productivity/{docx,powerpoint,xlsx,pdf}` (MIT), upstream commit `bf0203a` (2026-10-22).
+- **Chinese typesetting, design and formatting references**: adapted from MiniMax-AI/skills `minimax-docx`, `pptx-generator`, `minimax-xlsx`, `minimax-pdf` (MIT); `xlsx/scripts/formula_check.py` from minimax-xlsx.
+- **Cteno additions**: `scripts/render.py` (isolated LibreOffice profile, macOS CJK font exposure and substitution), `scripts/cjk_fonts.py` (East Asian font slots), CJK handling in `docx_create.py` / `pptx_create.py` / `pdf_create.py`, 16:9 layout stretch in `pptx_create.py`, all `SKILL.md` texts.
+- Anthropic's document skills (proprietary licence) informed which pitfalls to cover; no text or code was copied from them.
+
+Not tracked live: to update, diff the upstream folders above against these copies and re-run each skill's `tests/` plus a render check.