monoco-toolkit 0.3.11__py3-none-any.whl → 0.4.0__py3-none-any.whl

monoco/features/memo/resources/zh/skills/monoco_workflow_note_processing/SKILL.md

@@ -1,140 +0,0 @@
----
-name: monoco_workflow_note_processing
-description: Memo 笔记处理工作流 (Flow Skill)。定义从捕获 fleeting notes 到组织归档的标准操作流程，确保想法有效管理。
-type: workflow
-domain: memo
-version: 1.0.0
----
-
-# Note Processing Workflow
-
-Memo 笔记处理的标准化工作流，确保 "Capture → Process → Organize → Archive/Convert" 流程。
-
-## 工作流状态机
-
-```mermaid
-stateDiagram-v2
-    [*] --> Capture: 想法闪现
-    
-    Capture --> Process: 定期整理
-    Capture --> Capture: 继续记录
-    
-    Process --> Organize: 分类完成
-    Process --> Archive: 无价值<br/>(直接归档)
-    
-    Organize --> Convert: 可执行
-    Organize --> Organize: 需补充<br/>(完善信息)
-    Organize --> Archive: 纯参考<br/>(归档保存)
-    
-    Convert --> [*]: 转为 Issue
-    
-    Archive --> [*]: 归档完成
-```
-
-## 执行步骤
-
-### 1. Capture (捕获)
-
-- **目标**: 快速记录 fleeting ideas，不中断当前工作
-- **输入**: 想法、灵感、代码片段、链接
-- **输出**: Memo 记录
-- **检查点**:
-  - [ ] 使用 `monoco memo add "内容"`
-  - [ ] 保持简洁，无需详细描述
-  - [ ] 添加上下文（`-c file:line` 如适用）
-  - [ ] 不中断当前任务流
-
-### 2. Process (处理)
-
-- **目标**: 定期回顾和分类 Memo
-- **策略**: 定期整理（每日/每周）
-- **检查点**:
-  - [ ] 运行 `monoco memo list` 查看所有 Memo
-  - [ ] 评估每个 Memo 的价值
-  - [ ] 分类：可执行 / 纯参考 / 无价值
-  - [ ] 补充缺失信息
-
-### 3. Organize (组织)
-
-- **目标**: 对有价值的 Memo 进行结构化整理
-- **策略**: 根据类型选择处理方式
-- **检查点**:
-  - [ ] 为相关 Memo 添加标签或分类
-  - [ ] 合并相似的 Memo
-  - [ ] 完善模糊的记录
-  - [ ] 设置优先级（如适用）
-
-### 4. Archive/Convert (归档或转化)
-
-- **目标**: 处理完毕的 Memo 归档或转化为 Issue
-- **检查点**:
-  - [ ] **Convert**: 可执行的想法转为 Issue
-    - 使用 `monoco issue create feature/chore/fix -t "标题"`
-    - 在 Issue 中引用原始 Memo
-  - [ ] **Archive**: 纯参考内容归档保存
-    - 移动到知识库或文档
-    - 从 Memo 列表中移除
-  - [ ] **Delete**: 无价值的 Memo 直接删除
-
-## 决策分支
-
-| 条件 | 动作 |
-|------|------|
-| 想法可执行 | Convert，创建 Issue |
-| 纯参考资料 | Archive，保存到知识库 |
-| 无价值/过时 | Delete，直接删除 |
-| 信息不完整 | 返回 Organize，补充信息 |
-
-## 合规要求
-
-- **必须**: Memo 是临时的，不应无限堆积
-- **必须**: 可执行的想法必须转为 Issue 追踪
-- **建议**: 定期处理（建议每周）
-- **建议**: 保持 Memo 简洁，避免长篇大论
-
-## 相关命令
-
-```bash
-# 添加 Memo
-monoco memo add "考虑使用 Redis 缓存用户会话"
-
-# 带上下文的 Memo
-monoco memo add "递归可能导致栈溢出" -c "src/utils.py:42"
-
-# 查看所有 Memo
-monoco memo list
-
-# 编辑 Memo
-monoco memo open
-
-# 创建 Issue（转化 Memo）
-monoco issue create feature -t "实现 Redis 缓存"
-```
-
-## 使用场景
-
-| 场景 | 使用 Memo | 后续处理 |
-|------|-----------|----------|
-| 代码审查时的改进建议 | `memo add "重构建议: ..."` | Process → Convert to Issue |
-| 会议中的临时想法 | `memo add "想法: ..."` | Process → Organize → Convert |
-| 有用的代码片段 | `memo add "Snippet: ..."` | Process → Archive to 知识库 |
-| 技术文章链接 | `memo add "Read: https://..."` | Process → Archive |
-| Bug 线索 | `memo add "可能的 Bug: ..."` | Process → Convert to Fix Issue |
-
-## 与 Issue 的区别
-
-| 维度 | Memo | Issue |
-|------|------|-------|
-| 目的 | 记录想法 | 追踪任务 |
-| 生命周期 | 临时，需定期清理 | 正式，完整生命周期 |
-| 完成标准 | 归档或转化 | 验收标准通过 |
-| 复杂度 | 简单，一句话 | 详细，有 AC 和 Tasks |
-| 追踪 | 无 | 完整追踪 |
-
-## 最佳实践
-
-1. **及时记录**: 想法闪现时立即记录，避免遗忘
-2. **定期整理**: 每周至少处理一次 Memo 列表
-3. **快速转化**: 有价值的想法尽快转为 Issue
-4. **果断删除**: 过时或无价值的 Memo 果断删除
-5. **保持简洁**: Memo 是速记，不需要详细描述

