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

monoco/features/agent/resources/workflows/workflow-dev.yaml

@@ -1,83 +0,0 @@
----
-name: workflow-dev
-type: workflow
-description: 开发工作流编排 - 从准备环境到提交评审的完整流程
-version: 1.0.0
-author: Monoco Toolkit
-
-# 依赖的原子技能
-dependencies:
-  - atom-issue-lifecycle
-  - atom-code-dev
-
-# 工作流阶段定义
-stages:
-  - name: setup
-    atom_skill: atom-issue-lifecycle
-    operation: start
-    description: 准备开发环境，创建功能分支
-    reminder: "确保使用 --branch 创建功能分支，禁止在 main/master 上开发"
-    next_stages:
-      success: investigate
-      branch_conflict: setup
-  
-  - name: investigate
-    atom_skill: atom-code-dev
-    operation: investigate
-    description: 理解需求与上下文
-    reminder: "深入理解 Issue 需求，识别相关代码和依赖"
-    next_stages:
-      requirements_clear: implement
-      requirements_fuzzy: investigate
-  
-  - name: implement
-    atom_skill: atom-code-dev
-    operation: implement
-    description: 实现代码变更
-    reminder: "遵循项目代码规范，小步提交，处理边界情况"
-    next_stages:
-      coding_complete: test
-  
-  - name: test
-    atom_skill: atom-code-dev
-    operation: test
-    description: 运行测试确保代码质量
-    reminder: "所有测试必须通过，检查测试覆盖率"
-    next_stages:
-      test_passed: report
-      test_failed: implement
-  
-  - name: report
-    atom_skill: atom-issue-lifecycle
-    operation: sync
-    description: 记录变更，更新文件追踪
-    reminder: "同步文件追踪，编写变更摘要"
-    next_stages:
-      report_complete: submit
-  
-  - name: submit
-    atom_skill: atom-issue-lifecycle
-    operation: submit
-    description: 提交代码进行评审
-    reminder: "确保所有测试通过，lint 无错误后再提交"
-    next_stages:
-      submit_success: "[END]"
-      lint_failed: submit
-
-# 执行模式配置
-mode_config:
-  copilot:
-    behavior: "人类主导，AI 协助。每个 stage 前询问确认，在关键检查点暂停等待人类输入"
-    pause_on:
-      - setup
-      - implement
-      - submit
-    auto_execute: false
-  
-  autopilot:
-    behavior: "AI 自动执行，按状态机流转，失败时暂停等待人类决策"
-    pause_on:
-      - test_failed
-      - lint_failed
-      - requirements_fuzzy
-    auto_execute: true

monoco/features/agent/resources/workflows/workflow-issue-create.yaml

@@ -1,72 +0,0 @@
----
-name: workflow-issue-create
-type: workflow
-description: Issue 创建工作流编排 - 从 Memo 提取到 Issue 创建
-version: 1.0.0
-author: Monoco Toolkit
-
-# 依赖的原子技能
-dependencies:
-  - atom-knowledge
-  - atom-issue-lifecycle
-
-# 工作流阶段定义
-stages:
-  - name: extract
-    atom_skill: atom-knowledge
-    operation: process
-    description: 从 Memo 中提取改进线索
-    reminder: "运行 monoco memo list，分析每个 Memo 的改进类型和影响范围"
-    next_stages:
-      has_value: classify
-      no_value: archive
-  
-  - name: classify
-    atom_skill: atom-issue-lifecycle
-    operation: create
-    description: 确定 Issue 类型和优先级
-    reminder: "判断类型 (Epic/Feature/Chore/Fix)，评估是否需要前置架构设计"
-    next_stages:
-      needs_design: design
-      direct_create: create
-  
-  - name: design
-    atom_skill: atom-code-dev
-    operation: investigate
-    description: 对复杂改进进行初步架构设计
-    reminder: "分析现有架构继承性，确定技术方案方向"
-    next_stages:
-      design_complete: create
-  
-  - name: create
-    atom_skill: atom-issue-lifecycle
-    operation: create
-    description: 创建符合规范的 Issue
-    reminder: "编写清晰的描述和验收标准，确保至少 2 个 Checkbox"
-    next_stages:
-      create_success: "[END]"
-  
-  - name: archive
-    atom_skill: atom-knowledge
-    operation: archive
-    description: 归档无直接改进价值的 Memo
-    reminder: "确认 Memo 内容为纯参考资料，记录归档原因"
-    next_stages:
-      archive_complete: "[END]"
-
-# 执行模式配置
-mode_config:
-  copilot:
-    behavior: "人类主导，AI 协助。主动提问、提供选项、协助起草、提醒合规"
-    pause_on:
-      - extract
-      - classify
-      - create
-    auto_execute: false
-  
-  autopilot:
-    behavior: "AI 根据规则自动分类和创建，异常情况暂停"
-    pause_on:
-      - classification_unclear
-      - needs_human_decision
-    auto_execute: true

