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

monoco/features/issue/resources/zh/skills/monoco_workflow_issue_creation/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: monoco_workflow_issue_creation
+description: 从 Memo 提取改进线索，分类并创建 Issue Ticket (Copilot 模式)
+type: workflow
+domain: issue
+version: 1.0.0
+---
+
+# Issue Create Workflow
+
+从 Memo 中提取改进线索，分析并创建结构化 Issue Ticket 的标准化工作流。
+
+**适用场景**: Copilot 模式（人类主导，AI 辅助）
+**目标用户**: 需要快速将想法/笔记转化为可执行任务的开发者
+
+## 工作流状态机
+
+```mermaid
+stateDiagram-v2
+    [*] --> Extract: 读取 Memo
+    
+    Extract --> Classify: 识别类型
+    Extract --> Archive: 无价值
+    
+    Classify --> Design: 需要架构设计
+    Classify --> Direct: 直接创建
+    
+    Design --> Create: 设计完成
+    Direct --> Create: 直接创建
+    
+    Archive --> [*]: 归档 Memo
+    Create --> [*]: Issue 创建完成
+```
+
+## 执行步骤
+
+### 1. Extract (提取)
+
+- **目标**: 从 Memo 中提取关键改进线索
+- **输入**: Memo 文件或临时笔记
+- **输出**: 结构化的改进线索列表
+- **检查点**:
+  - [ ] 运行 `monoco memo list` 查看待处理 Memo
+  - [ ] 分析每个 Memo 的改进类型和影响范围
+  - [ ] 识别可执行的改进点（非纯参考资料）
+  - [ ] 记录改进的动机和预期效果
+
+**分析维度**:
+| 维度 | 问题 |
+|------|------|
+| 价值 | 这个改进解决什么问题？ |
+| 范围 | 影响哪些模块/功能？ |
+| 紧急 | 是现在做还是以后做？ |
+| 可行 | 是否有足够信息开始？ |
+
+### 2. Classify (分类)
+
+- **目标**: 确定 Issue 类型和优先级
+- **检查点**:
+  - [ ] 判断是否为架构级改进（→ Epic）
+  - [ ] 判断是否为用户价值增量（→ Feature）
+  - [ ] 判断是否为工程债务（→ Chore）
+  - [ ] 判断是否为缺陷修复（→ Fix）
+  - [ ] 评估是否需要前置架构设计
+
+**决策分支**:
+
+| 条件 | 类型 | 下一步 |
+|------|------|--------|
+| 架构愿景级改进，需要分解为多个 Feature | Epic | → Design |
+| 用户可交付价值，有明确验收标准 | Feature | → Direct |
+| 工程维护任务，技术债务清理 | Chore | → Direct |
+| 缺陷修复，有明确复现步骤 | Fix | → Direct |
+| 纯参考资料，无直接改进价值 | - | → Archive |
+| 需要架构设计才能估算工作量 | - | → Design |
+
+### 3. Design (设计) - 可选
+
+- **目标**: 对复杂改进进行初步架构设计
+- **适用**: Epic 或大型 Feature
+- **检查点**:
+  - [ ] 分析现有架构继承性
+  - [ ] 确定技术方案方向
+  - [ ] 识别依赖关系和风险点
+  - [ ] 估算工作量和里程碑
+
+**输出物**:
+- 架构决策记录 (ADR) 草稿
+- 子任务分解建议
+- 依赖 Issue 列表
+
+### 4. Create (创建)
+
+- **目标**: 创建符合规范的 Issue
+- **检查点**:
+  - [ ] 运行 `monoco issue create <type> -t "标题"`
+  - [ ] 编写清晰的描述和背景
+  - [ ] 定义可验证的验收标准（至少 2 个 Checkbox）
+  - [ ] 设置依赖关系（如需要）
+  - [ ] 关联相关 Memo（如适用）
+  - [ ] 运行 `monoco issue lint` 验证合规性
+
+**Issue 内容模板**:
+
+```markdown
+## Objective
+清晰描述这个 Issue 的目标和预期结果。
+
+## Acceptance Criteria
+- [ ] 验收标准 1
+- [ ] 验收标准 2
+
+## Technical Tasks
+- [ ] 技术任务 1
+- [ ] 技术任务 2
+
+## Related
+- Parent: EPIC-XXXX (如适用)
+- Related Memo: MEMO-XXXX (如适用)
+```
+
+### 5. Archive (归档) - 可选
+
+- **目标**: 对无直接改进价值的 Memo 进行归档
+- **检查点**:
+  - [ ] 确认 Memo 内容为纯参考资料
+  - [ ] 记录归档原因
+  - [ ] 更新 Memo 状态（如系统支持）
+
+## Issue 类型指南
+
+| 类型 | 用途 | 前缀 | Mindset | 示例 |
+|------|------|------|---------|------|
+| Epic | 宏大目标、愿景容器 | EPIC- | Architect | 重构核心架构 |
+| Feature | 用户价值增量 | FEAT- | Product Owner | 添加导出功能 |
+| Chore | 工程性事务 | CHORE- | Builder | 升级依赖版本 |
+| Fix | 缺陷修复 | FIX- | Debugger | 修复内存泄漏 |
+
+## 相关命令
+
+```bash
+# 查看待处理 Memo
+monoco memo list
+
+# 创建 Issue
+monoco issue create feature -t "标题"
+monoco issue create chore -t "标题"
+monoco issue create fix -t "标题"
+monoco issue create epic -t "标题"
+
+# 验证 Issue 合规性
+monoco issue lint
+```
+
+## 与 flow_engineer 的关系
+
+此工作流与 `flow_engineer` 互补：
+- `issue-create-workflow`: 关注 Issue 创建阶段，将想法转化为可执行任务
+- `flow_engineer`: 关注代码实现阶段，执行 Investigate → Code → Test → Report → Submit
+
+## Copilot 模式提示
+
+作为 AI Copilot，你应该：
+1. **主动提问**: 当 Memo 内容不清晰时，询问人类开发者意图
+2. **提供选项**: 给出多个分类建议，说明理由
+3. **协助起草**: 帮助编写 Issue 描述和验收标准
+4. **提醒合规**: 确保创建的 Issue 符合项目规范