monoco/features/spike/resources/en/skills/monoco_atom_spike/SKILL.md

@@ -1,76 +0,0 @@
----
-name: monoco_atom_spike
-description: Manage external reference repositories for research and learning. Provides read-only access to curated codebases.
-type: atom
-version: 1.0.0
----
-
-# Spike (Research)
-
-Manage external reference repositories in Monoco projects.
-
-## Overview
-
-The Spike feature allows you to:
-
-- **Add external repositories** as read-only references
-- **Sync repository content** to local `.references/` directory
-- **Access curated knowledge** without modifying source code
-
-## Key Commands
-
-### Add Repository
-
-```bash
-monoco spike add <url>
-```
-
-Adds an external repository as a reference. The repository will be cloned to `.references/<name>/` where `<name>` is derived from the repository URL.
-
-**Example**:
-
-```bash
-monoco spike add https://github.com/example/awesome-project
-# Available at: .references/awesome-project/
-```
-
-### Sync Repositories
-
-```bash
-monoco spike sync
-```
-
-Downloads or updates all configured spike repositories from `.monoco/config.yaml`.
-
-### List Spikes
-
-```bash
-monoco spike list
-```
-
-Shows all configured spike repositories and their sync status.
-
-## Configuration
-
-Spike repositories are configured in `.monoco/config.yaml`:
-
-```yaml
-project:
-  spike_repos:
-    awesome-project: https://github.com/example/awesome-project
-    another-ref: https://github.com/example/another-ref
-```
-
-## Best Practices
-
-1. **Read-Only Access**: Never edit files in `.references/`. Treat them as external knowledge.
-2. **Curated Selection**: Only add high-quality, relevant repositories.
-3. **Regular Sync**: Run `monoco spike sync` periodically to get updates.
-4. **Commit Configuration**: Add spike repo URLs to version control for team consistency.
-
-## Use Cases
-
-- **Learning from Examples**: Study well-architected codebases
-- **API Reference**: Keep framework documentation locally
-- **Pattern Library**: Maintain a collection of design patterns
-- **Competitive Analysis**: Reference similar projects

monoco/features/spike/resources/en/skills/monoco_workflow_research/SKILL.md