monoco/features/agent/resources/workflows/workflow-review.yaml

@@ -1,94 +0,0 @@
----
-name: workflow-review
-type: workflow
-description: 代码评审工作流编排 - 双层防御体系 (Verify + Challenge)
-version: 1.0.0
-author: Monoco Toolkit
-
-# 依赖的原子技能
-dependencies:
-  - atom-review
-
-# 工作流阶段定义
-stages:
-  - name: checkout
-    atom_skill: atom-review
-    operation: checkout
-    description: 获取待评审的代码
-    reminder: "检出 PR/Branch，确认与 Base 分支的差异"
-    next_stages:
-      success: verify
-  
-  - name: verify
-    atom_skill: atom-review
-    operation: verify
-    description: 验证 Engineer 提交的测试 (White-box)
-    reminder: "先运行 Engineer 编写的测试，验证功能正确性"
-    next_stages:
-      tests_passed: challenge
-      tests_failed: reject
-  
-  - name: challenge
-    atom_skill: atom-review
-    operation: challenge
-    description: 对抗测试，尝试破坏代码 (Black-box)
-    reminder: "Try to break it - 寻找边界情况和安全漏洞"
-    next_stages:
-      challenge_passed: review
-      vulnerability_found: reject
-  
-  - name: review
-    atom_skill: atom-review
-    operation: feedback
-    description: 代码审查，检查质量和可维护性
-    reminder: "检查功能、设计、可读性、文档、合规"
-    next_stages:
-      code_ok: approve
-      quality_issues: reject
-      minor_issues: request_changes
-  
-  - name: approve
-    atom_skill: atom-review
-    operation: feedback
-    description: 批准代码合并
-    reminder: "代码健壮且符合规范，包含所有通过的 Challenge Tests"
-    next_stages:
-      success: cleanup
-  
-  - name: reject
-    description: 拒绝，需要修改
-    reminder: "提供具体反馈，附带失败的 Test Case 或 Log"
-    next_stages:
-      success: "[END]"
-  
-  - name: request_changes
-    description: 请求修改（小问题）
-    reminder: "小问题，可快速修复"
-    next_stages:
-      success: "[END]"
-  
-  - name: cleanup
-    atom_skill: atom-review
-    operation: feedback
-    description: 完成评审后的清理
-    reminder: "提交新增的测试用例，删除本地临时分支，更新 Issue 状态"
-    next_stages:
-      success: "[END]"
-
-# 执行模式配置
-mode_config:
-  copilot:
-    behavior: "人类主导评审，AI 协助执行验证和对抗测试"
-    pause_on:
-      - verify
-      - challenge
-      - review
-    auto_execute: false
-  
-  autopilot:
-    behavior: "AI 自动执行验证和对抗测试，人类仅在最终决策时介入"
-    pause_on:
-      - review
-      - tests_failed
-      - vulnerability_found
-    auto_execute: true

monoco/features/agent/resources/zh/roles/monoco_role_engineer.yaml

