monoco-toolkit 0.1.5__tar.gz → 0.1.7__tar.gz

monoco_toolkit-0.1.7/.agent/skills/monoco_core/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: monoco-core
+description: Monoco Toolkit 的核心技能。提供项目初始化、配置管理和工作空间管理的基础命令。
+---
+
+# 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
+
+## 配置结构
+
+配置以 YAML 格式存储在：
+
+- **全局**: `~/.monoco/config.yaml`
+- **项目**: `.monoco/config.yaml`
+
+关键配置段：
+
+- `core`: 编辑器、日志级别、作者
+- `paths`: 目录路径（issues, spikes, specs）
+- `project`: 项目元数据、spike repos、工作空间成员
+- `i18n`: 国际化设置
+- `agent`: Agent 框架集成设置
+
+## 最佳实践
+
+1. **优先使用 CLI 命令**，而不是手动编辑文件
+2. **配置更改后运行 `monoco sync`** 以更新 agent 环境
+3. **将 `.monoco/config.yaml` 提交到版本控制**，保持团队一致性
+4. **保持全局配置最小化** - 大多数设置应该是项目特定的

monoco_toolkit-0.1.7/.agent/skills/monoco_i18n/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: monoco-i18n
+description: 文档国际化质量控制。确保多语言文档保持同步。
+---
+
+# 文档国际化
+
+管理 Monoco 项目文档的国际化。
+
+## 概述
+
+I18n 功能提供：
+
+- **自动扫描**缺失的翻译
+- **标准化结构**用于多语言文档
+- **质量控制**以维护文档一致性
+
+## 核心命令
+
+### 扫描缺失的翻译
+
+```bash
+monoco i18n scan
+```
+
+扫描项目中的 markdown 文件并报告缺失的翻译。
+
+**输出**:
+
+- 列出没有对应翻译的源文件
+- 显示缺少哪些目标语言
+- 遵循 `.gitignore` 和默认排除规则
+
+## 配置
+
+I18n 设置在 `.monoco/config.yaml` 中配置：
+
+```yaml
+i18n:
+  source_lang: en # 源语言代码
+  target_langs: # 目标语言代码
+    - zh
+    - ja
+```
+
+## 文档结构
+
+### 根文件（后缀模式）
+
+对于项目根目录中的文件：
+
+- 源文件: `README.md`
+- 中文: `README_ZH.md`
+- 日文: `README_JA.md`
+
+### 子目录文件（目录模式）
+
+对于 `docs/` 或其他目录中的文件：
+
+```
+docs/
+├── en/
+│   ├── guide.md
+│   └── api.md
+├── zh/
+│   ├── guide.md
+│   └── api.md
+└── ja/
+    ├── guide.md
+    └── api.md
+```
+
+## 排除规则
+
+以下内容会自动从 i18n 扫描中排除：
+
+- `.gitignore` 模式（自动遵循）
+- `.references/` 目录
+- 构建产物（`dist/`, `build/`, `node_modules/`）
+- `Issues/` 目录
+
+## 最佳实践
+
+1. **先创建英文版**: 首先用源语言编写文档
+2. **遵循命名约定**: 使用适当的模式（后缀或目录）
+3. **定期运行扫描**: 使用 `monoco i18n scan` 验证覆盖率
+4. **提交所有语言**: 将翻译保存在版本控制中
+
+## 工作流程
+
+1. 用源语言（如英语）编写文档
+2. 按照命名约定创建翻译文件
+3. 运行 `monoco i18n scan` 验证所有翻译是否存在
+4. 修复扫描报告的任何缺失翻译

