AgentSmith插件市场：面向Claude Code的自动化工作流工具集

一个专为AgentSmith代理团队设计的Claude Code插件市场，提供知识库管理、GitHub工作流、Fly.io部署等自动化技能，采用无头优先设计哲学。

项目背景与定位\n\n随着Claude Code等AI编程助手的普及，开发者开始探索如何将AI能力深度集成到日常开发工作流中。然而，通用的AI助手往往缺乏针对特定技术栈和工作流程的定制化能力。\n\nagentsmith-plugins项目应运而生，它是一个专为AgentSmith代理团队打造的Claude Code插件市场。该项目采用MIT许可证开源，旨在为运行AgentSmith代理的各类主机（Fly机器、家庭服务器、未来开发环境）提供即插即用的自动化技能。\n\n## 核心设计理念\n\n### 技能优先于命令\n\n该项目采用"技能（Skills）而非斜杠命令"作为核心交互模式。技能会被加载到模型的可用技能列表中，通过意图触发；而斜杠命令则仅在需要确定性操作工作流时少量添加。这种设计让AI能够更自然地理解用户意图，而不是强迫用户记忆特定的命令语法。\n\n### AgentSmith专属定制\n\n这些运行手册假设特定的AgentSmith部署环境：tod-smith Fly应用、/.secondbrain知识库、SmithFamilyPlayground GitHub组织，以及daily/YYYY-MM-DD分支工作流。如果用户运行不同的技术栈，可以fork并适配这些插件。\n\n### 无头优先（Headless-First）\n\n技能必须在systemd用户单元或Fly容器等无GUI环境中工作。任何依赖图形界面的工具都会被排除在外，确保自动化流程可以在纯命令行环境中无缝运行。\n\n## 插件体系详解\n\n### agentsmith-vault：知识库工作流\n\n状态：初始版本可用\n\n这是每个AgentSmith代理都必须启用的核心插件，定义了代理如何写入/.secondbrain知识库。主要功能包括：\n\n- vault-commit.sh：标准化的提交脚本，确保知识库更新的一致性\n- Frontmatter管理：自动处理文档元数据，支持分类和标签\n- Daily-branch生命周期：按日期组织的分支管理策略，便于追踪每日工作\n- Raw/不可变性原则：确保原始内容的完整性，防止意外修改\n\n这个插件解决了AI代理在长期运行中如何有效管理和检索知识的核心问题，为构建可累积的智能系统奠定了基础。\n\n### agentsmith-gh：GitHub工作流自动化\n\n状态：初始版本可用\n\n专为GitHub CLI设计的运行手册，涵盖代码协作的各个方面：\n\n- PR规范：定义提交信息格式、分支命名约定和审查清单\n- 自动审查与日报工作流：自动化的代码审查流程和每日工作汇总\n- 规则集感知：与GitHub的规则集功能集成，确保合规性\n- Actions故障排查：提供GitHub Actions失败时的诊断和修复指南\n- clean-gone技能：自动清理已合并或废弃的分支，保持仓库整洁\n\n这个插件将繁琐的GitHub操作封装成可复用的技能，让AI代理能够自主管理代码仓库的日常维护工作。\n\n### agentsmith-fly：Fly.io部署运维\n\n状态：初始版本可用\n\n针对Fly.io平台的运行手册，涵盖应用部署和运维的完整生命周期：\n\n- 应用架构解析：理解Fly.io的虚拟机模型和网络拓扑\n- 持久化存储：管理Fly.io的卷存储和数据库连接\n- Tailscale网络拓扑：在Fly.io环境中配置安全的私有网络\n- 密钥轮换：包括VAULT_*变量的特殊处理，以及Telegram轮询器的唯一性保证\n- 部署与回滚：标准化的部署流程和快速回滚机制\n- 故障排查：常见问题的诊断和修复方案\n\n对于使用Fly.io托管应用的团队，这个插件提供了生产环境运维的最佳实践封装。\n\n### agentsmith-sprites-dev：Sprites.dev适配\n\n状态：占位符阶段\n\n这是为AgentSmith适配的sprites.dev运行手册，目前处于规划阶段。未来将提供与Sprites.dev平台集成的自动化技能。\n\n## 安装与使用\n\n添加插件市场源：\n\nbash\nclaude plugin marketplace add SmithFamilyPlayground/agentsmith-plugins\n\n\n安装特定插件：\n\nbash\nclaude plugin install agentsmith-vault@agentsmith-plugins\n\n\n这种模块化的安装方式让用户可以按需选择所需技能，避免不必要的依赖加载。\n\n## 技术价值与影响\n\nagentsmith-plugins项目展示了AI原生开发工具链的演进方向。通过将最佳实践封装成可复用的技能，它让AI代理能够承担更多传统上需要人类开发者手动执行的运维工作。\n\n对于采用类似技术栈的团队，这个项目提供了可参考的实现模式。即使不使用完全相同的工具组合，其"技能优先"和"无头优先"的设计哲学也值得借鉴。\n\n## 未来展望\n\n根据项目路线图，后续PR将逐步完善三个占位符插件（agentsmith-sprites-dev以及规划中针对Doppler的插件）。随着Claude Code生态的成熟，预计会有更多针对特定技术栈的插件加入这个市场。\n\n该项目的开源性质也意味着社区可以贡献自己的插件，形成围绕AgentSmith的插件生态系统。这种开放协作模式有望加速AI原生开发工具的标准化和普及。

