Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 09:05:46 +08:00
commit a64cee7b84
51 changed files with 11796 additions and 0 deletions

104
commands/check-fact.md Normal file
View File

@@ -0,0 +1,104 @@
## 事实检查
参考项目内的代码库、文档 (docs/、README.md 等),确认所给信息的正确性。
### 使用方法
```bash
# 基本用法
/check-fact "Flutter 应用使用了 Riverpod"
# 一次性确认多个信息
/check-fact "这个项目使用 GraphQL并通过 auto_route 管理路由"
# 确认特定技术规范
/check-fact "使用 JWT 进行身份验证,未使用 Firebase Auth"
```
### 确认流程
1. **信息源优先级**
- 代码库 (最可靠)
- README.md、docs/ 内文档
- package.json、pubspec.yaml 等配置文件
- Issue、Pull Request 的讨论历史
2. **判定结果分类**
- `✅ 正确` - 信息与代码库完全一致
- `❌ 错误` - 信息明显错误
- `⚠️ 部分正确` - 部分准确但不完整
- `❓ 无法判断` - 缺少必要的确认信息
3. **依据明示**
- 相关文件名和行号
- 相关代码片段
- 文档相关部分
### 报告格式
```text
## 事实检查结果
### 检验对象
「[用户提供的信息]」
### 结论
[✅/❌/⚠️/❓] [判定结果]
### 依据
- **文件**: `path/to/file.dart:123`
- **内容**: [相关代码/文本]
- **补充**: [额外说明]
### 详细说明
[如果错误,提供正确信息]
[如果部分正确,指出不准确的部分]
[如果无法判断,说明缺少的信息]
```
### 基本示例
```bash
# 项目技术栈确认
/check-fact "这个应用是 Flutter + Riverpod + GraphQL 的架构"
# 实现状况确认
/check-fact "已实现暗黑模式功能,可从用户设置切换"
# 架构确认
/check-fact "状态管理全部使用 Riverpod未使用 BLoC"
# 安全实现确认
/check-fact "认证令牌已加密存储在 secure storage 中"
```
### 与 Claude 的协作
```bash
# 分析整个代码库后进行确认
ls -la && find . -name "pubspec.yaml" -exec cat {} \;
/check-fact "这个项目使用的主要依赖有..."
# 确认特定功能的实现状况
grep -r "authentication" . --include="*.dart"
/check-fact "认证功能为自定义实现,未使用第三方认证"
# 确认与文档的一致性
cat README.md
/check-fact "README 中记载的功能都已实现"
```
### 应用场景
- 技术规格书编写时: 确认内容准确性
- 项目交接时: 确认对现有实现的理解
- 客户报告前: 确认实现状况
- 技术博客撰写时: 验证文章内容准确性
- 面试·说明资料制作时: 确认项目概要准确性
### 注意事项
- 代码库是最可靠的信息源
- 如果文档过时,以实现为准
- 缺少判断所需信息时,坦诚回答"无法判断"
- 对涉及安全的信息要特别谨慎验证