AI 应用CLI开发工具【免费下载链接】ccusagenpx ccusage项目地址https://gitcode.com/gh_mirrors/cc/ccusage点击查看免费下载本篇技术指南以 ccusage 仓库的.agents/skills/skill-creator/SKILL.md为核心系统讲解在该仓库中如何为 AI Agent 编写、组织与维护仓库本地技能repo-local skills。你将掌握 skill 的目录权威来源、frontmatter 触发机制、正文编写原则与行数预算审计方法并能结合nix/agent-skills.nix、根目录AGENTS.md与justfile理解整套 skill 体系的落地机制。skill 的权威来源与生成关系ccusage 仓库采用“单一权威来源source of truth 生成产物”的 skill 管理模型.agents/skills/是仓库本地 skill 的唯一权威来源所有 skill 都应在该目录下以skill-name/SKILL.md的形式存在。.claude/skills是由 Nix dev-shell 钩子通过agent-skills-nix自动生成的镜像目录已被 gitignore严禁直接编辑或提交。这一机制在nix/agent-skills.nix中有完整实现仓库通过nix-filter将.agents/skills单独包含进 skill 源nix/agent-skills.nix随后经agentLib.discoverCatalog、allowlistFor与selectSkills完成技能发现与筛选最终由mkBundle生成ccusage-agent-skills-bundle并通过localTargets.claude的structure link即软链接方式写入.claude/skills。仓库刻意不提供全局agent-skills-nix目标也不在这里做 git-hook 技能同步nix/agent-skills.nix。实战提醒修改 skill 时始终编辑.agents/skills/下的源文件。这一点在development/SKILL.md的 gotchas 中也被列为高频踩坑点——.claude/skills是生成物保持不提交即可。何时新增、何时扩展现有 skill新增 skill 的判据是当重复性的仓库工作需要一个工作流、一组本地参考、命令序列或策略且这些内容需要按需加载时就值得建一个 skill反之则应扩展现有 skill。仓库根目录AGENTS.md的Skill Routing列表给出了现成的路由案例developmentmonorepo 布局与 just 配方、rustcrate 与 adapter 实现、typescriptTS/JS 代码、agent-sources各 Agent 日志格式与成本模式、testing测试、tdd红绿重构循环、commitConventional Commits、create-prPR 全流程、fix-ciCI 修复等均遵循“一行路由 具体技能文件”的粒度划分。新增技能前先对照此列表避免重复造轮子。添加或编辑 skill 的标准流程按skill-creator/SKILL.md的规定标准流程为五步撰写主体文件创建.agents/skills/skill-name/SKILL.md包含 frontmatter 与精简的 Markdown 正文。拆分条件性细节将冗长的检查清单、API 说明、示例等内容移入references/*.md并在SKILL.md中以一行“何时阅读”的说明链接每个参考文件见commit/skills的references/git-apply.md、references/push.md布局以及testing的references/rust.md、references/node-test.md布局。脚本化确定性重复操作把机械性、可重复的操作放进scripts/而不是写成大段散文。仓库中的scripts/validate-commit-scope.nu即是一例——它是 commit-msg 钩子调用的 Nushell 脚本用于校验提交 subject 的 scope 与暂存路径的所有权是否匹配。登记路由将新 skill 加入根目录AGENTS.md的 Skill Routing 列表保证 Agent 可以发现并路由到它。格式化编辑完成后运行just fmt。在根目录justfile中该配方执行nix fmt通过 treefmt 统一格式化 Nix、Rust、JS/TS、工作流与 typos。Frontmatter 规范描述即发现机制每个SKILL.md的 frontmatter 携带两个必填字段name与description并支持两个可选路由字段。description第三方的触发描述description是 skill 的主要发现机制使用第三人称长度约20–35 词同时说明“技能做什么”与“具体触发条件”文件类型、命令、任务类别。一个仅写着 “Use for tests” 的裸标签会让 Agent 无法完成路由。由于 frontmatter 总是被加载应将其控制在接近 Anthropic 约 100 词的预算内。仓库内的实际案例可作对照typescriptskill 的 description 为 “Guides ccusage TypeScript and JavaScript work. Use before reading or editing .ts, .tsx, .js, or .jsx files, including the npm launcher, Node tests, build and fixture scripts, mocks, and typed literals.”——它同时覆盖了功能描述与文件类型触发条件。paths 与 globs跨运行时的路由提示可选路由字段包括pathsClaude 风格的文件匹配规则可以是逗号分隔的 glob 列表或 YAML 列表globs作为跨运行时兼容性提示。参见typescript/SKILL.md的示例--- name: typescript description: Guides ccusage TypeScript and JavaScript work. ... paths: - **/*.ts - **/*.tsx - **/*.js - **/*.jsx globs: *.ts,*.tsx,*.js,*.jsx ---注意Codex 风格的发现机制只读取description因此触发条件也必须出现在description中不能仅依赖paths/globs。正文编写原则只写 Agent 无法自行推导的内容正文只应包含 Agent 无法自行推导的信息带精确 flag 的命令、需要读取的文件、容易遗漏的本地约定、有意的历史决策、变更后应满足的验证标准。重复陈述模型已具备的通用最佳实践只会与任务上下文竞争注意力。渐进式披露Progressive Disclosure根目录AGENTS.md在每次会话都会加载因此它只保留 Agent 在“动手之前”就需要知道的内容仓库形态、路由、易踩的坑。任何只有在任务开始后才重要的细节都应归属到负责该任务的 skill 中。仓库实践与此对应根AGENTS.md只保留 Skill Routing 列表与仓库形态、策略概述而development、commit等 skill 则承接具体的命令序列与工作流细节。一条规则只有一个家One Home per Rule同一条规则若同时出现在AGENTS.md与某个 skill 中会造成 token 双倍消耗且容易漂移AGENTS.md保留一行式路由skill 保留规则本体两个 skill 之间用名称互相引用而不是复制内容只有当下两侧都无法独立支撑其触发条件时才合并。指向真实代码而非转述“指向真实代码”是正文编写的核心要求引用rust/adapters/codex/src/loader.rs、某个 fixture 或现有测试胜过一段转述模式的文字。例如commitskill 将补丁暂存细节直接指向references/git-apply.md并给出git apply --check、git apply --cached -v等可执行命令。绝不转录 CLI 帮助用法行、flag 列表、子命令表格会迅速过时且 Agent 完全可以自己运行tool --help。skill 应当写帮助输出给不出的判断性内容——何时使用该工具、多个工具中选哪个——并指向该工具本身。外部文档链接而非粘贴当外部 URL 自解释时应将其单独成行、不加标题、不加摘要句仅当读者需要知道“为什么/何时打开”时才补充上下文。这与仓库中 skill 正文将外部阅读材料如关于 context engineering 的讨论单独列出、不粘贴原文的做法一致。在引用外部资源时应遵循同样的克制原则给链接而非搬运全文。行数预算与审计命令部分 Agent 可能只预览文件的前 200 行因此行数预算被硬性规定为每个SKILL.md控制在160 行以内每个references/*.md控制在180 行以内路由、安全与工作流说明放在示例与背景资料之前按决策点或工作流阶段拆分长材料但经常一起阅读的细节应放在同一文件中避免强迫 Agent 多次打开参考文件必须直接从SKILL.md链接嵌套的引用链可能被遗漏。审计长度的标准命令为fd . .agents/skills -t f -e md -x wc -l {} | sort -nr该命令递归统计.agents/skills下所有 Markdown 文件的行数并按降序排列可快速发现超过预算的文件。与仓库工程体系的联动skill-creator并不是孤立存在的它与仓库的其他工程设施深度联动生成机制nix/agent-skills.nix中的syncAgentSkills会检查.claude/skills是否已作为普通目录存在存在则报错要求先移除然后以软链接方式安装 Nix 托管的 skill。这与“.claude/skills是生成物”的规则互相印证。路由登记新增 skill 必须在根AGENTS.md的 Skill Routing 列表登记否则 Agent 无法发现它——这与skill-creator流程的第 4 步完全对应。格式化入口just fmtnix fmttreefmt是编辑后必跑的校验步骤nix/git-hooks.nix中的ccusage-treefmt钩子也在 pre-commit 阶段强制执行同一套格式化。文档影响评估当变更触及用户可观察的界面命令、选项、报告模式、配置键、JSON 字段、截图时还需按docs/SKILL.md评估 README、docs/guide/页面与 VitePress 导航是否需要同步更新。总结ccusage 仓库的 skill 体系以.agents/skills/为权威来源通过 Nix 机制生成.claude/skills镜像每个 skill 依靠高质量description与可选的paths/globs实现跨运行时路由正文遵循渐进式披露、规则单家、指向真实代码、不转录 CLI 帮助等原则并以 160/180 行的行数预算保证按需加载的高效性。按照本文的五步流程与审计命令你可以在该仓库中可持续地创建和维护高质量、可被 Agent 准确发现与引用的本地技能。赞分享AI 应用CLI开发工具【免费下载链接】ccusagenpx ccusage项目地址https://gitcode.com/gh_mirrors/cc/ccusage点击查看免费下载相关推荐verl 项目 GitHub Issue 创建与维护规范基于 Agent Skill 的完整工作流指南verl 项目 GitHub Issue 创建与维护规范基于 Agent Skill 的完整工作流指南 verlHybridFlow是一个面向大模型强化学人工智能大模型强化学习RLHF分布式训练微调DeepCode 如何创建并管理 Agent Skills.agents/skills 与 $skill-creatorDeepCode 如何创建并管理 Agent Skills.agents/skills 与 $skill creator 在 DeepCode 里Ski人工智能大模型AI AgentAgent 框架多智能体代码智能体代码生成工具调用MCP ClientsMCP 服务桌面应用AI 评测深入 .NET Agent Skills 仓库面向 Skill 与 Agent 贡献者的完整指南深入 .NET Agent Skills 仓库面向 Skill 与 Agent 贡献者的完整指南 本指南以仓库根目录的 CONTRIBUTING.md htt人工智能AI 技能AI 评测Benchmark开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考