@@ -1,121 +0,0 @@
----
-name: monoco_workflow_research
-description: Spike Research Workflow (Flow Skill). Defines the standard operational process from adding external repositories to knowledge extraction and archiving, ensuring effective management of external knowledge.
-type: workflow
-domain: spike
-version: 1.0.0
----
-
-# Research Workflow
-
-Standardized workflow for Spike research, ensuring the "Add → Sync → Analyze → Extract → Archive" process.
-
-## Workflow State Machine
-
-```mermaid
-stateDiagram-v2
-    [*] --> Add: Discover reference repository
-    
-    Add --> Sync: Configuration added
-    Add --> Add: Invalid URL<br/>(re-enter)
-    
-    Sync --> Analyze: Sync completed
-    Sync --> Sync: Sync failed<br/>(network/permission)
-    
-    Analyze --> Extract: Analysis completed
-    Analyze --> Analyze: Content mismatch<br/>(re-evaluate)
-    
-    Extract --> Archive: Knowledge extraction completed
-    
-    Archive --> [*]: Archiving completed
-```
-
-## Execution Steps
-
-### 1. Add (Add Repository)
-
-- **Goal**: Add external repository as reference
-- **Input**: Repository URL, reference purpose
-- **Output**: Configuration updated
-- **Checkpoints**:
-  - [ ] Verify repository URL is accessible
-  - [ ] Confirm repository is relevant to current project
-  - [ ] Run `monoco spike add <url>`
-  - [ ] Check `.monoco/config.yaml` is updated
-
-### 2. Sync (Synchronize)
-
-- **Goal**: Download or update reference repository content
-- **Checkpoints**:
-  - [ ] Run `monoco spike sync`
-  - [ ] Verify repository is cloned to `.references/<name>/`
-  - [ ] Check sync logs for errors
-  - [ ] Verify file permissions are correct (read-only)
-
-### 3. Analyze (Analysis)
-
-- **Goal**: Research the structure and content of reference repository
-- **Strategy**: Systematic browsing and marking
-- **Checkpoints**:
-  - [ ] Browse overall repository structure
-  - [ ] Identify modules relevant to current project
-  - [ ] Mark valuable code patterns
-  - [ ] Record architectural design highlights
-
-### 4. Extract (Knowledge Extraction)
-
-- **Goal**: Extract usable knowledge from reference repository
-- **Strategy**: Document valuable findings
-- **Checkpoints**:
-  - [ ] Extract key code snippets (without modifying original files)
-  - [ ] Record design patterns and best practices
-  - [ ] Create learning notes (using Memo or Issue)
-  - [ ] Annotate knowledge source (repository URL + Commit)
-
-### 5. Archive (Archiving)
-
-- **Goal**: Organize and archive research results
-- **Checkpoints**:
-  - [ ] Update project documentation, referencing the repository
-  - [ ] Create knowledge index (if needed)
-  - [ ] Run `monoco spike list` to verify status
-  - [ ] Periodically clean up references no longer needed
-
-## Decision Branches
-
-| Condition | Action |
-|-----------|--------|
-| Invalid URL | Return to Add, check URL format |
-| Sync failed | Check network, permissions, retry or skip |
-| Content not relevant | Remove from configuration, reselect |
-| Important pattern discovered | Create Issue, plan to introduce to project |
-
-## Compliance Requirements
-
-- **Prohibited**: Editing any files in `.references/`
-- **Required**: All external knowledge must be annotated with source
-- **Required**: Regular synchronization to get updates
-- **Recommended**: Only add high-quality, relevant repositories
-
-## Related Commands
-
-```bash
-# Add reference repository
-monoco spike add <url>
-
-# Sync all repositories
-monoco spike sync
-
-# List configured repositories
-monoco spike list
-
-# Record research findings
-monoco memo add "Discovery: {insight}" -c "spike:{repo_name}"
-```
-
-## Best Practices
-
-1. **Selective Choice**: Only add repositories highly relevant to the project
-2. **Read-only Access**: Treat `.references/` as external knowledge base, never modify
-3. **Regular Sync**: Run `monoco spike sync` monthly to get updates
-4. **Knowledge Transformation**: Transform learned patterns into actual project improvements

monoco/features/spike/resources/zh/skills/monoco_atom_spike/SKILL.md

@@ -1,76 +0,0 @@
----
-name: monoco_atom_spike
-description: 管理用于研究和学习的外部参考仓库。提供对精选代码库的只读访问。
-type: atom
-version: 1.0.0
----
-
-# 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/features/spike/resources/zh/skills/monoco_workflow_research/SKILL.md