monoco_toolkit-0.1.7/.agent/skills/monoco_issue/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: monoco-issue
+description: Monoco Issue System 的官方技能定义。将 Issue 视为通用原子 (Universal Atom)，管理 Epic/Feature/Chore/Fix 的生命周期。
+---
+
+# 自我管理 (Monoco Issue System)
+
+使用此技能在 Monoco 项目中创建和管理 **Issue** (通用原子)。该系统参考 Jira 表达体系，同时保持 "建设者 (Builder)" 和 "调试者 (Debugger)" 思维模式的隔离。
+
+## 核心本体论 (Core Ontology)
+
+Monoco 不仅仅复刻 Jira，而是基于 **"思维模式 (Mindset)"** 重新定义工作单元。
+
+### 1. 战略层 (Strategy)
+
+#### 🏆 EPIC (史诗)
+
+- **Mindset**: _Architect_ (架构师)
+- **定义**: 跨越多个周期的宏大目标。它不是单纯的"大任务"，而是"愿景的容器"。
+- **产出**: 定义了系统的边界和核心价值。
+
+### 2. 价值层 (Value)
+
+#### ✨ FEATURE (特性)
+
+- **Mindset**: _Product Owner_ (产品负责人)
+- **定义**: 用户视角的价值增量。必须是可独立交付 (Shippable) 的垂直切片。
+- **Focus**: "Why" & "What" (用户想要什么？)。
+- **Prefix**: `FEAT-`
+
+### 3. 执行层 (Execution)
+
+#### 🧹 CHORE (杂务)
+
+- **Mindset**: _Builder_ (建设者)
+- **定义**: **不产生**直接用户价值的工程性事务。
+- **场景**: 架构升级、写构建脚本、修复 CI/CD 流水线。
+- **Focus**: "How" (为了支撑系统运转，必须做什么)。
+- **Prefix**: `CHORE-`
+
+_(取代了 Task 概念)_
+
+#### 🐞 FIX (修复)
+
+- **Mindset**: _Debugger_ (调试者)
+- **定义**: 预期与现实的偏差。它是负价值的修正。
+- **Focus**: "Fix" (恢复原状)。
+- **Prefix**: `FIX-`
+
+_(取代了 Bug 概念)_
+
+---
+
+**关系链**:
+
+- **主要**: `EPIC` (愿景) -> `FEATURE` (价值交付单元)
+- **次要**: `CHORE` (工程维护/支撑) - 通常独立存在。
+- **原子性原则**: Feature = Design + Dev + Test + Doc + i18n。它们是一体的。
+
+## 准则 (Guidelines)
+
+### 目录结构
+
+`Issues/{CapitalizedPluralType}/{lowercase_status}/`
+
+- `{TYPE}`: `Epics`, `Features`, `Chores`, `Fixes`
+- `{STATUS}`: `open`, `backlog`, `closed`
+
+### 路径流转
+
+使用 `monoco issue`：
+
+1. **Create**: `monoco issue create <type> --title "..."`
+
+   - Params: `--parent <id>`, `--dependency <id>`, `--related <id>`, `--sprint <id>`, `--tags <tag>`
+
+2. **Transition**: `monoco issue open/close/backlog <id>`
+
+3. **View**: `monoco issue scope`
+
+4. **Validation**: `monoco issue lint`
+
+5. **Modification**: `monoco issue start/submit/delete <id>`
+
+6. **Commit**: `monoco issue commit` (Atomic commit for issue files)

monoco_toolkit-0.1.7/.agent/skills/monoco_spike/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: monoco-spike
+description: 管理用于研究和学习的外部参考仓库。提供对精选代码库的只读访问。
+---
+
+# Spike (研究)
+
+在 Monoco 项目中管理外部参考仓库。
+
+## 概述
+
+Spike 功能允许你：
+
+- **添加外部仓库**作为只读参考
+- **同步仓库内容**到本地 `.references/` 目录
+- **访问精选知识**而不修改源代码
+
+## 核心命令
+
+### 添加仓库
+
+```bash
+monoco spike add <url>
+```
+
+将外部仓库添加为参考。仓库将被克隆到 `.references/<name>/`，其中 `<name>` 从仓库 URL 派生。
+
+**示例**:
+
+```bash
+monoco spike add https://github.com/example/awesome-project
+# 可在以下位置访问: .references/awesome-project/
+```
+
+### 同步仓库
+
+```bash
+monoco spike sync
+```
+
+从 `.monoco/config.yaml` 下载或更新所有配置的 spike 仓库。
+
+### 列出 Spikes
+
+```bash
+monoco spike list
+```
+
+显示所有配置的 spike 仓库及其同步状态。
+
+## 配置
+
+Spike 仓库在 `.monoco/config.yaml` 中配置：
+
+```yaml
+project:
+  spike_repos:
+    awesome-project: https://github.com/example/awesome-project
+    another-ref: https://github.com/example/another-ref
+```
+
+## 最佳实践
+
+1. **只读访问**: 永远不要编辑 `.references/` 中的文件。将它们视为外部知识。
+2. **精选选择**: 只添加高质量、相关的仓库。
+3. **定期同步**: 定期运行 `monoco spike sync` 以获取更新。
+4. **提交配置**: 将 spike 仓库 URL 添加到版本控制以保持团队一致性。
+
+## 使用场景
+
+- **从示例中学习**: 研究架构良好的代码库
+- **API 参考**: 在本地保存框架文档
+- **模式库**: 维护设计模式集合
+- **竞品分析**: 参考类似项目

