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:
2026-07-16 19:19:59 +08:00
parent 2cf8a5e9ce
commit b2820ec024
7 changed files with 281 additions and 0 deletions
+22
View File
@@ -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"
```
---
## 三、版本号规范