关于 distilly
distilly 是用于创建、更新和管理人物或关系技能的 Agent skill。它为兼容的宿主提供分步流程,并将生成的文件保存在用户工作区中。
主要功能
- 01按请求选择创建、更新或管理流程
- 02将生成技能保存在工作区目录
- 03通过专用写入工具处理技能文件
- 04避免在对话中收集凭据
- 05支持多个指定的 Agent 宿主
适用场景
- 01根据人物或资料创建技能
- 02用新文件或更正更新技能
- 03查看、回滚或删除生成的技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ titanwings/ distilly --skill distilly安装后在 Claude Code 中输入/distilly确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.gitignoreCITATION.cff.npmrcCONTRIBUTING.mdLICENSEROADMAP.mdINSTALL_EN.mdINSTALL.mdREADME.mdpackage.json.github/PULL_REQUEST_TEMPLATE.md.github/ISSUE_TEMPLATE/config.ymlbug_report.mdfeature_request.mdquestion.md.github/workflows/publish-package.ymlci.ymlbin/distilly.mjsdocs/assets/hosts/README.mddocs/assets/sources/README.mddocs/lang/README_DE.mdREADME_ES.mdREADME_KO.mdREADME_RU.mdREADME_PT.mdREADME_JA.mdREADME_ZH.mdprompts/celebrity/budget_unfriendly/audit.mdpersona_builder.mdpersona_analyzer.md详细介绍
语言:这些说明以英语编写。请根据用户的第一条消息识别其语言,并始终使用该语言回复用户。
技能根目录:在阅读捆绑提示词或运行捆绑脚本之前,先解析宿主实际加载的
SKILL.md所在的绝对目录。以下说明中的{distilly_skill_root}指该确切目录。Claude Code 会将其作为${CLAUDE_SKILL_DIR}提供;在其他宿主上,请使用该宿主的发现上下文提供的已加载技能路径。不要假定 shell 的当前工作目录就是技能根目录,也不要猜测或硬编码安装路径。如果宿主未提供已加载路径,或存在多个无法明确区分的 Distilly 安装,请先询问用户要使用哪个活动安装,然后再运行代码。
将 shell 保持在用户当前的工作区中,以便
./skills/...等相对输出路径仍位于项目内。将所有tools/...和prompts/...资源解析为相对于{distilly_skill_root}的路径。例如,运行tools/owner_profile.py时,使用python3 "{distilly_skill_root}/tools/owner_profile.py";在实际工具调用中,将占位符替换为已解析的绝对路径。
Distilly Creator
Distilly 曾用名为 Colleague Skill / colleague-skill。当前 Skill frontmatter 中的名称和创作者入口均为
distilly。
确定请求流程
只阅读请求所需的流程文件,然后按其指引操作。
| 用户请求 | 流程 |
|---|---|
| “Set up my profile” / “Get to know me” / “Who am I to you”、“distill myself”,或宿主首次运行且尚无所有者档案 | prompts/flows/owner.md |
/distilly、“Help me create a skill”、“Create a new skill”、“I want to distill someone”、“Make a skill for XX” | prompts/flows/create.md(其中的 Step 0 会将 owner 引导回所有者流程) |
“I have new files” / “append”、“That's wrong” / “He wouldn't do that” / “He should be”、/update-skill {character} {slug},或别名 /update-colleague {slug} | prompts/flows/evolve.md |
| “Show my skills”、回滚或删除已生成的技能 | prompts/flows/manage.md |
创建流程会调用 prompts/flows/sources.md 来导入材料;对于 celebrity,还会调用 prompts/flows/celebrity_research.md。每个流程都会列出所需提示词;等流程进行到相应步骤时再阅读,不要提前阅读。
所有流程通用规则
- 存储:生成的技能保存在用户工作区中的
./skills/colleague/{slug}/、./skills/relationship/{slug}/或./skills/celebrity/{slug}/下。若使用全局路径,请通过--base-dir指定该类别的存储根目录。 - 写入:只能通过
tools/skill_writer.py创建和更新生成的技能;切勿手动构建或编辑其文件。 - 凭据:App Secrets、访问令牌或刷新令牌、Bot Tokens 和 OAuth 代码绝不能出现在对话中。切勿向用户索要这些信息;应让用户在自己的终端中运行采集器的
--setup/--login。详情见prompts/flows/sources.md。
兼容的宿主
Claude Code、OpenClaw、Hermes、Codex、DeepSeek Harness、Pi coding agent、Grok Build 和 OpenCode。在 Claude Code、Hermes、DeepSeek Harness 和 Grok Build 中使用 /distilly 调用;在 OpenClaw 中使用 /distilly 或 /skill distilly;在 Codex 中使用 $distilly 或 /skills;在 Pi 中使用 /skill:distilly。OpenCode 原生加载 Skills,没有专用命令。Grok Bot 无法直接导入此目录;不要将此仓库描述为可安装到 Grok Bot。