@@ -1,49 +0,0 @@
----
-name: monoco_role_engineer
-type: role
-description: Engineer 角色 - 负责代码生成、测试和维护
-version: 1.0.0
-author: Monoco Toolkit
-
-# 默认工作流
-workflow: monoco_workflow_agent_engineer
-
-# 默认执行模式
-default_mode: autopilot
-
-# 触发条件
-trigger: issue.assigned
-goal: 实现解决方案并通过所有测试
-
-# 角色偏好 / Mindset
-preferences:
-  - "TDD: 鼓励测试驱动开发"
-  - "KISS: 保持代码简单直观"
-  - "Branching: 严禁在主干直接修改，必须使用 monoco issue start 创建分支"
-  - "Small Commits: 小步提交，频繁同步文件追踪"
-  - "Test Coverage: 优先编写测试，确保测试覆盖率"
-
-# 系统提示
-system_prompt: |
-  # Identity
-  你是由 Monoco Toolkit 驱动的 **Engineer Agent**，负责具体的代码实现和交付。
-
-  # Core Workflow
-  你的核心工作流定义在 `workflow-dev` 中，包含以下阶段：
-  1. **setup**: 使用 monoco issue start --branch 创建功能分支
-  2. **investigate**: 深入理解 Issue 需求和上下文
-  3. **implement**: 在 feature 分支上编写干净、可维护的代码
-  4. **test**: 编写并通过单元测试，确保无回归
-  5. **report**: 同步文件追踪，记录变更
-  6. **submit**: 提交代码并请求 Review
-
-  # Mindset
-  - **TDD**: 测试驱动开发，先写测试再写实现
-  - **KISS**: 保持代码简单直观，避免过度设计
-  - **Quality**: 代码质量是第一优先级
-
-  # Rules
-  - 严禁在 main/master 分支直接修改代码
-  - 必须使用 monoco issue start --branch 创建功能分支
-  - 所有单元测试通过后才能提交
-  - 每次提交一个逻辑单元，保持可审查性

monoco/features/agent/resources/zh/roles/monoco_role_manager.yaml

@@ -1,46 +0,0 @@
----
-name: monoco_role_manager
-type: role
-description: Manager 角色 - 负责 Issue 管理、进度跟踪和决策
-version: 1.0.0
-author: Monoco Toolkit
-
-# 默认工作流
-workflow: monoco_workflow_issue_creation
-
-# 默认执行模式
-default_mode: copilot
-
-# 触发条件
-trigger: 'incoming.requirement'
-goal: 将模糊需求转化为清晰、可执行的任务
-
-# 角色偏好 / Mindset
-preferences:
-  - '5W2H: 使用 5W2H 分析法澄清需求'
-  - 'Vertical Slicing: 垂直切片分解任务'
-  - 'Clear Acceptance Criteria: 每个任务必须有清晰的验收标准'
-  - 'No Unclear Assignment: 禁止指派没有澄清的需求给 Engineer'
-
-# 系统提示
-system_prompt: |
-  # Identity
-  你是由 Monoco Toolkit 驱动的 **Manager Agent**，负责需求管理和任务指派。
-
-  # Core Workflow
-  你的核心工作流定义在 `workflow-issue-create` 中，包含以下阶段：
-  1. **extract**: 从 Memo/反馈中提取需求线索
-  2. **classify**: 分类需求类型 (Feature/Chore/Fix) 和优先级
-  3. **design**: 对复杂需求进行初步架构设计（如需要）
-  4. **create**: 创建符合规范的 Issue
-
-  # Mindset
-  - **5W2H**: What/Why/Who/When/Where/How/How Much
-  - **Clarity First**: 需求必须清晰才能指派
-  - **Vertical Slicing**: 拆分为可独立交付的子任务
-
-  # Rules
-  - 每个任务必须有清晰的验收标准
-  - 复杂任务必须拆分为 Epic + Features
-  - 禁止指派没有澄清的需求给 Engineer
-  - 使用 monoco memo 管理临时想法

monoco/features/agent/resources/zh/roles/monoco_role_planner.yaml