monoco/features/issue/resources/zh/skills/monoco_workflow_issue_development/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: monoco_workflow_issue_development
+description: 执行 Issue 开发、测试、提交和评审的完整工作流 (Copilot 模式)
+type: workflow
+domain: issue
+version: 1.0.0
+---
+
+# Issue Develop Workflow
+
+执行 Issue 开发、测试、提交、评审和合并的完整标准化工作流。
+
+**适用场景**: Copilot 模式（人类主导，AI 辅助）
+**目标用户**: 负责实现功能或修复缺陷的开发者
+
+## 工作流状态机
+
+```mermaid
+stateDiagram-v2
+    [*] --> Setup: 开始开发
+    
+    Setup --> Develop: 环境就绪
+    Setup --> Setup: 依赖未满足<br/>(等待解决)
+    
+    Develop --> Test: 编码完成
+    Develop --> Develop: 需要迭代<br/>(继续开发)
+    
+    Test --> Submit: 测试通过
+    Test --> Develop: 测试失败<br/>(修复代码)
+    
+    state "Review Loop" as ReviewLoop {
+        Submit --> Review: 提交评审
+        Review --> Fix: 需要修改
+        Fix --> Submit: 重新提交
+    }
+    
+    Review --> Merge: 评审通过
+    
+    Merge --> [*]: 合并完成
+```
+
+## 执行步骤
+
+### 1. Setup (准备)
+
+- **目标**: 准备开发环境，确保可以开始编码
+- **检查点**:
+  - [ ] 运行 `monoco issue start <ID> --branch` 创建功能分支
+  - [ ] 确认分支已创建并切换
+  - [ ] 验证当前不在 main/master 分支
+  - [ ] 检查依赖 Issue 是否已完成
+  - [ ] 确认 Issue 已细化（有技术任务清单）
+
+**环境检查清单**:
+| 检查项 | 命令/方法 |
+|--------|-----------|
+| 当前分支 | `git branch --show-current` |
+| 分支状态 | `git status` |
+| 依赖 Issue | `monoco issue show <ID>` |
+| 代码规范 | 检查项目 lint 配置 |
+
+### 2. Develop (开发)
+
+- **目标**: 实现功能或修复缺陷
+- **策略**: 迭代开发，小步提交
+- **检查点**:
+  - [ ] 遵循项目代码规范
+  - [ ] 编写/更新单元测试
+  - [ ] 定期提交代码（小步提交）
+  - [ ] 更新文件追踪（`monoco issue sync-files`）
+  - [ ] 保持代码可审查性（单次提交 < 400 行）
+
+**开发原则**:
+| 原则 | 说明 |
+|------|------|
+| 小步提交 | 每次提交一个逻辑单元 |
+| 测试先行 | 优先编写测试用例 |
+| 持续同步 | 及时更新文件追踪 |
+| 保持专注 | 避免无关修改 |
+
+### 3. Test (测试)
+
+- **目标**: 确保代码质量和功能正确性
+- **检查点**:
+  - [ ] 运行单元测试，确保通过
+  - [ ] 运行集成测试（如适用）
+  - [ ] 运行代码规范检查（lint）
+  - [ ] 手动验证功能（如需要）
+  - [ ] 检查测试覆盖率
+
+**测试层次**:
+```
+单元测试 → 集成测试 → 端到端测试 → 手动验证
+   ↑          ↑            ↑            ↑
+ 必须        推荐          按需         按需
+```
+
+### 4. Submit (提交)
+
+- **目标**: 准备代码评审
+- **检查点**:
+  - [ ] 运行 `monoco issue lint` 检查合规性
+  - [ ] 修复所有 Lint 错误
+  - [ ] 更新任务清单状态（标记完成项）
+  - [ ] 编写清晰的提交信息
+  - [ ] 运行 `monoco issue submit <ID>`
+
+**提交信息规范**:
+```
+<type>(<scope>): <subject>
+
+<body>
+
+Refs: <ISSUE-ID>
+```
+
+| 类型 | 用途 |
+|------|------|
+| feat | 新功能 |
+| fix | 缺陷修复 |
+| docs | 文档更新 |
+| style | 代码格式 |
+| refactor | 重构 |
+| test | 测试相关 |
+| chore | 构建/工具 |
+
+### 5. Review (评审)
+
+- **目标**: 代码质量和流程合规检查
+- **检查点**:
+  - [ ] 功能是否正确实现
+  - [ ] 代码是否符合设计规范
+  - [ ] 测试是否充分
+  - [ ] 文档是否同步更新
+  - [ ] 是否遵循项目规范
+
+**评审维度**:
+| 维度 | 检查内容 |
+|------|----------|
+| 正确性 | 功能是否按预期工作 |
+| 设计 | 是否符合架构设计 |
+| 测试 | 测试覆盖是否充分 |
+| 规范 | 是否遵循代码规范 |
+| 文档 | 文档是否同步更新 |
+| 性能 | 是否有明显性能问题 |
+| 安全 | 是否有安全隐患 |
+
+### 6. Merge (合并)
+
+- **目标**: 完成 Issue，合并代码
+- **检查点**:
+  - [ ] 代码已通过评审
+  - [ ] 所有 CI 检查通过
+  - [ ] 代码已合并到主分支
+  - [ ] 运行 `monoco issue close <ID> --solution completed --prune`
+  - [ ] 验证分支已清理
+  - [ ] 更新 Review Comments（记录评审反馈）
+
+## 决策分支
+
+| 条件 | 动作 |
+|------|------|
+| 依赖 Issue 未完成 | 返回 Setup，等待依赖 |
+| 测试失败 | 返回 Develop，修复代码 |
+| Lint 失败 | 修复合规性问题，重新 Submit |
+| 评审需要修改 | 返回 Fix，按反馈修改 |
+| 评审通过 | 进入 Merge，合并并清理 |
+
+## 合规要求
+
+- **禁止**: 在 main/master 分支直接修改代码
+- **必须**: 使用 `monoco issue start --branch` 创建功能分支
+- **必须**: 所有单元测试通过后才能 Submit
+- **必须**: 每个 Issue 至少 2 个 Checkbox
+- **必须**: Review/Done 阶段必须包含 Review Comments
+- **建议**: 小步提交，频繁同步文件追踪
+
+## 相关命令
+
+```bash
+# 启动开发
+monoco issue start FEAT-0001 --branch
+
+# 同步文件追踪
+monoco issue sync-files
+
+# 检查合规性
+monoco issue lint
+
+# 提交评审
+monoco issue submit FEAT-0001
+
+# 关闭 Issue
+monoco issue close FEAT-0001 --solution completed --prune
+```
+
+## 与 flow_engineer 的关系
+
+此工作流与 `flow_engineer` 的关系：
+
+```
+issue-develop-workflow          flow_engineer
+       │                              │
+       ├── Setup ─────────────────────┤
+       ├── Develop ←──────────────────┤ Investigate → Code → Test
+       ├── Test ──────────────────────┤
+       ├── Submit ────────────────────┤ Report → Submit
+       ├── Review ────────────────────┤
+       └── Merge ─────────────────────┤
+```
+
+- `issue-develop-workflow`: 关注 Issue 级别的流程管理
+- `flow_engineer`: 关注代码实现的具体技术流程
+
+在 Develop 阶段，开发者应遵循 `flow_engineer` 的 Investigate → Code → Test → Report → Submit 流程。
+
+## Copilot 模式提示
+
+作为 AI Copilot，你应该：
+1. **协助编码**: 帮助实现功能、修复缺陷
+2. **代码审查**: 在提交前进行预审查，发现潜在问题
+3. **测试协助**: 帮助编写测试用例，确保覆盖
+4. **合规检查**: 提醒开发者遵循项目规范
+5. **文档同步**: 协助更新相关文档