项目背景与定位\n\n随着Claude Code等AI编程助手的普及，开发者开始探索如何将AI能力深度集成到日常开发工作流中。然而，通用的AI助手往往缺乏针对特定技术栈和工作流程的定制化能力。\n\nagentsmith-plugins项目应运而生，它是一个专为AgentSmith代理团队打造的Claude Code插件市场。该项目采用MIT许可证开源，旨在为运行AgentSmith代理的各类主机（Fly机器、家庭服务器、未来开发环境）提供即插即用的自动化技能。\n\n核心设计理念\n\n技能优先于命令\n\n该项目采用"技能（Skills）而非斜杠命令"作为核心交互模式。技能会被加载到模型的可用技能列表中，通过意图触发；而斜杠命令则仅在需要确定性操作工作流时少量添加。这种设计让AI能够更自然地理解用户意图，而不是强迫用户记忆特定的命令语法。\n\nAgentSmith专属定制\n\n这些运行手册假设特定的AgentSmith部署环境：tod-smith Fly应用、/.secondbrain知识库、SmithFamilyPlayground GitHub组织，以及daily/YYYY-MM-DD分支工作流。如果用户运行不同的技术栈，可以fork并适配这些插件。\n\n无头优先（Headless-First）\n\n技能必须在systemd用户单元或Fly容器等无GUI环境中工作。任何依赖图形界面的工具都会被排除在外，确保自动化流程可以在纯命令行环境中无缝运行。\n\n插件体系详解\n\nagentsmith-vault：知识库工作流\n\n状态：初始版本可用\n\n这是每个AgentSmith代理都必须启用的核心插件，定义了代理如何写入/.secondbrain知识库。主要功能包括：\n\n- vault-commit.sh：标准化的提交脚本，确保知识库更新的一致性\n- Frontmatter管理：自动处理文档元数据，支持分类和标签\n- Daily-branch生命周期：按日期组织的分支管理策略，便于追踪每日工作\n- Raw/不可变性原则：确保原始内容的完整性，防止意外修改\n\n这个插件解决了AI代理在长期运行中如何有效管理和检索知识的核心问题，为构建可累积的智能系统奠定了基础。\n\nagentsmith-gh：GitHub工作流自动化\n\n状态：初始版本可用\n\n专为GitHub CLI设计的运行手册，涵盖代码协作的各个方面：\n\n- PR规范：定义提交信息格式、分支命名约定和审查清单\n- 自动审查与日报工作流：自动化的代码审查流程和每日工作汇总\n- 规则集感知：与GitHub的规则集功能集成，确保合规性\n- Actions故障排查：提供GitHub Actions失败时的诊断和修复指南\n- clean-gone技能：自动清理已合并或废弃的分支，保持仓库整洁\n\n这个插件将繁琐的GitHub操作封装成可复用的技能，让AI代理能够自主管理代码仓库的日常维护工作。\n\nagentsmith-fly：Fly.io部署运维\n\n状态：初始版本可用\n\n针对Fly.io平台的运行手册，涵盖应用部署和运维的完整生命周期：\n\n- 应用架构解析：理解Fly.io的虚拟机模型和网络拓扑\n- 持久化存储：管理Fly.io的卷存储和数据库连接\n- Tailscale网络拓扑：在Fly.io环境中配置安全的私有网络\n- 密钥轮换：包括VAULT_*变量的特殊处理，以及Telegram轮询器的唯一性保证\n- 部署与回滚：标准化的部署流程和快速回滚机制\n- 故障排查：常见问题的诊断和修复方案\n\n对于使用Fly.io托管应用的团队，这个插件提供了生产环境运维的最佳实践封装。\n\nagentsmith-sprites-dev：Sprites.dev适配\n\n状态：占位符阶段\n\n这是为AgentSmith适配的sprites.dev运行手册，目前处于规划阶段。未来将提供与Sprites.dev平台集成的自动化技能。\n\n安装与使用\n\n添加插件市场源：\n\nbash\nclaude plugin marketplace add SmithFamilyPlayground/agentsmith-plugins\n\n\n安装特定插件：\n\nbash\nclaude plugin install agentsmith-vault@agentsmith-plugins\n\n\n这种模块化的安装方式让用户可以按需选择所需技能，避免不必要的依赖加载。\n\n技术价值与影响\n\nagentsmith-plugins项目展示了AI原生开发工具链的演进方向。通过将最佳实践封装成可复用的技能，它让AI代理能够承担更多传统上需要人类开发者手动执行的运维工作。\n\n对于采用类似技术栈的团队，这个项目提供了可参考的实现模式。即使不使用完全相同的工具组合，其"技能优先"和"无头优先"的设计哲学也值得借鉴。\n\n未来展望\n\n根据项目路线图，后续PR将逐步完善三个占位符插件（agentsmith-sprites-dev以及规划中针对Doppler的插件）。随着Claude Code生态的成熟，预计会有更多针对特定技术栈的插件加入这个市场。\n\n该项目的开源性质也意味着社区可以贡献自己的插件，形成围绕AgentSmith的插件生态系统。这种开放协作模式有望加速AI原生开发工具的标准化和普及。