monoco-toolkit 0.3.9__py3-none-any.whl → 0.3.10__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- monoco/core/config.py +7 -0
- monoco/core/hooks/builtin/git_cleanup.py +1 -1
- monoco/core/injection.py +63 -29
- monoco/core/integrations.py +2 -2
- monoco/core/output.py +5 -5
- monoco/core/registry.py +7 -1
- monoco/core/resource/__init__.py +5 -0
- monoco/core/resource/finder.py +98 -0
- monoco/core/resource/manager.py +91 -0
- monoco/core/resource/models.py +35 -0
- monoco/core/resources/en/{SKILL.md → skills/monoco_core/SKILL.md} +2 -0
- monoco/core/resources/zh/{SKILL.md → skills/monoco_core/SKILL.md} +2 -0
- monoco/core/skill_framework.py +292 -0
- monoco/core/skills.py +471 -371
- monoco/core/sync.py +73 -1
- monoco/core/workflow_converter.py +420 -0
- monoco/features/agent/__init__.py +2 -2
- monoco/features/agent/adapter.py +31 -0
- monoco/features/agent/apoptosis.py +44 -0
- monoco/features/agent/cli.py +101 -144
- monoco/features/agent/config.py +35 -21
- monoco/features/agent/defaults.py +6 -49
- monoco/features/agent/engines.py +32 -6
- monoco/features/agent/manager.py +6 -1
- monoco/features/agent/models.py +2 -2
- monoco/features/agent/resources/atoms/atom-code-dev.yaml +61 -0
- monoco/features/agent/resources/atoms/atom-issue-lifecycle.yaml +73 -0
- monoco/features/agent/resources/atoms/atom-knowledge.yaml +55 -0
- monoco/features/agent/resources/atoms/atom-review.yaml +60 -0
- monoco/features/agent/resources/en/skills/flow_engineer/SKILL.md +94 -0
- monoco/features/agent/resources/en/skills/flow_manager/SKILL.md +93 -0
- monoco/features/agent/resources/en/skills/flow_planner/SKILL.md +85 -0
- monoco/features/agent/resources/en/skills/flow_reviewer/SKILL.md +114 -0
- monoco/features/agent/resources/roles/role-engineer.yaml +49 -0
- monoco/features/agent/resources/roles/role-manager.yaml +46 -0
- monoco/features/agent/resources/roles/role-planner.yaml +46 -0
- monoco/features/agent/resources/roles/role-reviewer.yaml +47 -0
- monoco/features/agent/resources/workflows/workflow-dev.yaml +83 -0
- monoco/features/agent/resources/workflows/workflow-issue-create.yaml +72 -0
- monoco/features/agent/resources/workflows/workflow-review.yaml +94 -0
- monoco/features/agent/resources/zh/skills/flow_planner/SKILL.md +259 -0
- monoco/features/agent/resources/zh/skills/flow_reviewer/SKILL.md +137 -0
- monoco/features/agent/worker.py +38 -2
- monoco/features/glossary/__init__.py +0 -0
- monoco/features/glossary/adapter.py +31 -0
- monoco/features/glossary/config.py +5 -0
- monoco/features/glossary/resources/en/AGENTS.md +29 -0
- monoco/features/glossary/resources/en/skills/monoco_glossary/SKILL.md +35 -0
- monoco/features/glossary/resources/zh/AGENTS.md +29 -0
- monoco/features/glossary/resources/zh/skills/monoco_glossary/SKILL.md +35 -0
- monoco/features/i18n/resources/en/skills/i18n_scan_workflow/SKILL.md +105 -0
- monoco/features/i18n/resources/en/{SKILL.md → skills/monoco_i18n/SKILL.md} +2 -0
- monoco/features/i18n/resources/zh/{SKILL.md → skills/monoco_i18n/SKILL.md} +2 -0
- monoco/features/issue/core.py +45 -6
- monoco/features/issue/engine/machine.py +5 -2
- monoco/features/issue/models.py +1 -0
- monoco/features/issue/resources/en/skills/issue_create_workflow/SKILL.md +167 -0
- monoco/features/issue/resources/en/skills/issue_develop_workflow/SKILL.md +224 -0
- monoco/features/issue/resources/en/skills/issue_lifecycle_workflow/SKILL.md +159 -0
- monoco/features/issue/resources/en/skills/issue_refine_workflow/SKILL.md +203 -0
- monoco/features/issue/resources/en/{SKILL.md → skills/monoco_issue/SKILL.md} +2 -0
- monoco/features/issue/resources/zh/skills/issue_create_workflow/SKILL.md +167 -0
- monoco/features/issue/resources/zh/skills/issue_develop_workflow/SKILL.md +224 -0
- monoco/features/issue/resources/zh/skills/issue_refine_workflow/SKILL.md +203 -0
- monoco/features/issue/resources/zh/{SKILL.md → skills/monoco_issue/SKILL.md} +2 -0
- monoco/features/memo/resources/en/skills/monoco_memo/SKILL.md +77 -0
- monoco/features/memo/resources/en/skills/note_processing_workflow/SKILL.md +140 -0
- monoco/features/memo/resources/zh/{SKILL.md → skills/monoco_memo/SKILL.md} +2 -0
- monoco/features/spike/resources/en/{SKILL.md → skills/monoco_spike/SKILL.md} +2 -0
- monoco/features/spike/resources/en/skills/research_workflow/SKILL.md +121 -0
- monoco/features/spike/resources/zh/{SKILL.md → skills/monoco_spike/SKILL.md} +2 -0
- monoco_toolkit-0.3.10.dist-info/METADATA +124 -0
- monoco_toolkit-0.3.10.dist-info/RECORD +156 -0
- monoco/features/agent/reliability.py +0 -106
- monoco/features/agent/resources/skills/flow_reviewer/SKILL.md +0 -114
- monoco_toolkit-0.3.9.dist-info/METADATA +0 -127
- monoco_toolkit-0.3.9.dist-info/RECORD +0 -115
- /monoco/features/agent/resources/{skills → zh/skills}/flow_engineer/SKILL.md +0 -0
- /monoco/features/agent/resources/{skills → zh/skills}/flow_manager/SKILL.md +0 -0
- /monoco/features/i18n/resources/{skills → zh/skills}/i18n_scan_workflow/SKILL.md +0 -0
- /monoco/features/issue/resources/{skills → zh/skills}/issue_lifecycle_workflow/SKILL.md +0 -0
- /monoco/features/memo/resources/{skills → zh/skills}/note_processing_workflow/SKILL.md +0 -0
- /monoco/features/spike/resources/{skills → zh/skills}/research_workflow/SKILL.md +0 -0
- {monoco_toolkit-0.3.9.dist-info → monoco_toolkit-0.3.10.dist-info}/WHEEL +0 -0
- {monoco_toolkit-0.3.9.dist-info → monoco_toolkit-0.3.10.dist-info}/entry_points.txt +0 -0
- {monoco_toolkit-0.3.9.dist-info → monoco_toolkit-0.3.10.dist-info}/licenses/LICENSE +0 -0
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: issue-refine-workflow
|
|
3
|
+
description: 调查并细化 Issue,补充技术细节和实现方案 (Copilot 模式)
|
|
4
|
+
type: flow
|
|
5
|
+
domain: issue
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Issue Refine Workflow
|
|
10
|
+
|
|
11
|
+
对新创建或待细化的 Issue 进行技术调查、架构分析和方案设计的标准化工作流。
|
|
12
|
+
|
|
13
|
+
**适用场景**: Copilot 模式(人类主导,AI 辅助)
|
|
14
|
+
**目标用户**: 需要深入理解问题并制定实现方案的开发者
|
|
15
|
+
|
|
16
|
+
## 工作流状态机
|
|
17
|
+
|
|
18
|
+
```mermaid
|
|
19
|
+
stateDiagram-v2
|
|
20
|
+
[*] --> Investigate: 开始细化
|
|
21
|
+
|
|
22
|
+
Investigate --> Analyze: 收集信息
|
|
23
|
+
Investigate --> Investigate: 信息不足<br/>(继续调查)
|
|
24
|
+
|
|
25
|
+
Analyze --> Architect: 需要架构设计
|
|
26
|
+
Analyze --> Document: 直接文档化
|
|
27
|
+
|
|
28
|
+
Architect --> Document: 设计完成
|
|
29
|
+
|
|
30
|
+
Document --> [*]: Issue 细化完成
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## 执行步骤
|
|
34
|
+
|
|
35
|
+
### 1. Investigate (调查)
|
|
36
|
+
|
|
37
|
+
- **目标**: 全面收集与 Issue 相关的信息
|
|
38
|
+
- **输入**: Issue Ticket、相关代码、文档
|
|
39
|
+
- **输出**: 信息收集报告
|
|
40
|
+
- **检查点**:
|
|
41
|
+
- [ ] 阅读 Issue 描述,理解核心问题
|
|
42
|
+
- [ ] 识别相关代码模块和文件
|
|
43
|
+
- [ ] 查看相关 Issue/PR 历史
|
|
44
|
+
- [ ] 检查外部依赖和约束条件
|
|
45
|
+
- [ ] 收集类似实现参考(Spike)
|
|
46
|
+
|
|
47
|
+
**调查维度**:
|
|
48
|
+
| 维度 | 调查内容 |
|
|
49
|
+
|------|----------|
|
|
50
|
+
| 代码 | 相关模块的当前实现 |
|
|
51
|
+
| 历史 | 相关 Issue、PR、设计文档 |
|
|
52
|
+
| 依赖 | 外部库、API、服务依赖 |
|
|
53
|
+
| 约束 | 性能要求、安全要求、兼容性 |
|
|
54
|
+
| 参考 | 类似功能的最佳实践 |
|
|
55
|
+
|
|
56
|
+
### 2. Analyze (分析)
|
|
57
|
+
|
|
58
|
+
- **目标**: 分析收集的信息,识别关键问题和方案选项
|
|
59
|
+
- **检查点**:
|
|
60
|
+
- [ ] 分析架构继承性(如何融入现有架构)
|
|
61
|
+
- [ ] 评估安全性影响
|
|
62
|
+
- [ ] 评估性能影响
|
|
63
|
+
- [ ] 评估可维护性
|
|
64
|
+
- [ ] 识别潜在风险和缓解措施
|
|
65
|
+
|
|
66
|
+
**分析框架**:
|
|
67
|
+
|
|
68
|
+
#### 架构继承性
|
|
69
|
+
- 现有架构模式是否适用?
|
|
70
|
+
- 是否需要引入新的抽象层?
|
|
71
|
+
- 对现有模块的耦合影响?
|
|
72
|
+
|
|
73
|
+
#### 安全性评估
|
|
74
|
+
- 输入验证需求
|
|
75
|
+
- 权限控制需求
|
|
76
|
+
- 数据保护需求
|
|
77
|
+
- 潜在攻击面分析
|
|
78
|
+
|
|
79
|
+
#### 性能评估
|
|
80
|
+
- 时间复杂度影响
|
|
81
|
+
- 空间复杂度影响
|
|
82
|
+
- 并发/并行需求
|
|
83
|
+
- 资源使用预估
|
|
84
|
+
|
|
85
|
+
#### 可维护性评估
|
|
86
|
+
- 代码复杂度变化
|
|
87
|
+
- 测试覆盖需求
|
|
88
|
+
- 文档更新需求
|
|
89
|
+
- 后续扩展性
|
|
90
|
+
|
|
91
|
+
### 3. Architect (架构) - 可选
|
|
92
|
+
|
|
93
|
+
- **目标**: 对复杂 Issue 进行架构设计
|
|
94
|
+
- **适用**: 涉及架构变更或大型功能
|
|
95
|
+
- **检查点**:
|
|
96
|
+
- [ ] 确定技术方案选型
|
|
97
|
+
- [ ] 设计接口和交互协议
|
|
98
|
+
- [ ] 规划数据模型变更
|
|
99
|
+
- [ ] 制定实现里程碑
|
|
100
|
+
|
|
101
|
+
**输出物**:
|
|
102
|
+
- 架构决策记录 (ADR)
|
|
103
|
+
- 接口设计文档
|
|
104
|
+
- 数据模型变更
|
|
105
|
+
- 里程碑计划
|
|
106
|
+
|
|
107
|
+
### 4. Document (文档)
|
|
108
|
+
|
|
109
|
+
- **目标**: 将分析结果更新到 Issue
|
|
110
|
+
- **检查点**:
|
|
111
|
+
- [ ] 更新技术任务清单
|
|
112
|
+
- [ ] 添加架构决策说明
|
|
113
|
+
- [ ] 补充风险和缓解措施
|
|
114
|
+
- [ ] 更新验收标准(如需要)
|
|
115
|
+
- [ ] 添加参考链接和依赖说明
|
|
116
|
+
- [ ] 运行 `monoco issue lint` 验证合规性
|
|
117
|
+
|
|
118
|
+
**细化后 Issue 结构**:
|
|
119
|
+
|
|
120
|
+
```markdown
|
|
121
|
+
## Objective
|
|
122
|
+
[原有内容]
|
|
123
|
+
|
|
124
|
+
## Acceptance Criteria
|
|
125
|
+
- [ ] 验收标准 1
|
|
126
|
+
- [ ] 验收标准 2
|
|
127
|
+
|
|
128
|
+
## Technical Analysis
|
|
129
|
+
|
|
130
|
+
### 现状分析
|
|
131
|
+
描述当前代码状态和相关实现。
|
|
132
|
+
|
|
133
|
+
### 方案选型
|
|
134
|
+
| 方案 | 优点 | 缺点 | 决策 |
|
|
135
|
+
|------|------|------|------|
|
|
136
|
+
| A | ... | ... | 采纳/备选 |
|
|
137
|
+
| B | ... | ... | 备选/放弃 |
|
|
138
|
+
|
|
139
|
+
### 风险评估
|
|
140
|
+
| 风险 | 影响 | 缓解措施 |
|
|
141
|
+
|------|------|----------|
|
|
142
|
+
| 风险1 | 高/中/低 | 措施... |
|
|
143
|
+
|
|
144
|
+
## Technical Tasks
|
|
145
|
+
- [ ] 任务 1
|
|
146
|
+
- [ ] 任务 2
|
|
147
|
+
|
|
148
|
+
## References
|
|
149
|
+
- 相关 Issue: #XXX
|
|
150
|
+
- 参考实现: [链接]
|
|
151
|
+
- ADR: [链接]
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## 决策分支
|
|
155
|
+
|
|
156
|
+
| 条件 | 动作 |
|
|
157
|
+
|------|------|
|
|
158
|
+
| 信息不足 | 返回 Investigate,继续收集 |
|
|
159
|
+
| 需要架构设计 | 进入 Architect 阶段 |
|
|
160
|
+
| 方案明确 | 直接进入 Document 阶段 |
|
|
161
|
+
| 发现阻塞依赖 | 创建依赖 Issue,标记当前 Issue |
|
|
162
|
+
| 问题过于复杂 | 建议拆分为多个 Issue |
|
|
163
|
+
|
|
164
|
+
## 细化程度指南
|
|
165
|
+
|
|
166
|
+
| Issue 类型 | 细化要求 |
|
|
167
|
+
|------------|----------|
|
|
168
|
+
| Epic | 必须包含架构设计、里程碑、子任务分解 |
|
|
169
|
+
| Feature | 必须包含技术方案、风险评估、任务分解 |
|
|
170
|
+
| Chore | 必须包含实施步骤、影响范围 |
|
|
171
|
+
| Fix | 必须包含根因分析、修复方案、测试用例 |
|
|
172
|
+
|
|
173
|
+
## 相关命令
|
|
174
|
+
|
|
175
|
+
```bash
|
|
176
|
+
# 查看 Issue 详情
|
|
177
|
+
monoco issue show <ID>
|
|
178
|
+
|
|
179
|
+
# 检查合规性
|
|
180
|
+
monoco issue lint
|
|
181
|
+
|
|
182
|
+
# 同步文件追踪
|
|
183
|
+
monoco issue sync-files
|
|
184
|
+
|
|
185
|
+
# 查看相关 Spike
|
|
186
|
+
monoco spike list
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## 与 flow_engineer 的关系
|
|
190
|
+
|
|
191
|
+
此工作流与 `flow_engineer` 互补:
|
|
192
|
+
- `issue-refine-workflow`: 关注 Issue 细化阶段,在开发前完成技术调查
|
|
193
|
+
- `flow_engineer`: 关注代码实现阶段,执行 Investigate → Code → Test → Report → Submit
|
|
194
|
+
|
|
195
|
+
细化阶段收集的信息将为 Engineer 阶段的 Investigate 提供重要输入。
|
|
196
|
+
|
|
197
|
+
## Copilot 模式提示
|
|
198
|
+
|
|
199
|
+
作为 AI Copilot,你应该:
|
|
200
|
+
1. **主动探索**: 帮助开发者发现潜在问题和边界情况
|
|
201
|
+
2. **提供对比**: 给出多个技术方案,分析优缺点
|
|
202
|
+
3. **协助评估**: 帮助进行安全性、性能影响评估
|
|
203
|
+
4. **提醒遗漏**: 检查是否有遗漏的关键信息或风险点
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monoco-memo
|
|
3
|
+
description: Lightweight memo system for quickly recording ideas, inspirations, and temporary notes. Distinguished from the formal Issue system.
|
|
4
|
+
type: standard
|
|
5
|
+
version: 1.0.0
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Monoco Memo
|
|
9
|
+
|
|
10
|
+
Use this skill to quickly capture fleeting notes (fleeting ideas) without creating a formal Issue.
|
|
11
|
+
|
|
12
|
+
## When to Use Memo vs Issue
|
|
13
|
+
|
|
14
|
+
| Scenario | Use | Reason |
|
|
15
|
+
|----------|-----|--------|
|
|
16
|
+
| Temporary ideas, inspirations | **Memo** | No tracking needed, no completion status required |
|
|
17
|
+
| Code snippets, link bookmarks | **Memo** | Quick record, organize later |
|
|
18
|
+
| Meeting notes | **Memo** | Record first, then extract tasks |
|
|
19
|
+
| Actionable work unit | **Issue** | Requires tracking, acceptance criteria, lifecycle |
|
|
20
|
+
| Bug fix | **Issue** | Needs to record reproduction steps, verification results |
|
|
21
|
+
| Feature development | **Issue** | Needs design, decomposition, delivery |
|
|
22
|
+
|
|
23
|
+
> **Core Principle**: Memos record **ideas**; Issues handle **actionable tasks**.
|
|
24
|
+
|
|
25
|
+
## Commands
|
|
26
|
+
|
|
27
|
+
### Add Memo
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
monoco memo add "Your memo content"
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Optional parameters:
|
|
34
|
+
- `-c, --context`: Add context reference (e.g., `file:line`)
|
|
35
|
+
|
|
36
|
+
Examples:
|
|
37
|
+
```bash
|
|
38
|
+
# Simple record
|
|
39
|
+
monoco memo add "Consider using Redis cache for user sessions"
|
|
40
|
+
|
|
41
|
+
# Record with context
|
|
42
|
+
monoco memo add "Recursion here may cause stack overflow" -c "src/utils.py:42"
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### View Memo List
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
monoco memo list
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Displays all unarchived memos.
|
|
52
|
+
|
|
53
|
+
### Open Memo File
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
monoco memo open
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Opens the memo file in the default editor for organizing or batch editing.
|
|
60
|
+
|
|
61
|
+
## Workflow
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
Idea flashes → monoco memo add "..." → Regular organization → Extract into Issue or archive
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
1. **Capture**: Use `monoco memo add` immediately when you have an idea
|
|
68
|
+
2. **Organize**: Regularly (e.g., daily/weekly) run `monoco memo list` to review
|
|
69
|
+
3. **Convert**: Transform valuable memos into formal Issues
|
|
70
|
+
4. **Archive**: Remove from memos after processing
|
|
71
|
+
|
|
72
|
+
## Best Practices
|
|
73
|
+
|
|
74
|
+
1. **Keep concise**: Memos are quick notes, no detailed description needed
|
|
75
|
+
2. **Convert timely**: Valuable ideas should be converted to Issue as soon as possible to avoid forgetting
|
|
76
|
+
3. **Clean up regularly**: Memos are temporary, don't let them accumulate indefinitely
|
|
77
|
+
4. **Use context**: When recording code-related ideas, use `-c` parameter to mark the location
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: note-processing-workflow
|
|
3
|
+
description: Memo Note Processing Workflow (Flow Skill). Defines the standard operational process from capturing fleeting notes to organizing and archiving, ensuring effective management of ideas.
|
|
4
|
+
type: flow
|
|
5
|
+
domain: memo
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Note Processing Workflow
|
|
10
|
+
|
|
11
|
+
Standardized workflow for Memo note processing, ensuring the "Capture → Process → Organize → Archive/Convert" process.
|
|
12
|
+
|
|
13
|
+
## Workflow State Machine
|
|
14
|
+
|
|
15
|
+
```mermaid
|
|
16
|
+
stateDiagram-v2
|
|
17
|
+
[*] --> Capture: Idea flashes
|
|
18
|
+
|
|
19
|
+
Capture --> Process: Regular organization
|
|
20
|
+
Capture --> Capture: Continue recording
|
|
21
|
+
|
|
22
|
+
Process --> Organize: Classification completed
|
|
23
|
+
Process --> Archive: No value<br/>(archive directly)
|
|
24
|
+
|
|
25
|
+
Organize --> Convert: Actionable
|
|
26
|
+
Organize --> Organize: Needs supplement<br/>(complete information)
|
|
27
|
+
Organize --> Archive: Pure reference<br/>(archive for storage)
|
|
28
|
+
|
|
29
|
+
Convert --> [*]: Converted to Issue
|
|
30
|
+
|
|
31
|
+
Archive --> [*]: Archiving completed
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Execution Steps
|
|
35
|
+
|
|
36
|
+
### 1. Capture (Capture)
|
|
37
|
+
|
|
38
|
+
- **Goal**: Quickly record fleeting ideas without interrupting current work
|
|
39
|
+
- **Input**: Ideas, inspirations, code snippets, links
|
|
40
|
+
- **Output**: Memo record
|
|
41
|
+
- **Checkpoints**:
|
|
42
|
+
- [ ] Use `monoco memo add "content"`
|
|
43
|
+
- [ ] Keep it concise, no detailed description needed
|
|
44
|
+
- [ ] Add context (`-c file:line` if applicable)
|
|
45
|
+
- [ ] Do not interrupt current task flow
|
|
46
|
+
|
|
47
|
+
### 2. Process (Processing)
|
|
48
|
+
|
|
49
|
+
- **Goal**: Regularly review and classify Memos
|
|
50
|
+
- **Strategy**: Regular organization (daily/weekly)
|
|
51
|
+
- **Checkpoints**:
|
|
52
|
+
- [ ] Run `monoco memo list` to view all Memos
|
|
53
|
+
- [ ] Evaluate value of each Memo
|
|
54
|
+
- [ ] Classify: Actionable / Pure reference / No value
|
|
55
|
+
- [ ] Supplement missing information
|
|
56
|
+
|
|
57
|
+
### 3. Organize (Organization)
|
|
58
|
+
|
|
59
|
+
- **Goal**: Structured organization of valuable Memos
|
|
60
|
+
- **Strategy**: Choose processing method based on type
|
|
61
|
+
- **Checkpoints**:
|
|
62
|
+
- [ ] Add tags or categories to related Memos
|
|
63
|
+
- [ ] Merge similar Memos
|
|
64
|
+
- [ ] Complete vague records
|
|
65
|
+
- [ ] Set priority (if applicable)
|
|
66
|
+
|
|
67
|
+
### 4. Archive/Convert (Archive or Convert)
|
|
68
|
+
|
|
69
|
+
- **Goal**: Archive processed Memos or convert to Issue
|
|
70
|
+
- **Checkpoints**:
|
|
71
|
+
- [ ] **Convert**: Convert actionable ideas to Issue
|
|
72
|
+
- Use `monoco issue create feature/chore/fix -t "title"`
|
|
73
|
+
- Reference original Memo in the Issue
|
|
74
|
+
- [ ] **Archive**: Archive pure reference content
|
|
75
|
+
- Move to knowledge base or documentation
|
|
76
|
+
- Remove from Memo list
|
|
77
|
+
- [ ] **Delete**: Delete Memos with no value directly
|
|
78
|
+
|
|
79
|
+
## Decision Branches
|
|
80
|
+
|
|
81
|
+
| Condition | Action |
|
|
82
|
+
|-----------|--------|
|
|
83
|
+
| Idea is actionable | Convert, create Issue |
|
|
84
|
+
| Pure reference material | Archive, save to knowledge base |
|
|
85
|
+
| No value/outdated | Delete, remove directly |
|
|
86
|
+
| Information incomplete | Return to Organize, supplement information |
|
|
87
|
+
|
|
88
|
+
## Compliance Requirements
|
|
89
|
+
|
|
90
|
+
- **Required**: Memos are temporary, should not accumulate indefinitely
|
|
91
|
+
- **Required**: Actionable ideas must be converted to Issue for tracking
|
|
92
|
+
- **Recommended**: Process regularly (recommended weekly)
|
|
93
|
+
- **Recommended**: Keep Memos concise, avoid lengthy discussions
|
|
94
|
+
|
|
95
|
+
## Related Commands
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
# Add Memo
|
|
99
|
+
monoco memo add "Consider using Redis cache for user sessions"
|
|
100
|
+
|
|
101
|
+
# Memo with context
|
|
102
|
+
monoco memo add "Recursion may cause stack overflow" -c "src/utils.py:42"
|
|
103
|
+
|
|
104
|
+
# View all Memos
|
|
105
|
+
monoco memo list
|
|
106
|
+
|
|
107
|
+
# Edit Memo
|
|
108
|
+
monoco memo open
|
|
109
|
+
|
|
110
|
+
# Create Issue (convert Memo)
|
|
111
|
+
monoco issue create feature -t "Implement Redis cache"
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Usage Scenarios
|
|
115
|
+
|
|
116
|
+
| Scenario | Use Memo | Follow-up Processing |
|
|
117
|
+
|----------|----------|---------------------|
|
|
118
|
+
| Improvement suggestion during code review | `memo add "Refactoring suggestion: ..."` | Process → Convert to Issue |
|
|
119
|
+
| Temporary idea during meeting | `memo add "Idea: ..."` | Process → Organize → Convert |
|
|
120
|
+
| Useful code snippet | `memo add "Snippet: ..."` | Process → Archive to knowledge base |
|
|
121
|
+
| Technical article link | `memo add "Read: https://..."` | Process → Archive |
|
|
122
|
+
| Bug clue | `memo add "Possible Bug: ..."` | Process → Convert to Fix Issue |
|
|
123
|
+
|
|
124
|
+
## Difference from Issue
|
|
125
|
+
|
|
126
|
+
| Dimension | Memo | Issue |
|
|
127
|
+
|-----------|------|-------|
|
|
128
|
+
| Purpose | Record ideas | Track tasks |
|
|
129
|
+
| Lifecycle | Temporary, needs regular cleanup | Formal, complete lifecycle |
|
|
130
|
+
| Completion Criteria | Archived or converted | Acceptance criteria passed |
|
|
131
|
+
| Complexity | Simple, one sentence | Detailed, with AC and Tasks |
|
|
132
|
+
| Tracking | None | Complete tracking |
|
|
133
|
+
|
|
134
|
+
## Best Practices
|
|
135
|
+
|
|
136
|
+
1. **Record promptly**: Record immediately when ideas flash, avoid forgetting
|
|
137
|
+
2. **Organize regularly**: Process Memo list at least once a week
|
|
138
|
+
3. **Convert quickly**: Convert valuable ideas to Issue as soon as possible
|
|
139
|
+
4. **Delete decisively**: Delete outdated or valueless Memos decisively
|
|
140
|
+
5. **Keep concise**: Memos are quick notes, no detailed description needed
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: research-workflow
|
|
3
|
+
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.
|
|
4
|
+
type: flow
|
|
5
|
+
domain: spike
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Research Workflow
|
|
10
|
+
|
|
11
|
+
Standardized workflow for Spike research, ensuring the "Add → Sync → Analyze → Extract → Archive" process.
|
|
12
|
+
|
|
13
|
+
## Workflow State Machine
|
|
14
|
+
|
|
15
|
+
```mermaid
|
|
16
|
+
stateDiagram-v2
|
|
17
|
+
[*] --> Add: Discover reference repository
|
|
18
|
+
|
|
19
|
+
Add --> Sync: Configuration added
|
|
20
|
+
Add --> Add: Invalid URL<br/>(re-enter)
|
|
21
|
+
|
|
22
|
+
Sync --> Analyze: Sync completed
|
|
23
|
+
Sync --> Sync: Sync failed<br/>(network/permission)
|
|
24
|
+
|
|
25
|
+
Analyze --> Extract: Analysis completed
|
|
26
|
+
Analyze --> Analyze: Content mismatch<br/>(re-evaluate)
|
|
27
|
+
|
|
28
|
+
Extract --> Archive: Knowledge extraction completed
|
|
29
|
+
|
|
30
|
+
Archive --> [*]: Archiving completed
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Execution Steps
|
|
34
|
+
|
|
35
|
+
### 1. Add (Add Repository)
|
|
36
|
+
|
|
37
|
+
- **Goal**: Add external repository as reference
|
|
38
|
+
- **Input**: Repository URL, reference purpose
|
|
39
|
+
- **Output**: Configuration updated
|
|
40
|
+
- **Checkpoints**:
|
|
41
|
+
- [ ] Verify repository URL is accessible
|
|
42
|
+
- [ ] Confirm repository is relevant to current project
|
|
43
|
+
- [ ] Run `monoco spike add <url>`
|
|
44
|
+
- [ ] Check `.monoco/config.yaml` is updated
|
|
45
|
+
|
|
46
|
+
### 2. Sync (Synchronize)
|
|
47
|
+
|
|
48
|
+
- **Goal**: Download or update reference repository content
|
|
49
|
+
- **Checkpoints**:
|
|
50
|
+
- [ ] Run `monoco spike sync`
|
|
51
|
+
- [ ] Verify repository is cloned to `.references/<name>/`
|
|
52
|
+
- [ ] Check sync logs for errors
|
|
53
|
+
- [ ] Verify file permissions are correct (read-only)
|
|
54
|
+
|
|
55
|
+
### 3. Analyze (Analysis)
|
|
56
|
+
|
|
57
|
+
- **Goal**: Research the structure and content of reference repository
|
|
58
|
+
- **Strategy**: Systematic browsing and marking
|
|
59
|
+
- **Checkpoints**:
|
|
60
|
+
- [ ] Browse overall repository structure
|
|
61
|
+
- [ ] Identify modules relevant to current project
|
|
62
|
+
- [ ] Mark valuable code patterns
|
|
63
|
+
- [ ] Record architectural design highlights
|
|
64
|
+
|
|
65
|
+
### 4. Extract (Knowledge Extraction)
|
|
66
|
+
|
|
67
|
+
- **Goal**: Extract usable knowledge from reference repository
|
|
68
|
+
- **Strategy**: Document valuable findings
|
|
69
|
+
- **Checkpoints**:
|
|
70
|
+
- [ ] Extract key code snippets (without modifying original files)
|
|
71
|
+
- [ ] Record design patterns and best practices
|
|
72
|
+
- [ ] Create learning notes (using Memo or Issue)
|
|
73
|
+
- [ ] Annotate knowledge source (repository URL + Commit)
|
|
74
|
+
|
|
75
|
+
### 5. Archive (Archiving)
|
|
76
|
+
|
|
77
|
+
- **Goal**: Organize and archive research results
|
|
78
|
+
- **Checkpoints**:
|
|
79
|
+
- [ ] Update project documentation, referencing the repository
|
|
80
|
+
- [ ] Create knowledge index (if needed)
|
|
81
|
+
- [ ] Run `monoco spike list` to verify status
|
|
82
|
+
- [ ] Periodically clean up references no longer needed
|
|
83
|
+
|
|
84
|
+
## Decision Branches
|
|
85
|
+
|
|
86
|
+
| Condition | Action |
|
|
87
|
+
|-----------|--------|
|
|
88
|
+
| Invalid URL | Return to Add, check URL format |
|
|
89
|
+
| Sync failed | Check network, permissions, retry or skip |
|
|
90
|
+
| Content not relevant | Remove from configuration, reselect |
|
|
91
|
+
| Important pattern discovered | Create Issue, plan to introduce to project |
|
|
92
|
+
|
|
93
|
+
## Compliance Requirements
|
|
94
|
+
|
|
95
|
+
- **Prohibited**: Editing any files in `.references/`
|
|
96
|
+
- **Required**: All external knowledge must be annotated with source
|
|
97
|
+
- **Required**: Regular synchronization to get updates
|
|
98
|
+
- **Recommended**: Only add high-quality, relevant repositories
|
|
99
|
+
|
|
100
|
+
## Related Commands
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
# Add reference repository
|
|
104
|
+
monoco spike add <url>
|
|
105
|
+
|
|
106
|
+
# Sync all repositories
|
|
107
|
+
monoco spike sync
|
|
108
|
+
|
|
109
|
+
# List configured repositories
|
|
110
|
+
monoco spike list
|
|
111
|
+
|
|
112
|
+
# Record research findings
|
|
113
|
+
monoco memo add "Discovery: {insight}" -c "spike:{repo_name}"
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Best Practices
|
|
117
|
+
|
|
118
|
+
1. **Selective Choice**: Only add repositories highly relevant to the project
|
|
119
|
+
2. **Read-only Access**: Treat `.references/` as external knowledge base, never modify
|
|
120
|
+
3. **Regular Sync**: Run `monoco spike sync` monthly to get updates
|
|
121
|
+
4. **Knowledge Transformation**: Transform learned patterns into actual project improvements
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: monoco-toolkit
|
|
3
|
+
Version: 0.3.10
|
|
4
|
+
Summary: Agent Native Toolkit for Monoco - Task Management & Kanban for AI Agents
|
|
5
|
+
Project-URL: Homepage, https://monoco.io
|
|
6
|
+
Project-URL: Repository, https://github.com/IndenScale/Monoco
|
|
7
|
+
Project-URL: Documentation, https://monoco.io/docs
|
|
8
|
+
Project-URL: Issues, https://github.com/IndenScale/Monoco/issues
|
|
9
|
+
Author-email: Monoco Team <dev@monoco.io>
|
|
10
|
+
License-Expression: MIT
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Keywords: agent-native,ai-agents,cli,kanban,monoco,task-management,workflow
|
|
13
|
+
Classifier: Development Status :: 3 - Alpha
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
16
|
+
Classifier: Programming Language :: Python :: 3
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Topic :: Office/Business :: Groupware
|
|
21
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
22
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
|
+
Requires-Dist: fastapi>=0.100.0
|
|
25
|
+
Requires-Dist: httpx>=0.28.1
|
|
26
|
+
Requires-Dist: prompt-toolkit>=3.0.0
|
|
27
|
+
Requires-Dist: pydantic>=2.0.0
|
|
28
|
+
Requires-Dist: pyyaml>=6.0
|
|
29
|
+
Requires-Dist: rich>=13.0.0
|
|
30
|
+
Requires-Dist: sse-starlette>=1.6.0
|
|
31
|
+
Requires-Dist: typer[all]>=0.9.0
|
|
32
|
+
Requires-Dist: uvicorn[standard]>=0.20.0
|
|
33
|
+
Requires-Dist: watchdog>=6.0.0
|
|
34
|
+
Description-Content-Type: text/markdown
|
|
35
|
+
|
|
36
|
+
# Monoco Distro
|
|
37
|
+
|
|
38
|
+
[](https://pypi.org/project/monoco-toolkit/)
|
|
39
|
+
[](LICENSE)
|
|
40
|
+
|
|
41
|
+
> **The Headless Operating System for Agentic Engineering.**
|
|
42
|
+
>
|
|
43
|
+
> Monoco is a **Linux-like Distribution** for AI Agents.
|
|
44
|
+
> It provides the **Package Manager**, **Init System**, and **Policy Kit** that turns a raw LLM Kernel into a production-ready engineering workforce.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 🐧 The "Distro" Metaphor
|
|
49
|
+
|
|
50
|
+
Monoco is built on a clear separation of concerns, inspired by the Linux ecosystem:
|
|
51
|
+
|
|
52
|
+
| Component | In Linux | In Monoco | Responsibility |
|
|
53
|
+
| :---------- | :------------ | :-------------------- | :------------------------------------------------------------------------------------------------------------------------- |
|
|
54
|
+
| **Kernel** | Linux Kernel | **Kimi CLI / Kosong** | The raw execution engine. Handles LLM prompts, tool execution, and process isolation. |
|
|
55
|
+
| **Distro** | Ubuntu / Arch | **Monoco** | The system manager. Orchestrates workflows, enforces policies, manages state (Issues), and installs capabilities (Skills). |
|
|
56
|
+
| **Desktop** | GNOME / KDE | **VSCode / Zed** | The user interface. Connects to Monoco via standard protocols (LSP, ACP) to provide a visual experience. |
|
|
57
|
+
|
|
58
|
+
## 🌟 Core Philosophy
|
|
59
|
+
|
|
60
|
+
### 1. Headless & Protocol-First
|
|
61
|
+
|
|
62
|
+
Monoco is designed to run silently in the background. It doesn't fight for your attention with a chat window. Instead, it exposes its state via **LSP (Language Server Protocol)** and **ACP (Agent Client Protocol)**, allowing your favorite IDEs to become "Agent-Native".
|
|
63
|
+
|
|
64
|
+
### 2. Issue is the Unit of Work
|
|
65
|
+
|
|
66
|
+
Just as `systemd` manages Units, Monoco manages **Issues**.
|
|
67
|
+
An Issue is not just a text file; it is a stateful object that defines the lifecycle of a task. The Agent cannot "freelance"—it must be assigned to an active Issue.
|
|
68
|
+
|
|
69
|
+
### 3. Governance as Code
|
|
70
|
+
|
|
71
|
+
Monoco acts as the "Policy Kit" for your AI workforce.
|
|
72
|
+
|
|
73
|
+
- **Guardrails**: Prevent destructive actions.
|
|
74
|
+
- **Verification**: Enforce linting and tests before submission.
|
|
75
|
+
- **Audit**: Log every decision and tool call.
|
|
76
|
+
|
|
77
|
+
## 🚀 Quick Start
|
|
78
|
+
|
|
79
|
+
### 1. Installation
|
|
80
|
+
|
|
81
|
+
Install the Monoco Distro via pip:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
pip install monoco-toolkit
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 2. Initialize System
|
|
88
|
+
|
|
89
|
+
Turn your project into a Monoco-managed workspace:
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
monoco init
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### 3. Sync Kernel
|
|
96
|
+
|
|
97
|
+
Inject Monoco's policies into your Agent Kernel (e.g., Kimi CLI configuration):
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
monoco sync
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### 4. Start a Session
|
|
104
|
+
|
|
105
|
+
Launch the Monoco Daemon to begin orchestrating work:
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
monoco session start
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## 🛠️ Tech Stack & Architecture
|
|
112
|
+
|
|
113
|
+
- **Kernel Interface**: Python (Interfacing with Kimi/Kosong)
|
|
114
|
+
- **Distro Logic**: Python (State Management, Issue Tracking)
|
|
115
|
+
- **Protocols**: LSP / ACP (for IDE integration)
|
|
116
|
+
- **Storage**: Local Filesystem (Markdown/YAML)
|
|
117
|
+
|
|
118
|
+
## 🤝 Contributing
|
|
119
|
+
|
|
120
|
+
Monoco is open-source. We are building the standard distribution for the Agentic era.
|
|
121
|
+
|
|
122
|
+
## 📄 License
|
|
123
|
+
|
|
124
|
+
MIT © [IndenScale](https://github.com/IndenScale)
|