chendelian
c20d6498da
基于 disburse-payroll-icbc 实战经验沉淀，让所有未来新 skill 复制模板后直接 享受本系列全部改进： - record_screencast.py.sample: · 字幕脚本改用 "step: N/X" 模式 + ASCII 关键词锚（避免编码问题） · 展示三元组 (keyword, text, duration) 用法（依赖 platform-kit subtitle.py） · 加 TEST_FILE_NAME / MUSIC_SUBDIR 切换常量 · 文档说明绕开 SDK ask() / send_file 的最佳实践 - test_desktop_smoke.py.sample: · docstring 加"何时用此模板 / 何时改用 _with_attachment"指引 · 标注已知 SDK 限制（ask() user_idx<0 / send_file NotImplementedError） - test_desktop_smoke_with_attachment.py.sample（新增）: · 完整附件场景模板，import jiangchang_desktop_sdk.e2e_helpers 6 个 API · 7 步 step: N/7 模式，跟 record_screencast.py.sample 字幕脚本对齐 · 占位符 SKILL_SLUG / PROMPT / EXPECTED_KEYWORDS_IN_REPLY - README.md: 追加 3 节 · 模板选择指南（纯问答 vs 附件场景） · 已知 SDK 坑（send_file / ask / 字幕关键词 / bring_to_front） · 录屏新能力（activate_window / monitor_index / 字幕三元组） - conftest.py: 同步到支持新版 platform-kit src/ 布局的 SDK 路径推断 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
匠厂 技能开发模板（通用业务）
这是一个规范化的新技能模板仓库，用于复制出新的 skill 项目；它本身不是业务 skill。
模板目标
- 对齐当前规范 skill 的目录结构：
assets/、references/、scripts/、tests/、evals/ - 对齐当前规范脚手架分层：
scripts/cli、scripts/db、scripts/service、scripts/util、scripts/jiangchang_skill_core - 提供最小可运行入口：
python scripts/main.py health/version，以及通用任务命令骨架run/logs/log-get - 内置 隔离测试体系：
IsolatedDataRoot、双键环境、OPENCLAW_TEST_TARGET档位与 adapter profile 策略（详见references/TESTING.md） - 让新技能从一开始就按规范落地，不再沿用旧模板的
docs/、optional/、skill_main.py结构
新技能使用步骤
- 复制本目录为新的 skill 仓库。
- 全局替换
your-skill-slug、your-platform-key、您的技能显示名称等占位内容。 - 修改
SKILL.md、references/和scripts/util/constants.py。 - 在
scripts/service/task_service.py中实现真实业务编排与外部系统对接。 - 运行
python tests/run_tests.py -v，再执行python scripts/main.py health、version做最小验证。
如果你的技能在平台里默认是非公开的（access_scope = 0），建议在 SKILL.md 的 metadata.openclaw.developer_ids 中填写开发者用户 ID 列表。这样在正式发布后，平台会为这些开发者补可见权限，避免「技能已上架但开发者自己在市场中看不到」。
开发教程入口：
目录说明
| 路径 | 用途 |
|---|---|
SKILL.md |
技能清单与触发说明模板 |
assets/ |
示例输出与轻量 schema |
references/ |
面向用户与编排的文档模板 |
scripts/ |
规范分层后的代码骨架 |
tests/ |
单元测试与分层测试范式（默认根目录 unittest） |
evals/ |
人工/半自动评估材料 |
.github/workflows/release_skill.yaml |
标准发布工作流 |
release.ps1 |
对齐现有 skill 的发布脚本入口 |
最小命令
python scripts/main.py health
python scripts/main.py version
注意
- 不要再往模板里引入旧式
docs/或optional/目录。 - 新技能若不需要某些目录，也建议先保留结构，再按实际业务填充内容。
metadata.openclaw.developer_ids是发布元数据，不是用户展示文案；用于非公开技能的开发者默认可见授权。- 发起
release.ps1之前，务必确认python tests/run_tests.py -v已全部通过。