monoco/features/issue/resources/{skills/issue_lifecycle_workflow → zh/skills/monoco_workflow_issue_management}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: issue-lifecycle-workflow
+name: monoco_workflow_issue_management
 description: Issue 生命周期工作流 (Flow Skill)。定义从创建到关闭的完整 Issue 管理流程，确保任务追踪和流程合规。
-type: flow
+type: workflow
 domain: issue
 version: 1.0.0
 ---

monoco/features/issue/resources/zh/skills/monoco_workflow_issue_refinement/SKILL.md

@@ -0,0 +1,203 @@
+---
+name: monoco_workflow_issue_refinement
+description: 调查并细化 Issue，补充技术细节和实现方案 (Copilot 模式)
+type: workflow
+domain: issue
+version: 1.0.0
+---
+
+# Issue Refine Workflow
+
+对新创建或待细化的 Issue 进行技术调查、架构分析和方案设计的标准化工作流。
+
+**适用场景**: Copilot 模式（人类主导，AI 辅助）
+**目标用户**: 需要深入理解问题并制定实现方案的开发者
+
+## 工作流状态机
+
+```mermaid
+stateDiagram-v2
+    [*] --> Investigate: 开始细化
+    
+    Investigate --> Analyze: 收集信息
+    Investigate --> Investigate: 信息不足<br/>(继续调查)
+    
+    Analyze --> Architect: 需要架构设计
+    Analyze --> Document: 直接文档化
+    
+    Architect --> Document: 设计完成
+    
+    Document --> [*]: Issue 细化完成
+```
+
+## 执行步骤
+
+### 1. Investigate (调查)
+
+- **目标**: 全面收集与 Issue 相关的信息
+- **输入**: Issue Ticket、相关代码、文档
+- **输出**: 信息收集报告
+- **检查点**:
+  - [ ] 阅读 Issue 描述，理解核心问题
+  - [ ] 识别相关代码模块和文件
+  - [ ] 查看相关 Issue/PR 历史
+  - [ ] 检查外部依赖和约束条件
+  - [ ] 收集类似实现参考（Spike）
+
+**调查维度**:
+| 维度 | 调查内容 |
+|------|----------|
+| 代码 | 相关模块的当前实现 |
+| 历史 | 相关 Issue、PR、设计文档 |
+| 依赖 | 外部库、API、服务依赖 |
+| 约束 | 性能要求、安全要求、兼容性 |
+| 参考 | 类似功能的最佳实践 |
+
+### 2. Analyze (分析)
+
+- **目标**: 分析收集的信息，识别关键问题和方案选项
+- **检查点**:
+  - [ ] 分析架构继承性（如何融入现有架构）
+  - [ ] 评估安全性影响
+  - [ ] 评估性能影响
+  - [ ] 评估可维护性
+  - [ ] 识别潜在风险和缓解措施
+
+**分析框架**:
+
+#### 架构继承性
+- 现有架构模式是否适用？
+- 是否需要引入新的抽象层？
+- 对现有模块的耦合影响？
+
+#### 安全性评估
+- 输入验证需求
+- 权限控制需求
+- 数据保护需求
+- 潜在攻击面分析
+
+#### 性能评估
+- 时间复杂度影响
+- 空间复杂度影响
+- 并发/并行需求
+- 资源使用预估
+
+#### 可维护性评估
+- 代码复杂度变化
+- 测试覆盖需求
+- 文档更新需求
+- 后续扩展性
+
+### 3. Architect (架构) - 可选
+
+- **目标**: 对复杂 Issue 进行架构设计
+- **适用**: 涉及架构变更或大型功能
+- **检查点**:
+  - [ ] 确定技术方案选型
+  - [ ] 设计接口和交互协议
+  - [ ] 规划数据模型变更
+  - [ ] 制定实现里程碑
+
+**输出物**:
+- 架构决策记录 (ADR)
+- 接口设计文档
+- 数据模型变更
+- 里程碑计划
+
+### 4. Document (文档)
+
+- **目标**: 将分析结果更新到 Issue
+- **检查点**:
+  - [ ] 更新技术任务清单
+  - [ ] 添加架构决策说明
+  - [ ] 补充风险和缓解措施
+  - [ ] 更新验收标准（如需要）
+  - [ ] 添加参考链接和依赖说明
+  - [ ] 运行 `monoco issue lint` 验证合规性
+
+**细化后 Issue 结构**:
+
+```markdown
+## Objective
+[原有内容]
+
+## Acceptance Criteria
+- [ ] 验收标准 1
+- [ ] 验收标准 2
+
+## Technical Analysis
+
+### 现状分析
+描述当前代码状态和相关实现。
+
+### 方案选型
+| 方案 | 优点 | 缺点 | 决策 |
+|------|------|------|------|
+| A | ... | ... | 采纳/备选 |
+| B | ... | ... | 备选/放弃 |
+
+### 风险评估
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| 风险1 | 高/中/低 | 措施... |
+
+## Technical Tasks
+- [ ] 任务 1
+- [ ] 任务 2
+
+## References
+- 相关 Issue: #XXX
+- 参考实现: [链接]
+- ADR: [链接]
+```
+
+## 决策分支
+
+| 条件 | 动作 |
+|------|------|
+| 信息不足 | 返回 Investigate，继续收集 |
+| 需要架构设计 | 进入 Architect 阶段 |
+| 方案明确 | 直接进入 Document 阶段 |
+| 发现阻塞依赖 | 创建依赖 Issue，标记当前 Issue |
+| 问题过于复杂 | 建议拆分为多个 Issue |
+
+## 细化程度指南
+
+| Issue 类型 | 细化要求 |
+|------------|----------|
+| Epic | 必须包含架构设计、里程碑、子任务分解 |
+| Feature | 必须包含技术方案、风险评估、任务分解 |
+| Chore | 必须包含实施步骤、影响范围 |
+| Fix | 必须包含根因分析、修复方案、测试用例 |
+
+## 相关命令
+
+```bash
+# 查看 Issue 详情
+monoco issue show <ID>
+
+# 检查合规性
+monoco issue lint
+
+# 同步文件追踪
+monoco issue sync-files
+
+# 查看相关 Spike
+monoco spike list
+```
+
+## 与 flow_engineer 的关系
+
+此工作流与 `flow_engineer` 互补：
+- `issue-refine-workflow`: 关注 Issue 细化阶段，在开发前完成技术调查
+- `flow_engineer`: 关注代码实现阶段，执行 Investigate → Code → Test → Report → Submit
+
+细化阶段收集的信息将为 Engineer 阶段的 Investigate 提供重要输入。
+
+## Copilot 模式提示
+
+作为 AI Copilot，你应该：
+1. **主动探索**: 帮助开发者发现潜在问题和边界情况
+2. **提供对比**: 给出多个技术方案，分析优缺点
+3. **协助评估**: 帮助进行安全性、性能影响评估
+4. **提醒遗漏**: 检查是否有遗漏的关键信息或风险点