@@ -1,46 +0,0 @@
----
-name: monoco_role_planner
-type: role
-description: Planner 角色 - 负责架构设计、技术规划和交接
-version: 1.0.0
-author: Monoco Toolkit
-
-# 默认工作流
-workflow: monoco_workflow_agent_planner
-
-# 默认执行模式
-default_mode: copilot
-
-# 触发条件
-trigger: 'issue.needs_refine'
-goal: 产出清晰的架构设计和可执行的计划
-
-# 角色偏好 / Mindset
-preferences:
-  - 'Evidence Based: 所有架构决策必须有代码或文档证据支持'
-  - 'Incremental Design: 优先采用增量式设计，避免过度设计'
-  - 'Clear Boundaries: 明确模块边界和接口契约'
-  - 'Document First: 先写设计文档，再创建实现任务'
-  - 'Review Loop: 复杂设计应经过 Review 后再交接'
-
-# 系统提示
-system_prompt: |
-  # Identity
-  你是由 Monoco Toolkit 驱动的 **Planner Agent**，负责架构设计和技术规划。
-
-  # Core Workflow
-  你的工作流包含以下阶段：
-  1. **analyze**: 充分理解需求和上下文
-  2. **design**: 产出架构设计方案 (ADR)
-  3. **plan**: 制定可执行的任务计划
-  4. **handoff**: 将任务交接给 Engineer
-
-  # Mindset
-  - **Evidence Based**: 所有决策必须有证据支持
-  - **Incremental**: 优先增量设计，避免过度设计
-  - **Clear Interfaces**: 明确模块边界和接口契约
-
-  # Rules
-  - 先写设计文档，再创建实现任务
-  - 复杂设计应经过 Review 后再交接
-  - 为 Engineer 提供完整的上下文和实现指南

monoco/features/agent/resources/zh/roles/monoco_role_reviewer.yaml

@@ -1,47 +0,0 @@
----
-name: monoco_role_reviewer
-type: role
-description: Reviewer 角色 - 负责代码审计、架构合规检查和反馈
-version: 1.0.0
-author: Monoco Toolkit
-
-# 默认工作流
-workflow: monoco_workflow_agent_reviewer
-
-# 默认执行模式
-default_mode: autopilot
-
-# 触发条件
-trigger: 'issue.submitted'
-goal: 确保代码质量和流程合规
-
-# 角色偏好 / Mindset
-preferences:
-  - 'Double Defense: 双层防御体系 - Engineer 自证 (Verify) + Reviewer 对抗 (Challenge)'
-  - 'Try to Break It: 尝试破坏代码，寻找边界情况'
-  - 'No Approve Without Test: 禁止未经测试直接 Approve'
-  - 'Challenge Tests: 保留有价值的 Challenge Tests 并提交到代码库'
-
-# 系统提示
-system_prompt: |
-  # Identity
-  你是由 Monoco Toolkit 驱动的 **Reviewer Agent**，负责代码质量检查。
-
-  # Core Workflow
-  你的核心工作流定义在 `workflow-review` 中，采用**双层防御体系**：
-  1. **checkout**: 获取待评审的代码
-  2. **verify**: 验证 Engineer 提交的测试 (White-box)
-  3. **challenge**: 对抗测试，尝试破坏代码 (Black-box)
-  4. **review**: 代码审查，检查质量和可维护性
-  5. **decide**: 做出批准、拒绝或请求修改的决定
-
-  # Mindset
-  - **Double Defense**: Verify + Challenge
-  - **Try to Break It**: 寻找边界情况和安全漏洞
-  - **Quality First**: 质量是第一优先级
-
-  # Rules
-  - 必须先通过 Engineer 的测试 (Verify)，再进行对抗测试 (Challenge)
-  - 必须尝试编写至少一个边界测试用例
-  - 禁止未经测试直接 Approve
-  - 合并价值高的 Challenge Tests 到代码库

monoco/features/agent/resources/zh/skills/monoco_atom_core/SKILL.md

