给 AI Agent 装上可复用的技能
365Skill 是我们的 Agent Skills 实验仓库:SKILL.md 标准格式、deny-by-default 发布策略、evals 验证体系。开源、可装、可改——我们自己跑 Agent 的方式,原样交给你。
什么是 Agent Skills
Agent Skill 是给 AI 代理的「岗位说明书」:一个目录,一份 SKILL.md,写清什么时候用、按什么步骤做、带什么资源。
SKILL.md 标准格式
一份带 frontmatter 的 Markdown:name 与 description 决定触发时机,正文写清步骤、约束与输出格式。Agent 能执行,人也能读。
按需加载,不占上下文
Agent 平时只看到技能名与描述,任务匹配时才读全文。技能可以打包流程说明、确定性脚本与参考文件,用到才加载。
跨客户端通用
开放目录格式,Claude Code / Codex / Cursor 等主流编程代理公认支持。写一次,进 git、能开源、可版本化。
仓库里的三个技能
均为 Experimental:结构完整、通过验证,触发率与实战表现仍在打磨。
discover-project-skills
盘点项目现有技能,发现可复用实践,经你确认后萃取为可移植技能包。内置 python 结构扫描器,发现与审计默认只读。
five-step-dev
五步开发流:Research → Plan → Implement → Review → Verify。风险分级、计划先批、证据化验证,高强度模型只花在关键决策上(zh-CN)。
five-step-retro
五步复盘自迭代环:运行日志 + 六维复盘 + 证据支撑的改进提案,人类批准的升级才会回流仓库(zh-CN)。
工程特色
deny-by-default 发布策略
公开仓库是私有源仓库的确定性导出:只有 catalog/publication-policy.json 白名单列出的技能才会发布,CI 拒绝未列名的技能目录、evals 与引用。
evals 触发测试
每个技能配 10 正 10 负中英文用例:该触发时触发,不该触发时不误触。结构校验、单测、真实仓库扫描全过才算数。
安全边界
扫描器不读取、不输出 .env*、凭据文件、私钥与密钥库,也排除依赖目录与构建产物。发现与审计默认只读,写文件必须经你明确确认。
三分钟装好
技能是普通目录,没有包管理器黑魔法。
克隆仓库
git clone https://github.com/laojin1900/365Skill.gitApache-2.0,随意 fork、改动、再发布。
链接进 Agent 的技能目录
ln -s "$PWD/skills/discover-project-skills" ~/.codex/skills/以 Codex 为例,也可以直接复制目录;Claude Code / Cursor 等其他客户端,按其官方文档的技能路径放置。
直接调用
新任务里说「用 $discover-project-skills 扫描当前仓库」即可触发。更多客户端适配说明见仓库 README。
觉得有用?Star 支持一下
star / fork / issue 都欢迎;想看它在整个产品族里的位置,去产品页。