petrezhu/secretary-cold-skills
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Secretary 用户级冷技能库 — ColdSkill 能力单元(0 token 确定性应答)
11 commits 1 branch 0 tags 122 KiB
  • Python 100%
Find a file
Exact
petrezhu 57667e9d56 perf: econ_indicators — 30min缓存，冷启动10.5s→命中0s
2026-09-20 12:19:08 +08:00
econ_indicators perf: econ_indicators — 30min缓存，冷启动10.5s→命中0s 2026-09-20 12:19:08 +08:00
holiday_query feat: holiday_query — 查询最近节假日 2026-09-16 11:05:18 +08:00
solar_term feat: solar_term — 查询当前节气 2026-09-16 09:49:48 +08:00
usd_cny fix: usd_cny — 汇率字段索引parts[3]非parts[4] 2026-09-18 17:25:03 +08:00
week_number_query fix: week-number-query → week_number_query — loader要求snake_case 2026-09-16 02:35:55 +08:00
.gitignore chore: gitignore pycache 2026-09-18 17:21:34 +08:00
README.md init: ColdSkill 仓库约定 — README + 环境变量契约 2026-09-10 02:05:34 +08:00

README.md

Secretary Cold Skills 仓库

Secretary 的用户级**冷技能（ColdSkill）**库。冷技能 = 由规则引擎执行的确定性能力单元，0 token、LLM 永不接触。由 Secretary 的"候选挖掘 → 采纳/撤销"命令自动生成与维护，也可人工编写。

目录布局

/cold-skills/
  <skill-id>/            # 一个冷技能 = 一个目录
    skill.json           # manifest（自描述：id/mode/keywords/description/...）
    script.py            # 仅 script 模式
    test_script.py       # 仅 script 模式（必须）

技能三模式

模式 形态 触发 测试要求
literal 仅 manifest + 内嵌 replies 关键词精确全等 → 固定文案 免测试
attach 仅 manifest，target + 追加关键词 关键词 → 已有核心意图 handler 免测试
script manifest + script.py（`run(ctx) -> str None`） 任意触发词 → 确定性逻辑

manifest 最小示例（literal）

{
  "id": "cxo-faq",
  "version": 1,
  "description": "CXO与QDII关系问答",
  "keywords": ["CXO是什么", "qdii和cxo的关系"],
  "mode": "literal",
  "replies": ["CXO指代医药研发外包…"],
  "enabled": true,
  "tags": ["财富", "faq"]
}

环境变量约定

  • SECRETARY_COLD_SKILLS_DIR：本仓库克隆目录。Secretary 的 ColdSkillLoader 从该路径热加载技能（默认 /root/git/secretary-cold-skills）。未设置或路径缺失时冷技能层静默禁用。

暂存与版本管理

  • 每一次"采纳建议/撤销技能"都是一次 git commit + push。
  • 双远端：origin(Forgejo 主) + github(备份)。