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.
Files changed (86) hide show
  1. monoco/core/config.py +7 -0
  2. monoco/core/hooks/builtin/git_cleanup.py +1 -1
  3. monoco/core/injection.py +63 -29
  4. monoco/core/integrations.py +2 -2
  5. monoco/core/output.py +5 -5
  6. monoco/core/registry.py +7 -1
  7. monoco/core/resource/__init__.py +5 -0
  8. monoco/core/resource/finder.py +98 -0
  9. monoco/core/resource/manager.py +91 -0
  10. monoco/core/resource/models.py +35 -0
  11. monoco/core/resources/en/{SKILL.md → skills/monoco_core/SKILL.md} +2 -0
  12. monoco/core/resources/zh/{SKILL.md → skills/monoco_core/SKILL.md} +2 -0
  13. monoco/core/skill_framework.py +292 -0
  14. monoco/core/skills.py +471 -371
  15. monoco/core/sync.py +73 -1
  16. monoco/core/workflow_converter.py +420 -0
  17. monoco/features/agent/__init__.py +2 -2
  18. monoco/features/agent/adapter.py +31 -0
  19. monoco/features/agent/apoptosis.py +44 -0
  20. monoco/features/agent/cli.py +101 -144
  21. monoco/features/agent/config.py +35 -21
  22. monoco/features/agent/defaults.py +6 -49
  23. monoco/features/agent/engines.py +32 -6
  24. monoco/features/agent/manager.py +6 -1
  25. monoco/features/agent/models.py +2 -2
  26. monoco/features/agent/resources/atoms/atom-code-dev.yaml +61 -0
  27. monoco/features/agent/resources/atoms/atom-issue-lifecycle.yaml +73 -0
  28. monoco/features/agent/resources/atoms/atom-knowledge.yaml +55 -0
  29. monoco/features/agent/resources/atoms/atom-review.yaml +60 -0
  30. monoco/features/agent/resources/en/skills/flow_engineer/SKILL.md +94 -0
  31. monoco/features/agent/resources/en/skills/flow_manager/SKILL.md +93 -0
  32. monoco/features/agent/resources/en/skills/flow_planner/SKILL.md +85 -0
  33. monoco/features/agent/resources/en/skills/flow_reviewer/SKILL.md +114 -0
  34. monoco/features/agent/resources/roles/role-engineer.yaml +49 -0
  35. monoco/features/agent/resources/roles/role-manager.yaml +46 -0
  36. monoco/features/agent/resources/roles/role-planner.yaml +46 -0
  37. monoco/features/agent/resources/roles/role-reviewer.yaml +47 -0
  38. monoco/features/agent/resources/workflows/workflow-dev.yaml +83 -0
  39. monoco/features/agent/resources/workflows/workflow-issue-create.yaml +72 -0
  40. monoco/features/agent/resources/workflows/workflow-review.yaml +94 -0
  41. monoco/features/agent/resources/zh/skills/flow_planner/SKILL.md +259 -0
  42. monoco/features/agent/resources/zh/skills/flow_reviewer/SKILL.md +137 -0
  43. monoco/features/agent/worker.py +38 -2
  44. monoco/features/glossary/__init__.py +0 -0
  45. monoco/features/glossary/adapter.py +31 -0
  46. monoco/features/glossary/config.py +5 -0
  47. monoco/features/glossary/resources/en/AGENTS.md +29 -0
  48. monoco/features/glossary/resources/en/skills/monoco_glossary/SKILL.md +35 -0
  49. monoco/features/glossary/resources/zh/AGENTS.md +29 -0
  50. monoco/features/glossary/resources/zh/skills/monoco_glossary/SKILL.md +35 -0
  51. monoco/features/i18n/resources/en/skills/i18n_scan_workflow/SKILL.md +105 -0
  52. monoco/features/i18n/resources/en/{SKILL.md → skills/monoco_i18n/SKILL.md} +2 -0
  53. monoco/features/i18n/resources/zh/{SKILL.md → skills/monoco_i18n/SKILL.md} +2 -0
  54. monoco/features/issue/core.py +45 -6
  55. monoco/features/issue/engine/machine.py +5 -2
  56. monoco/features/issue/models.py +1 -0
  57. monoco/features/issue/resources/en/skills/issue_create_workflow/SKILL.md +167 -0
  58. monoco/features/issue/resources/en/skills/issue_develop_workflow/SKILL.md +224 -0
  59. monoco/features/issue/resources/en/skills/issue_lifecycle_workflow/SKILL.md +159 -0
  60. monoco/features/issue/resources/en/skills/issue_refine_workflow/SKILL.md +203 -0
  61. monoco/features/issue/resources/en/{SKILL.md → skills/monoco_issue/SKILL.md} +2 -0
  62. monoco/features/issue/resources/zh/skills/issue_create_workflow/SKILL.md +167 -0
  63. monoco/features/issue/resources/zh/skills/issue_develop_workflow/SKILL.md +224 -0
  64. monoco/features/issue/resources/zh/skills/issue_refine_workflow/SKILL.md +203 -0
  65. monoco/features/issue/resources/zh/{SKILL.md → skills/monoco_issue/SKILL.md} +2 -0
  66. monoco/features/memo/resources/en/skills/monoco_memo/SKILL.md +77 -0
  67. monoco/features/memo/resources/en/skills/note_processing_workflow/SKILL.md +140 -0
  68. monoco/features/memo/resources/zh/{SKILL.md → skills/monoco_memo/SKILL.md} +2 -0
  69. monoco/features/spike/resources/en/{SKILL.md → skills/monoco_spike/SKILL.md} +2 -0
  70. monoco/features/spike/resources/en/skills/research_workflow/SKILL.md +121 -0
  71. monoco/features/spike/resources/zh/{SKILL.md → skills/monoco_spike/SKILL.md} +2 -0
  72. monoco_toolkit-0.3.10.dist-info/METADATA +124 -0
  73. monoco_toolkit-0.3.10.dist-info/RECORD +156 -0
  74. monoco/features/agent/reliability.py +0 -106
  75. monoco/features/agent/resources/skills/flow_reviewer/SKILL.md +0 -114
  76. monoco_toolkit-0.3.9.dist-info/METADATA +0 -127
  77. monoco_toolkit-0.3.9.dist-info/RECORD +0 -115
  78. /monoco/features/agent/resources/{skills → zh/skills}/flow_engineer/SKILL.md +0 -0
  79. /monoco/features/agent/resources/{skills → zh/skills}/flow_manager/SKILL.md +0 -0
  80. /monoco/features/i18n/resources/{skills → zh/skills}/i18n_scan_workflow/SKILL.md +0 -0
  81. /monoco/features/issue/resources/{skills → zh/skills}/issue_lifecycle_workflow/SKILL.md +0 -0
  82. /monoco/features/memo/resources/{skills → zh/skills}/note_processing_workflow/SKILL.md +0 -0
  83. /monoco/features/spike/resources/{skills → zh/skills}/research_workflow/SKILL.md +0 -0
  84. {monoco_toolkit-0.3.9.dist-info → monoco_toolkit-0.3.10.dist-info}/WHEEL +0 -0
  85. {monoco_toolkit-0.3.9.dist-info → monoco_toolkit-0.3.10.dist-info}/entry_points.txt +0 -0
  86. {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. **提醒遗漏**: 检查是否有遗漏的关键信息或风险点
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: monoco-issue
3
3
  description: Monoco Issue System 的官方技能定义。将 Issue 视为通用原子 (Universal Atom),管理 Epic/Feature/Chore/Fix 的生命周期。
4
+ type: standard
5
+ version: 1.0.0
4
6
  ---
5
7
 
6
8
  # 自我管理 (Monoco Issue System)
@@ -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
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: monoco-memo
3
3
  description: 轻量级备忘录系统,用于快速记录想法、灵感和临时笔记。与正式的 Issue 系统区分开来。
4
+ type: standard
5
+ version: 1.0.0
4
6
  ---
5
7
 
6
8
  # Monoco Memo (备忘录)
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: monoco-spike
3
3
  description: Manage external reference repositories for research and learning. Provides read-only access to curated codebases.
4
+ type: standard
5
+ version: 1.0.0
4
6
  ---
5
7
 
6
8
  # Spike (Research)
@@ -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
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: monoco-spike
3
3
  description: 管理用于研究和学习的外部参考仓库。提供对精选代码库的只读访问。
4
+ type: standard
5
+ version: 1.0.0
4
6
  ---
5
7
 
6
8
  # Spike (研究)
@@ -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
+ [![Version](https://img.shields.io/pypi/v/monoco-toolkit)](https://pypi.org/project/monoco-toolkit/)
39
+ [![License](https://img.shields.io/github/license/IndenScale/Monoco)](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)