@@ -1,121 +0,0 @@
----
-name: monoco_workflow_research
-description: Spike 研究工作流 (Flow Skill)。定义从添加外部仓库到知识提取和归档的标准操作流程，确保外部知识有效管理。
-type: workflow
-domain: spike
-version: 1.0.0
----
-
-# Research Workflow
-
-Spike 研究的标准化工作流，确保 "Add → Sync → Analyze → Extract → Archive" 流程。
-
-## 工作流状态机
-
-```mermaid
-stateDiagram-v2
-    [*] --> Add: 发现参考仓库
-    
-    Add --> Sync: 添加配置
-    Add --> Add: URL 无效<br/>(重新输入)
-    
-    Sync --> Analyze: 同步完成
-    Sync --> Sync: 同步失败<br/>(网络/权限)
-    
-    Analyze --> Extract: 分析完成
-    Analyze --> Analyze: 内容不符<br/>(重新评估)
-    
-    Extract --> Archive: 知识提取完成
-    
-    Archive --> [*]: 归档完成
-```
-
-## 执行步骤
-
-### 1. Add (添加仓库)
-
-- **目标**: 将外部仓库添加为参考
-- **输入**: 仓库 URL、参考目的
-- **输出**: 配置更新
-- **检查点**:
-  - [ ] 验证仓库 URL 可访问
-  - [ ] 确认仓库与当前项目相关
-  - [ ] 运行 `monoco spike add <url>`
-  - [ ] 检查 `.monoco/config.yaml` 已更新
-
-### 2. Sync (同步)
-
-- **目标**: 下载或更新参考仓库内容
-- **检查点**:
-  - [ ] 运行 `monoco spike sync`
-  - [ ] 验证仓库克隆到 `.references/<name>/`
-  - [ ] 检查同步日志，确认无错误
-  - [ ] 验证文件权限正确（只读）
-
-### 3. Analyze (分析)
-
-- **目标**: 研究参考仓库的结构和内容
-- **策略**: 系统性浏览和标记
-- **检查点**:
-  - [ ] 浏览仓库整体结构
-  - [ ] 识别与当前项目相关的模块
-  - [ ] 标记有价值的代码模式
-  - [ ] 记录架构设计亮点
-
-### 4. Extract (提取知识)
-
-- **目标**: 从参考仓库提取可用知识
-- **策略**: 文档化有价值的发现
-- **检查点**:
-  - [ ] 提取关键代码片段（不修改原文件）
-  - [ ] 记录设计模式和最佳实践
-  - [ ] 创建学习笔记（使用 Memo 或 Issue）
-  - [ ] 标注知识来源（仓库 URL + Commit）
-
-### 5. Archive (归档)
-
-- **目标**: 整理和归档研究成果
-- **检查点**:
-  - [ ] 更新项目文档，引用参考仓库
-  - [ ] 创建知识索引（如需要）
-  - [ ] 运行 `monoco spike list` 验证状态
-  - [ ] 定期清理不再需要的参考
-
-## 决策分支
-
-| 条件 | 动作 |
-|------|------|
-| URL 无效 | 返回 Add，检查 URL 格式 |
-| 同步失败 | 检查网络、权限，重试或跳过 |
-| 内容不相关 | 从配置中移除，重新选择 |
-| 发现重要模式 | 创建 Issue，计划引入项目 |
-
-## 合规要求
-
-- **禁止**: 编辑 `.references/` 中的任何文件
-- **必须**: 所有外部知识必须标注来源
-- **必须**: 定期同步以获取更新
-- **建议**: 只添加高质量、相关的仓库
-
-## 相关命令
-
-```bash
-# 添加参考仓库
-monoco spike add <url>
-
-# 同步所有仓库
-monoco spike sync
-
-# 列出已配置的仓库
-monoco spike list
-
-# 记录研究发现
-monoco memo add "发现: {insight}" -c "spike:{repo_name}"
-```
-
-## 最佳实践
-
-1. **精选选择**: 只添加与项目高度相关的仓库
-2. **只读访问**: 将 `.references/` 视为外部知识库，永不修改
-3. **定期同步**: 每月运行 `monoco spike sync` 获取更新
-4. **知识转化**: 将学到的模式转化为项目的实际改进