monoco_toolkit-0.1.7/.claude/skills/monoco_core/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: monoco-core
+description: Monoco Toolkit 的核心技能。提供项目初始化、配置管理和工作空间管理的基础命令。
+---
+
+# 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
+
+## 配置结构
+
+配置以 YAML 格式存储在：
+
+- **全局**: `~/.monoco/config.yaml`
+- **项目**: `.monoco/config.yaml`
+
+关键配置段：
+
+- `core`: 编辑器、日志级别、作者
+- `paths`: 目录路径（issues, spikes, specs）
+- `project`: 项目元数据、spike repos、工作空间成员
+- `i18n`: 国际化设置
+- `agent`: Agent 框架集成设置
+
+## 最佳实践
+
+1. **优先使用 CLI 命令**，而不是手动编辑文件
+2. **配置更改后运行 `monoco sync`** 以更新 agent 环境
+3. **将 `.monoco/config.yaml` 提交到版本控制**，保持团队一致性
+4. **保持全局配置最小化** - 大多数设置应该是项目特定的

monoco_toolkit-0.1.7/.claude/skills/monoco_i18n/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: monoco-i18n
+description: 文档国际化质量控制。确保多语言文档保持同步。
+---
+
+# 文档国际化
+
+管理 Monoco 项目文档的国际化。
+
+## 概述
+
+I18n 功能提供：
+
+- **自动扫描**缺失的翻译
+- **标准化结构**用于多语言文档
+- **质量控制**以维护文档一致性
+
+## 核心命令
+
+### 扫描缺失的翻译
+
+```bash
+monoco i18n scan
+```
+
+扫描项目中的 markdown 文件并报告缺失的翻译。
+
+**输出**:
+
+- 列出没有对应翻译的源文件
+- 显示缺少哪些目标语言
+- 遵循 `.gitignore` 和默认排除规则
+
+## 配置
+
+I18n 设置在 `.monoco/config.yaml` 中配置：
+
+```yaml
+i18n:
+  source_lang: en # 源语言代码
+  target_langs: # 目标语言代码
+    - zh
+    - ja
+```
+
+## 文档结构
+
+### 根文件（后缀模式）
+
+对于项目根目录中的文件：
+
+- 源文件: `README.md`
+- 中文: `README_ZH.md`
+- 日文: `README_JA.md`
+
+### 子目录文件（目录模式）
+
+对于 `docs/` 或其他目录中的文件：
+
+```
+docs/
+├── en/
+│   ├── guide.md
+│   └── api.md
+├── zh/
+│   ├── guide.md
+│   └── api.md
+└── ja/
+    ├── guide.md
+    └── api.md
+```
+
+## 排除规则
+
+以下内容会自动从 i18n 扫描中排除：
+
+- `.gitignore` 模式（自动遵循）
+- `.references/` 目录
+- 构建产物（`dist/`, `build/`, `node_modules/`）
+- `Issues/` 目录
+
+## 最佳实践
+
+1. **先创建英文版**: 首先用源语言编写文档
+2. **遵循命名约定**: 使用适当的模式（后缀或目录）
+3. **定期运行扫描**: 使用 `monoco i18n scan` 验证覆盖率
+4. **提交所有语言**: 将翻译保存在版本控制中
+
+## 工作流程
+
+1. 用源语言（如英语）编写文档
+2. 按照命名约定创建翻译文件
+3. 运行 `monoco i18n scan` 验证所有翻译是否存在
+4. 修复扫描报告的任何缺失翻译

monoco_toolkit-0.1.7/.claude/skills/monoco_issue/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: monoco-issue
+description: Monoco Issue System 的官方技能定义。将 Issue 视为通用原子 (Universal Atom)，管理 Epic/Feature/Chore/Fix 的生命周期。
+---
+
+# 自我管理 (Monoco Issue System)
+
+使用此技能在 Monoco 项目中创建和管理 **Issue** (通用原子)。该系统参考 Jira 表达体系，同时保持 "建设者 (Builder)" 和 "调试者 (Debugger)" 思维模式的隔离。
+
+## 核心本体论 (Core Ontology)
+
+Monoco 不仅仅复刻 Jira，而是基于 **"思维模式 (Mindset)"** 重新定义工作单元。
+
+### 1. 战略层 (Strategy)
+
+#### 🏆 EPIC (史诗)
+
+- **Mindset**: _Architect_ (架构师)
+- **定义**: 跨越多个周期的宏大目标。它不是单纯的"大任务"，而是"愿景的容器"。
+- **产出**: 定义了系统的边界和核心价值。
+
+### 2. 价值层 (Value)
+
+#### ✨ FEATURE (特性)
+
+- **Mindset**: _Product Owner_ (产品负责人)
+- **定义**: 用户视角的价值增量。必须是可独立交付 (Shippable) 的垂直切片。
+- **Focus**: "Why" & "What" (用户想要什么？)。
+- **Prefix**: `FEAT-`
+
+### 3. 执行层 (Execution)
+
+#### 🧹 CHORE (杂务)
+
+- **Mindset**: _Builder_ (建设者)
+- **定义**: **不产生**直接用户价值的工程性事务。
+- **场景**: 架构升级、写构建脚本、修复 CI/CD 流水线。
+- **Focus**: "How" (为了支撑系统运转，必须做什么)。
+- **Prefix**: `CHORE-`
+
+_(取代了 Task 概念)_
+
+#### 🐞 FIX (修复)
+
+- **Mindset**: _Debugger_ (调试者)
+- **定义**: 预期与现实的偏差。它是负价值的修正。
+- **Focus**: "Fix" (恢复原状)。
+- **Prefix**: `FIX-`
+
+_(取代了 Bug 概念)_
+
+---
+
+**关系链**:
+
+- **主要**: `EPIC` (愿景) -> `FEATURE` (价值交付单元)
+- **次要**: `CHORE` (工程维护/支撑) - 通常独立存在。
+- **原子性原则**: Feature = Design + Dev + Test + Doc + i18n。它们是一体的。
+
+## 准则 (Guidelines)
+
+### 目录结构
+
+`Issues/{CapitalizedPluralType}/{lowercase_status}/`
+
+- `{TYPE}`: `Epics`, `Features`, `Chores`, `Fixes`
+- `{STATUS}`: `open`, `backlog`, `closed`
+
+### 路径流转
+
+使用 `monoco issue`：
+
+1. **Create**: `monoco issue create <type> --title "..."`
+
+   - Params: `--parent <id>`, `--dependency <id>`, `--related <id>`, `--sprint <id>`, `--tags <tag>`
+
+2. **Transition**: `monoco issue open/close/backlog <id>`
+
+3. **View**: `monoco issue scope`
+
+4. **Validation**: `monoco issue lint`
+
+5. **Modification**: `monoco issue start/submit/delete <id>`
+
+6. **Commit**: `monoco issue commit` (Atomic commit for issue files)

