docs(workflow): 建立问题管理三段式工作流与经验知识库
- 新增 problem-solving skill:固化「问题分析→工作记录→知识沉淀」9步流程与3模板 - 新建 docs/knowledge/ 经验知识库(README/INDEX/临时方案登记/坑-UE5引擎含2条迁移示例) - GIT-GUIDE 补 §2.7 临时代码 [TEMP-INVESTIGATE] 约定、§2.8 fix 提交引用 issue - CLAUDE.md 项目管理段加问题管理引用 - 配套 Gitea 标签 type:bug / type:investigation(后台已建)
This commit is contained in:
@@ -164,6 +164,28 @@ git commit -m "refactor(inventory): 拆分背包数据层与UI层"
|
||||
- `Binaries/`、`Intermediate/`、`Saved/`、`DerivedDataCache/`
|
||||
- `.vs/`、`*.sln`(由引擎自动生成)
|
||||
|
||||
### 2.7 临时代码与调查脚本(验证完即删)
|
||||
|
||||
排查问题时往往需要写临时验证代码、测试脚本、一次性工具。约定如下(详见 `problem-solving` skill):
|
||||
|
||||
- **默认不进仓库**:临时代码只在本地 / 临时分支跑,验证完删除。
|
||||
- **若必须 commit**(如要在 UE5 里跑):用 `wip` 类型,message 标注 `[TEMP-INVESTIGATE: issue#XX]`,验证后 `git revert` 或删除该 commit。
|
||||
- **文件标记**:文件名前缀 `tmp_` / `dev_`,文件头注释 `// [TEMP-INVESTIGATE: issue#XX] 验证后删除`。
|
||||
- **清理检查**:关闭 issue 前执行 `grep -r "TEMP-INVESTIGATE" Source/ tools/`,确认无残留。
|
||||
- **保留什么**:结论 + 关键代码片段以代码块形式写入 issue 评论,**不保留可运行文件**。
|
||||
|
||||
> 原则:删除的是 artifact,保留的是 insight。
|
||||
|
||||
### 2.8 fix 提交引用 issue
|
||||
|
||||
Bug 修复 / 问题排查类提交,在 body 里引用对应 Gitea issue 号,便于溯源:
|
||||
|
||||
```bash
|
||||
git commit -m "fix(camera): 修复穿墙时摄像机卡顿问题
|
||||
|
||||
issue #42"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、版本号规范
|
||||
|
||||
Reference in New Issue
Block a user