@modus-ai/modus 0.1.0 → 0.1.1
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.
package/package.json
CHANGED
|
@@ -97,17 +97,48 @@
|
|
|
97
97
|
- API 契约（从 Controller/Facade 提炼）：接口路径、关键请求/响应字段
|
|
98
98
|
- 典型代码示例（可选，高价值）：体现项目特有模式的代码片段
|
|
99
99
|
|
|
100
|
-
### Step 3
|
|
100
|
+
### Step 3：并发冲突检测（写入前必做）
|
|
101
|
+
|
|
102
|
+
多人协作时，同一个 Skill 可能被并发更新。写入前先检查：
|
|
103
|
+
|
|
104
|
+
1. **读取 Skill 文件头部的 `version` 和 `updated` 字段**
|
|
105
|
+
2. **对比当前内容与本次要写入的内容**，判断是否有冲突风险：
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
冲突场景：
|
|
109
|
+
- 你在准备写入 modus-biz-order v2.0.0
|
|
110
|
+
- 但文件当前已经是 v2.0.0（说明有人已经抢先更新了）
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
**冲突处理策略（merge-friendly，保证 Git 无冲突）：**
|
|
114
|
+
|
|
115
|
+
- **新增知识** → 只往文件末尾 **追加**（append），不修改已有行
|
|
116
|
+
```markdown
|
|
117
|
+
## 更新日志
|
|
118
|
+
|
|
119
|
+
### {YYYY-MM-DD HH:mm} v{N+1} — {更新者描述}
|
|
120
|
+
- [model] 新增 OrderStatus.PENDING_REVIEW 枚举值
|
|
121
|
+
- [pitfall] 批量操作超过 500 条会触发慢查询
|
|
122
|
+
```
|
|
123
|
+
- **修改已有知识** → 在对应条目后追加 `(已更新: {YYYY-MM-DD})` 注释，不直接覆盖原行
|
|
124
|
+
- **删除过时知识** → 不物理删除，改为在条目前加 `~~` 删除线标记并注明原因
|
|
125
|
+
|
|
126
|
+
**为什么这样设计：**
|
|
127
|
+
- Git merge 时，append-only 的文件几乎不会产生冲突
|
|
128
|
+
- 保留了变更历史，方便溯源
|
|
129
|
+
- 团队成员可以看到知识演进过程
|
|
130
|
+
|
|
131
|
+
### Step 4：写入 Skill 文件
|
|
101
132
|
|
|
102
133
|
按 Business Skill 标准格式生成或更新文件：
|
|
103
134
|
|
|
104
135
|
**更新策略（模式 B/C/D）：**
|
|
105
136
|
- 对比现有 Skill 内容和最新信息，识别差异
|
|
106
|
-
-
|
|
137
|
+
- **新增内容追加到文件末尾**，修改内容以注释方式标注（见 Step 3）
|
|
107
138
|
- 更新文件头的 `updated` 日期、`version`（自增）、`last_referenced`、`usage_count`
|
|
108
139
|
- 在文件末尾追加「本次更新摘要」注释
|
|
109
140
|
|
|
110
|
-
### Step
|
|
141
|
+
### Step 5：更新 knowledge-catalog.md
|
|
111
142
|
|
|
112
143
|
每次写入 Skill 后，同步更新 `modus/knowledge-catalog.md`：
|
|
113
144
|
- 更新对应条目的 `maturity`、`last_referenced`
|
|
@@ -138,6 +138,22 @@ B. 继续使用降级模式（无业务上下文，结果质量可能降低）
|
|
|
138
138
|
- [pitfall] order 域：批量操作时若不分页会导致内存溢出
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
+
### Step 8：写入 Session 日志
|
|
142
|
+
|
|
143
|
+
编码完成后，将本次会话**追加**（append-only，禁止覆盖原有内容）到 `modus/sessions/vibe-log.md`：
|
|
144
|
+
|
|
145
|
+
```markdown
|
|
146
|
+
## {YYYY-MM-DD HH:mm} — {需求一句话摘要}
|
|
147
|
+
|
|
148
|
+
- **涉及域：** {domain1}, {domain2}
|
|
149
|
+
- **修改文件：** {变更文件列表，最多 5 个}
|
|
150
|
+
- **Skill 更新建议：** {发现的新知识，无则填「无」}
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
**为什么 append-only：** 多人同时使用时，各自只往文件末尾追加，不修改已有行，Git merge 自动无冲突。
|
|
156
|
+
|
|
141
157
|
---
|
|
142
158
|
|
|
143
159
|
## 氛围编程原则
|