{"id":34979208,"url":"https://github.com/kofj/aivcraft","last_synced_at":"2026-04-27T19:33:50.872Z","repository":{"id":329725205,"uuid":"1120492307","full_name":"kofj/aivcraft","owner":"kofj","description":"The engineering tool for software engineers to effortlessly manage skills and configurations in the multi-agent era.","archived":false,"fork":false,"pushed_at":"2025-12-21T16:02:21.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-23T03:18:04.790Z","etag":null,"topics":["claude-code","skills"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kofj.png","metadata":{"files":{"readme":"README-zh.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-21T10:38:53.000Z","updated_at":"2025-12-21T16:02:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kofj/aivcraft","commit_stats":null,"previous_names":["kofj/aivcraft"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kofj/aivcraft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kofj%2Faivcraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kofj%2Faivcraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kofj%2Faivcraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kofj%2Faivcraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kofj","download_url":"https://codeload.github.com/kofj/aivcraft/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kofj%2Faivcraft/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32352398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T17:12:42.749Z","status":"ssl_error","status_checked_at":"2026-04-27T17:12:41.658Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","skills"],"created_at":"2025-12-27T00:51:44.432Z","updated_at":"2026-04-27T19:33:50.867Z","avatar_url":"https://github.com/kofj.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AIV Craft 智能工坊\n\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/kofj/aivcraft)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-20)\n![GitHub Release](https://img.shields.io/github/v/release/kofj/aivcraft)\n\n\u003e 为软件工程师打造，轻松驾驭多 Agent 时代的技能与配置工程化工具。\n\n## 核心问题\n\n如果你和我们一样，日常会在多个 AI Agent（如 Claude Code, codex, Code Buddy）之间切换，你可能会体会到一种琐碎的“摩擦”：\n*   **配置混乱**：一个典型的开发场景，假如我们想为团队的三种主流 SWE Agent 配置同一个“执行 Python 脚本”的技能：\n    *   对于 **Anthropic 的 Claude Code**，你需要创建一个技能文件夹，并在其中包含一个 `SKILL.md` 文件来描述技能指令，然后将这个文件夹放进 `~/.claude/skills` 目录。\n    *   对于 **Tencent 的 Code Buddy**，你需要将同样的技能指令写成 Markdown 文件，然后把它放进 `~/.codebuddy/agents` 目录，并在 Frontmatter 中定义其元数据。\n    *   对于 **OpenAI 的 Codex Agent**，你需要创建一个 `AGENTS.md` 文件，并在其中描述该技能，确保 Agent 能够读取并理解。\n    \u003e *每一种工具，都有一套完全不同的技能“方言”，知识和配置完全无法复用。*\n*   **知识孤岛**：优秀的技能和提示词无法在团队内有效沉淀、共享和推广。\n*   **缺少工程化**：整个过程依赖“手工作坊”模式，难以实现版本化、自动化和快速复现。\n\n## AIV Craft 是什么？\n\nAIV Craft 是一个遵循“配置即代码”理念的、管理 AI Agent 技能的“Homebrew”。\n\n它通过一个统一的 `aivcraft.yaml` 文件，让你能够以声明式的方式，集中管理所有 Agent 的技能、仓库源和环境配置，并通过 `aivcraft` 命令行一键应用，将您从繁琐的配置工作中解放出来。\n\n## ✨ 核心特性\n\n*   **声明式与可复现**：通过一份 `aivcraft.yaml` 作为“真理之源”，保证团队环境一致。\n*   **跨 Agent 兼容**：通过“安装器”架构，一套技能可无缝应用到 Claude Code, codex 等不同工具。\n*   **开放的技能生态**：支持官方中心仓库和用户自定义的第三方/私有技能仓库。\n*   **分层配置**：通过全局配置 (`~/.aivcraft/...`) 与项目配置 (`aivcraft.yaml`) 的结合，兼顾个人习惯与团队规范。\n*   **CLI + GUI**：提供强大的 `aivcraft` 命令行用于自动化，并辅以直观的图形界面用于浏览和管理（GUI 将在后续版本中提供）。\n\n## 🚀 快速上手 (MVP 阶段)\n\n### 第一步：安装\n\n我们推荐 macOS 用户使用 Homebrew 进行安装。\n\n**macOS (推荐)**\n```bash\n# 添加我们的 Tap 源 (假设您的 Homebrew 仓库名为 homebrew-aivcraft)\nbrew tap kofj/aivcraft/aivcraft\nbrew install aivcraft\n```\n\n**Linux / macOS (备选)**\n您也可以使用我们的安装脚本进行安装：\n```bash\ncurl -fsSL https://raw.githubusercontent.com/kofj/aivcraft/main/install.sh | sh\n```\n\n**Windows**\n我们将在后续版本中提供对 Winget / Scoop 或 MSI 安装包的支持。\n\n### 第二步：初始化项目\n\n在你的项目目录下，生成一份 `aivcraft.yaml` 示例文件。\n```bash\naivcraft init\n```\n生成的 `aivcraft.yaml` 示例如下：\n```yaml\n# aivcraft.yaml\n\n# 1. 声明本项目需要哪些 Agent\nagents:\n  - claude-code\n  - aider\n\n# 2. 声明本项目需要哪些技能\nskills:\n  # 从官方中心仓库安装\n  - center:git/pro-commit-message\n  # 你也可以添加自己的技能仓库源 (在全局配置文件中定义)\n  # - my-repo:frontend/react-helper\n```\n\n### 第三步：应用配置\n\nAIV Craft 将自动为你配置好一切。\n```bash\naivcraft apply\n```\n\n## 命令行参考 (核心)\n\n*   `aivcraft init`: 在当前目录初始化一份项目级 `aivcraft.yaml` 配置文件。\n*   `aivcraft apply`: 应用当前项目及全局的配置，将变更同步到所有声明的 Agent。\n*   `aivcraft repo add \u003cname\u003e \u003curl\u003e`: 添加一个新的技能仓库源，此操作会更新您的**全局**配置文件。\n*   `aivcraft repo list`: 显示当前生效的所有技能仓库源（已合并全局和项目配置）。\n*   `aivcraft install --global \u003cskill_name\u003e`: 安装一个全局技能，该技能将在您所有的项目中生效。\n*   `aivcraft config set --global \u003ckey\u003e \u003cvalue\u003e`: 设置一项全局配置，例如 `model gpt-4o` 或 `api_keys.openai env(OPENAI_API_KEY)`。\n\n## 🛣️ 路线图\n\nAIV Craft 目前尚处于早期开发阶段，我们正全力以赴实现 MVP 的核心功能。在未来，我们希望围绕以下方向进行探索和演进：\n\n*   **扩展 Agent 支持**：为更多主流的 AI Agent（如 Cursor 等）提供官方安装器支持。\n*   **构建技能生态**：丰富官方中心仓库的技能数量与质量，并降低社区贡献技能的门槛。\n*   **完善 GUI 体验**：提供一个成熟、易用的图形化界面，用于技能的发现、管理和配置。\n*   **探索团队协作**：探索面向团队的技能共享、权限管理与服务托管（如 MCP）方案。\n\n## 🤝 如何贡献\n\nAIV Craft 是一个开源项目，我们欢迎任何形式的贡献！\n\n*   **提交 Issue**：分享您遇到的问题或新功能想法。\n*   **开发安装器**：为 AIV Craft 贡献代码，特别是支持新 Agent 的“安装器”插件。\n*   **贡献技能**：向我们的官方技能中心仓库提交高质量、通用的技能包。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkofj%2Faivcraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkofj%2Faivcraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkofj%2Faivcraft/lists"}