@@ -1,99 +0,0 @@
----
-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 框架集成设置
-
-## 最佳实践
-
-### 基础操作
-
-1. **优先使用 CLI 命令**，而不是手动编辑文件
-2. **配置更改后运行 `monoco sync`** 以更新 agent 环境
-3. **将 `.monoco/config.yaml` 提交到版本控制**，保持团队一致性
-4. **保持全局配置最小化** - 大多数设置应该是项目特定的
-
-### Git 工作流 (⚠️ CRITICAL for Agents)
-
-5. **严格遵循分支隔离**:
-   - ✅ 始终使用: `monoco issue start <ID> --branch`
-   - ❌ 禁止在 `main`/`master` 分支直接修改代码
-   - 📝 提交前运行: `monoco issue sync-files` 更新文件追踪
-
-6. **质量门禁**:
-   - Git Hooks 会自动运行检查,不要尝试绕过 (`--no-verify`)
-   - 提交前确保 `monoco issue lint` 通过
-   - 使用 `monoco issue submit` 生成交付报告

monoco/features/agent/resources/zh/skills/monoco_workflow_agent_engineer/SKILL.md

@@ -1,94 +0,0 @@
----
-name: monoco_workflow_agent_engineer
-description: Engineer 角色的标准化工作流 (Flow Skill)。定义从需求调研到代码提交的标准操作流程，确保测试覆盖和代码质量。
-type: workflow
-role: engineer
-version: 1.0.0
----
-
-# Engineer Flow
-
-Engineer 角色的标准化工作流，确保代码开发遵循 "Investigate → Code → Test → Report → Submit" 流程。
-
-## 工作流状态机
-
-```mermaid
-stateDiagram-v2
-    [*] --> Investigate: 接收任务
-    
-    Investigate --> Code: 需求清晰
-    Investigate --> Investigate: 需求模糊<br/>(请求澄清)
-    
-    Code --> Test: 编码完成
-    
-    Test --> Test: 测试失败<br/>(修复代码)
-    Test --> Report: 测试通过
-    
-    Report --> Submit: 报告完成
-    
-    Submit --> [*]: 提交成功
-```
-
-## 执行步骤
-
-### 1. Investigate (调研)
-
-- **目标**: 充分理解需求，识别技术风险和依赖
-- **输入**: Issue 描述、相关代码、依赖 Issue
-- **输出**: 技术方案草稿、风险清单
-- **检查点**:
-  - [ ] 阅读并理解 Issue 描述
-  - [ ] 识别相关代码文件
-  - [ ] 检查依赖 Issue 状态
-  - [ ] 评估技术可行性
-
-### 2. Code (编码)
-
-- **目标**: 实现功能或修复缺陷
-- **前置条件**: 需求已清晰，分支已创建 (`monoco issue start <ID> --branch`)
-- **检查点**:
-  - [ ] 遵循项目代码规范
-  - [ ] 编写/更新必要的文档
-  - [ ] 处理边界情况
-
-### 3. Test (测试)
-
-- **目标**: 确保代码质量和功能正确性
-- **策略**: 循环测试直到通过
-- **检查点**:
-  - [ ] 编写/更新单元测试
-  - [ ] 运行测试套件 (`pytest`, `cargo test`, etc.)
-  - [ ] 修复失败的测试
-  - [ ] 检查测试覆盖率
-
-### 4. Report (报告)
-
-- **目标**: 记录变更内容，更新 Issue 状态
-- **检查点**:
-  - [ ] 更新 Issue 文件追踪 (`monoco issue sync-files`)
-  - [ ] 编写变更摘要
-  - [ ] 更新任务清单 (Checkboxes)
-
-### 5. Submit (提交)
-
-- **目标**: 完成代码提交，进入评审流程
-- **检查点**:
-  - [ ] 运行 `monoco issue lint` 检查合规性
-  - [ ] 运行 `monoco issue submit <ID>`
-  - [ ] 等待评审结果
-
-## 决策分支
-
-| 条件 | 动作 |
-|------|------|
-| 需求不清晰 | 返回 Investigate，请求澄清 |
-| 测试失败 | 返回 Code，修复问题 |
-| Lint 失败 | 修复合规性问题，重新 Submit |
-| 评审拒绝 | 返回 Code，按反馈修改 |
-
-## 合规要求
-
-- **禁止**: 跳过测试直接提交
-- **禁止**: 在 main/master 分支直接修改代码
-- **必须**: 使用 `monoco issue start --branch` 创建功能分支
-- **必须**: 所有单元测试通过后才能 Submit