monoco_toolkit-0.1.7/.claude/skills/monoco_spike/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: monoco-spike
+description: 管理用于研究和学习的外部参考仓库。提供对精选代码库的只读访问。
+---
+
+# Spike (研究)
+
+在 Monoco 项目中管理外部参考仓库。
+
+## 概述
+
+Spike 功能允许你：
+
+- **添加外部仓库**作为只读参考
+- **同步仓库内容**到本地 `.references/` 目录
+- **访问精选知识**而不修改源代码
+
+## 核心命令
+
+### 添加仓库
+
+```bash
+monoco spike add <url>
+```
+
+将外部仓库添加为参考。仓库将被克隆到 `.references/<name>/`，其中 `<name>` 从仓库 URL 派生。
+
+**示例**:
+
+```bash
+monoco spike add https://github.com/example/awesome-project
+# 可在以下位置访问: .references/awesome-project/
+```
+
+### 同步仓库
+
+```bash
+monoco spike sync
+```
+
+从 `.monoco/config.yaml` 下载或更新所有配置的 spike 仓库。
+
+### 列出 Spikes
+
+```bash
+monoco spike list
+```
+
+显示所有配置的 spike 仓库及其同步状态。
+
+## 配置
+
+Spike 仓库在 `.monoco/config.yaml` 中配置：
+
+```yaml
+project:
+  spike_repos:
+    awesome-project: https://github.com/example/awesome-project
+    another-ref: https://github.com/example/another-ref
+```
+
+## 最佳实践
+
+1. **只读访问**: 永远不要编辑 `.references/` 中的文件。将它们视为外部知识。
+2. **精选选择**: 只添加高质量、相关的仓库。
+3. **定期同步**: 定期运行 `monoco spike sync` 以获取更新。
+4. **提交配置**: 将 spike 仓库 URL 添加到版本控制以保持团队一致性。
+
+## 使用场景
+
+- **从示例中学习**: 研究架构良好的代码库
+- **API 参考**: 在本地保存框架文档
+- **模式库**: 维护设计模式集合
+- **竞品分析**: 参考类似项目

monoco_toolkit-0.1.7/.gemini/skills/monoco_core/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: monoco-core
+description: Monoco Toolkit 的核心技能。提供项目初始化、配置管理和工作空间管理的基础命令。
+---
+
+# 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
+
+## 配置结构
+
+配置以 YAML 格式存储在：
+
+- **全局**: `~/.monoco/config.yaml`
+- **项目**: `.monoco/config.yaml`
+
+关键配置段：
+
+- `core`: 编辑器、日志级别、作者
+- `paths`: 目录路径（issues, spikes, specs）
+- `project`: 项目元数据、spike repos、工作空间成员
+- `i18n`: 国际化设置
+- `agent`: Agent 框架集成设置
+
+## 最佳实践
+
+1. **优先使用 CLI 命令**，而不是手动编辑文件
+2. **配置更改后运行 `monoco sync`** 以更新 agent 环境
+3. **将 `.monoco/config.yaml` 提交到版本控制**，保持团队一致性
+4. **保持全局配置最小化** - 大多数设置应该是项目特定的