monoco_atom_core

Monoco Toolkit的核心技能。提供项目初始化、配置管理与工作空间管理的基础命令。

SKILL.md

--- frontmatter

name: monoco_atom_core
description: Monoco Toolkit 的核心技能。提供项目初始化、配置管理和工作空间管理的基础命令。
type: atom
version: 1.0.0

Monoco 核心

Monoco Toolkit 的核心功能和命令。

概述

Monoco 是一个开发者生产力工具包，提供:

•项目初始化: 标准化的项目结构
•配置管理: 全局和项目级别的配置
•工作空间管理: 多项目设置

核心命令

项目设置

•
monoco init: 初始化新的 Monoco 项目
- •创建 .monoco/ 目录及默认配置
- •设置项目结构（Issues/, .references/ 等）
- •生成初始文档

配置管理

•
monoco config: 管理配置
- •monoco config get <key>: 查看配置值
- •monoco config set <key> <value>: 更新配置
- •支持全局（~/.monoco/config.yaml）和项目（.monoco/config.yaml）作用域

Agent 集成

•
monoco sync: 与 agent 环境同步
- •将系统提示注入到 agent 配置文件（GEMINI.md, CLAUDE.md 等）
- •分发 skills 到 agent 框架目录
- •遵循 i18n.source_lang 的语言配置
•
monoco uninstall: 清理 agent 集成
- •从 agent 配置文件中移除托管块
- •清理已分发的 skills

Git 工作流集成

Monoco 强制执行 Feature Branch 工作流以确保代码隔离和质量:

•
monoco init: 自动安装 Git Hooks
- •pre-commit: 运行 Issue Linter 和代码格式检查
- •pre-push: 执行测试套件和完整性验证
- •所有 Hooks 可通过 .monoco/config.yaml 配置
•
分支隔离策略:
- •⚠️ 强制要求: 使用 monoco issue start <ID> --branch 创建隔离环境
- •自动创建规范化分支名: feat/<id>-<slug>
- •主干保护: Linter 会阻止在 main/master 分支上的直接代码修改
•
文件追踪: monoco issue sync-files 自动同步 Git 变更到 Issue 元数据

📖 详细工作流: 参见 monoco-issue skill 获取完整的 Issue 生命周期管理指南。

配置结构

配置以 YAML 格式存储在:

•全局: ~/.monoco/config.yaml
•项目: .monoco/config.yaml

关键配置段:

•core: 编辑器、日志级别、作者
•paths: 目录路径（issues, spikes, specs）
•project: 项目元数据、spike repos、工作空间成员
•i18n: 国际化设置
•agent: Agent 框架集成设置

最佳实践

基础操作

•优先使用 CLI 命令，而不是手动编辑文件
•配置更改后运行 monoco sync 以更新 agent 环境
•将 .monoco/config.yaml 提交到版本控制，保持团队一致性
•保持全局配置最小化 - 大多数设置应该是项目特定的

Git 工作流 (⚠️ CRITICAL for Agents)

•
严格遵循分支隔离:
- •✅ 始终使用: monoco issue start <ID> --branch
- •❌ 禁止在 main/master 分支直接修改代码
- •📝 提交前运行: monoco issue sync-files 更新文件追踪
•
质量门禁:
- •Git Hooks 会自动运行检查,不要尝试绕过 (--no-verify)
- •提交前确保 monoco issue lint 通过
- •使用 monoco issue submit 生成交付报告