Dowdiness Skills：面向MoonBit与编码工作流的智能体技能集合

一套精心整理的AI智能体技能库，专为MoonBit编程语言和多智能体编码工作流设计，提供可复用的知识模块和自动化脚本。

• 原作者/维护者：dowdiness
• 来源平台：GitHub
• 原始标题：skills
• 原始链接：https://github.com/dowdiness/skills
• 来源发布时间/更新时间：2026-06-13T08:14:40Z

---

在AI编程助手日益普及的今天，如何有效管理和复用智能体的知识能力成为一个重要课题。Dowdiness Skills 是一个精心整理的AI智能体技能集合仓库，专注于为MoonBit编程语言生态和多智能体编码工作流提供可复用的知识模块。该项目借鉴了Anthony Fu的antfu/skills仓库的设计理念，采用结构化的方式来组织、分发和维护智能体技能。

这个项目的独特价值在于它不仅仅是一个简单的提示词集合，而是一套完整的技能管理系统。每个技能都包含结构化的文档、明确的来源追踪、以及自动化的安装验证脚本。目前仓库包含18个精心设计的技能，覆盖MoonBit语言特性、代码重构、性能优化、错误处理等多个技术领域，同时还包括跨仓库协作和多智能体会话管理等通用工作流技能。

---

该仓库采用清晰的三层架构来组织技能内容，确保可维护性和可扩展性。

首先是skills/目录，这是最终可安装的技能输出目录。每个子目录代表一个独立技能，包含标准的SKILL.md文件。这种设计使得技能可以通过命令行工具直接安装到各种AI助手环境中，如Claude Code、Codex或其他兼容的智能体平台。

其次是sources/目录，用于存放生成或同步技能时使用的源仓库和笔记。这种分离设计允许技能内容从上游源自动同步，同时保持安装输出的稳定性。当源仓库更新时，维护者可以审查变更并有选择地同步到技能输出目录。

第三是vendor/目录，以Git子模块的形式引用上游或用户拥有的源仓库。当前包含的vendor源包括MoonBit官方的智能体指南仓库、以及维护者自己的MoonBit技能库和多个个人项目库。这种设计使得技能集合可以持续跟踪上游的最佳实践更新。

元数据管理方面，meta.ts文件记录了每个技能的来源信息，包括是手动维护的还是从vendor同步的。这种来源追踪机制对于理解技能的更新策略和维护责任至关重要。

---

MoonBit是近年来新兴的编程语言，专为云原生和边缘计算场景设计，具有编译速度快、产物体积小、类型系统强大等特点。该仓库围绕MoonBit构建了一个完整的技能家族，帮助AI助手更好地理解和辅助MoonBit开发。

语言基础技能包括moonbit-agent-guide，这是MoonBit官方的编码、项目结构和工具使用指南；moonbit-c-binding专注于原生C绑定和FFI（外部函数接口）的最佳实践；moonbit-traits则深入讲解MoonBit基于Self的trait系统的实用模式。

代码质量技能涵盖了多个关键领域。moonbit-refactoring提供符合MoonBit惯用法的重构指导；moonbit-refactoring-safety专注于跨边界重构时的安全规范；moonbit-deprecated-syntax跟踪已弃用的语法及其替代方案；moonbit-error-handling详细讲解错误类型、abort/fail/raise以及恢复边界的设计。

高级主题技能则面向有经验的开发者。moonbit-expression-problem探讨Finally Tagless和双层可扩展性模式在MoonBit中的实现；moonbit-opaque-types讲解不透明类型/新类型的公共API设计模式；moonbit-verification提供依赖管理、语法检查、测试和接口的质量清单；moonbit-perf-investigation则提供以测量为先的性能调查工作流。

项目启动技能方面，moonbit-agent-setup为Codex、Claude Code和通用智能体提供项目引导指令，确保AI助手在接触新项目时能够快速理解MoonBit项目的结构和约定。

运维技能moonbit-housekeeping是一个手动维护的技能，提供仓库维护工作流，包含基于BAML的worker输出解析器。该解析器使用PEP 723内联依赖声明，通过uv工具自动获取Python 3.13和baml-lib，无需手动pip安装。

---

除了MoonBit特定的技能外，仓库还包含几个通用的智能体工作流技能，这些技能可以跨项目复用。

handoff技能设计用于会话结束时的交接仪式。它帮助AI助手在会话结束前更新记忆文件、生成下一会话的提示词，并明确当前的就绪状态。这种设计对于长时间运行的项目或需要多会话协作的复杂任务尤为重要。

orchestrate技能专注于跨仓库和多智能体会话的设置。它提供委托检查点和worker输出接收机制，使得多个AI助手可以协调工作，避免冲突并确保任务的有序执行。

tuple-wrapper-api-style是一个关于元组包装器API风格的技能，用于设计稳定的公共构造函数和简洁的内部实现。这种模式在许多编程语言中都有应用，提供了API设计的一种通用最佳实践。

此外，仓库还包含针对维护者个人项目的技能：incr技能用于dowdiness/incr响应式库，loom技能用于dowdiness/loom解析器框架。这些"用户拥有的库技能"展示了如何将项目特定的知识封装为可复用的智能体技能。

---

该技能仓库支持多种安装方式，适应不同的使用场景。

对于通过GitHub发布的技能，可以使用Agent Skills CLI直接安装：

pnpx skills add dowdiness/skills --skill='*'

本地安装则需要先克隆仓库并运行安装脚本。项目使用Nushell（≥0.100）编写本地脚本，这是一种现代的shell语言，具有结构化数据处理能力。安装脚本会将skills/目录下的每个技能符号链接到常见的智能体技能目录，包括~/.agents/skills/、~/.claude/skills/和~/.codex/skills/。

卸载脚本则设计为仅删除指向本仓库的符号链接，避免误删其他来源的技能。如果安装过程中出现重复或冲突的技能路径，可以使用清理脚本进行安全修复，它会将冲突项备份到带时间戳的目录中，然后重新执行安装。

值得注意的是，moonbit-housekeeping技能的依赖管理采用了现代化的Python工具链。它使用uv作为Python包管理器，通过PEP 723内联依赖声明自动获取所需的Python版本和库。首次运行时会下载Python工具链和baml-lib，后续运行则使用本地缓存，无需手动pip安装。

---

这个技能仓库的设计体现了几个值得关注的技术理念。

首先是来源透明性。每个技能都有明确的来源标记（vendor或manual），vendor技能通过Git子模块跟踪上游，manual技能则完全由维护者控制。这种设计使得技能集合既能够吸收社区的最佳实践，又能保持核心技能的稳定性。

其次是安装即用的理念。技能不仅仅是文档，而是包含验证脚本和回归测试的完整包。例如moonbit-housekeeping技能包含测试夹具和回归测试脚本，确保技能在各种输入下都能正常工作。

第三是跨平台兼容性。安装脚本使用Nushell编写，这种现代shell语言具有跨平台特性，可以在macOS、Linux和Windows上运行。同时，项目提供了npm包装脚本，使得不熟悉Nushell的用户也可以通过npm命令执行安装和卸载操作。

第四是渐进式采用。技能设计为可以单独安装，用户可以根据需要选择特定的技能，而不必安装整个集合。这种模块化设计降低了采用门槛。

---