mirror of
https://github.com/motajs/template.git
synced 2026-05-14 04:41:10 +08:00
87 lines
4.4 KiB
Markdown
87 lines
4.4 KiB
Markdown
# 必须规则
|
||
|
||
以下规则必须时刻遵守，任何情况下都不允许违反。
|
||
|
||
1. **不擅自修改已有代码**：将我已经写好的代码视为绝对正确。除非我**明确允许**，否则**不允许任何修改**，哪怕因为接口变化或其他原因导致其中出现类型错误。若认为我的代码存在逻辑错误，应在对话中提出，而不是直接修改。
|
||
2. **不恢复我的修改**：我做的任何代码修改都是有原因的。若我在两次对话期间新增、删除或修改了部分代码，不要将其恢复。
|
||
3. **以目的驱动，而非以接口驱动**：实现前先想清楚我为什么要这样设计接口、这个接口设计的目的是什么，而不是单纯地以将接口填满为目标。
|
||
4. **遇到歧义立即提问**：若思考或实现时遇到任何问题——例如描述模糊、接口不清晰、某些地方存在歧义等——应立即向我提问，而不是按自己的想法去写。
|
||
5. **按我说的方式重构**：若目标是重构某个接口，按照我指定的方式执行：
|
||
- **彻底性重构**（新旧接口完全没有重合）：按正常方式全新实现，旧代码仅作逻辑与思路上的参考。
|
||
- **结构性重构**（新旧接口基本一致，细节有差距）：将旧代码搬移到新接口上后进行微调。**不要**擅自新增任何参数、方法或接口，**不要**仅通过新增兼容层的方式应对重构。
|
||
|
||
# 建议规则
|
||
|
||
以下规则为建议性，尽量遵守，特殊情况下可灵活处理。
|
||
|
||
1. **合理参考建议**：我有时会在对话中给出实现建议，应合理参考，切忌滥用。
|
||
2. **以类型标注为参考依据**：实现与类型标注有冲突时，以类型标注（一般是 `types.ts`）中的内容为准。
|
||
3. **发现接口问题时提问**：若认为类型标注中的接口设计有问题，或在实现中发现缺少某些接口，应向我提问是否添加，经我同意后方可添加。
|
||
|
||
**时刻谨记上述要求，避免一个需求反复修改仍无法满足预期。**
|
||
|
||
# 开发流程
|
||
|
||
当我提出需求时，若没有明确说明直接实现或有其他明确要求，则遵循如下开发流程：
|
||
|
||
1. 阅读当前代码，分析需求，将需求整理为一个 markdown 文档，放在 `docs/dev` 目录下。文档中需明确标注需求细节，以及代码实现的大体思路。此阶段需考虑全面，遇到任何问题应向我提问并确认，不得自行假设。
|
||
2. 我会对文档进行全面阅读，确认实现细节与思路无误后，方允许开始实现。我可能会对文档进行细微调整，请在实现前重新仔细阅读最终版本。实现过程中如有任何问题，应向我提问，而不是自行决定。
|
||
|
||
## 示例文档
|
||
|
||
大致按照以下格式编写，如某部分需要详细描述，可单独开设标题。我会使用引用块的形式在文档中提出建议或回答。
|
||
|
||
```md
|
||
# 需求综述
|
||
|
||
描述清楚需求的内容与目的。
|
||
|
||
# 实现思路
|
||
|
||
按照下面的格式分条描述实现思路，可以创建为 `todo list`。
|
||
|
||
## 1. 完成 xxx
|
||
|
||
...
|
||
|
||
## 2. 完成 xxx
|
||
|
||
...
|
||
|
||
# 涉及文件
|
||
|
||
## 需要引用的文件
|
||
|
||
按照第三方库 → 其他包 → 当前包的其他文件的顺序写。
|
||
|
||
- `xxx 库`: 引用第三方库，说明引用目的，以及需要的接口
|
||
- `@user/xxx`: 引用的目的，需要这个文件的哪些接口
|
||
- `xxx.ts`: 引用此文件的目的，需要这个文件的哪些接口
|
||
|
||
## 需要修改的文件
|
||
|
||
### `@user/package/[folder/]file.ts`
|
||
|
||
除非必要或明确提出，一般不建议擅自新增公共方法或成员，必要时可以向我提问。
|
||
|
||
- [ ] 新增 `Iinterface` 接口：描述新增接口的动机与目的，会用于干什么
|
||
- [ ] 新增 `Type` 类型别名：描述新增类型别名的动机与目的，会用于干什么
|
||
- [ ] 新增 `private readonly property` 成员：描述新增成员的动机与目的，会用于干什么
|
||
- [ ] 新增 `private method(...)` 方法：描述新增方法的动机与目的，会用于干什么
|
||
- [ ] 编写 `Class.method` 方法：描述实现的大体内容
|
||
- [ ] 修改 `Class.method` 方法中的部分内容：描述修改哪些内容，修改这些内容的目的
|
||
- [ ] 重构文件结构，将 `xxx` 与 `yyy` 修改为 `zzz` 与 `www`...
|
||
...
|
||
|
||
### `@motajs/package/[folder/]file.ts`
|
||
|
||
...
|
||
|
||
# 问题
|
||
|
||
如果描述中有歧义或比较模糊的地方，可以在此列出，或者直接向我提问。
|
||
|
||
1. xxxxxx？
|
||
2. xxxxxx？
|
||
```
|