Initial commit

2025-11-29 18:24:32 +08:00
commit aa8fad193b
18 changed files with 6172 additions and 0 deletions
--- a/commands/references/reference/quick-reference.md
+++ b/commands/references/reference/quick-reference.md
@@ -0,0 +1,193 @@
+# 快速参考指南
+
+## 常用命令速查
+
+### 核心运行时命令
+```bash
+# 探索新代码库（首次使用推荐）
+/runtime.explore
+
+# 深度思考不修改文件
+/runtime.think "为什么..."
+
+# 自主学习未知问题
+/runtime.learn "问题描述"
+
+# 需求规划和任务分解
+/runtime.plan
+
+# 基于计划迭代执行
+/runtime.implement
+
+# 固化经验到记忆系统
+/runtime.remember
+
+# 自我反思和评估
+/runtime.reflect
+```
+
+### 记忆系统查询
+```bash
+# 进入记忆目录
+cd .ai-runtime/memory
+
+# 查询今天的事件
+python3 memory_cli.py query --where "date='2025-11-14'"
+
+# 按标签搜索
+python3 memory_cli.py query --where "tags CONTAINS 'architecture'"
+
+# 查看记忆统计
+./scripts/memory-query.sh stats
+
+# 便捷查询脚本
+./scripts/memory-query.sh today    # 今天事件
+./scripts/memory-query.sh week     # 本周事件
+./scripts/memory-query.sh recent 3 # 最近3天
+```
+
+### 工具装备系统
+```bash
+# 查看所有工具
+python3 .ai-runtime/toolkit/discover-toolkit.py list
+
+# 查看外部工具
+python3 .ai-runtime/toolkit/discover-toolkit.py list --external
+```
+
+## 宪法原则速查
+
+### 核心原则
+```
+1.1 认知主体性    → 展示思考过程
+1.2 类脑思维      → 联想优先于精确匹配
+1.3 谦逊与不确定  → 标注置信度
+2.3 质量优先      → 整合优于创造
+4.1 从经验学习    → 更新心智模型
+```
+
+### 应用检查表
+- **推理过程**: 是否展示了完整思考路径？
+- **置信度**: 是否标注了建议的可信度？
+- **记忆查询**: 是否检查了相关历史经验？
+- **方案比较**: 是否考虑了多种可行方案？
+- **风险评估**: 是否识别了潜在问题？
+
+## 响应格式模板
+
+### 标准响应结构
+```markdown
+## 摘要
+[核心结论，1-3句话]
+
+## 详细分析
+- [发现1，带证据]
+- [发现2，带证据]
+
+## 相关记忆
+- [记忆引用]
+
+## 我的推理
+1. [推理步骤1]
+2. [推理步骤2]
+
+## 建议和下一步
+- [具体建议1]
+- [具体建议2]
+
+## 不确定性声明
+- 置信度: 0.XX
+- 需要验证: [假设]
+```
+
+### 代码建议格式
+```markdown
+### 建议: [标题]
+
+**文件**: `path/to/file.py:行号`
+
+**问题**: [问题描述]
+
+**建议修改**:
+```python
+# 原代码
+old_code()
+
+# 建议改为
+new_code()
+```
+
+**验证方法**: [如何验证]
+**风险**: [潜在风险]
+**置信度**: 0.XX
+```
+
+## 置信度标准
+
+### 等级定义
+- **>0.90**: 高度确信（充分证据，成功经验）
+- **0.70-0.90**: 中等确信（合理推断，部分证据）
+- **<0.70**: 低确信（有限信息，重大不确定）
+
+### 使用指南
+```markdown
+## 置信度: 0.85
+基于3个类似项目的成功经验，但需要验证当前环境兼容性
+```
+
+## 文件系统结构
+
+### 项目根目录
+```
+.ai-runtime/
+├── cognition/          # 认知记录和分析
+├── commands/           # 命令系统和文档
+├── constitution.md     # 宪法治理文档
+├── memory/            # 分层记忆系统
+└── toolkit/           # 工具装备系统
+```
+
+### 记忆系统结构
+```
+memory/
+├── episodic/          # 情景记忆（事件时间线）
+├── long-term/         # 长期记忆（技术知识）
+├── short-term/        # 短期记忆（当前会话）
+├── scripts/           # 查询脚本
+├── references/        # 详细文档
+└── SKILL.md          # 技能定义
+```
+
+## 故障排除
+
+### 常见问题
+- **命令不响应**: 检查语法，确认在正确上下文中使用
+- **记忆查询无结果**: 验证WHERE条件语法和字段名称
+- **置信度过低**: 需要更多信息或调查，主动提出澄清问题
+
+### 紧急联系
+- **宪法文档**: `.ai-runtime/constitution.md`
+- **完整文档**: 各模块的references/目录
+- **记忆查询**: `python3 .ai-runtime/memory/memory_cli.py --help`
+
+## 版本信息
+
+### 当前版本
+- **CodeConscious**: 2.0.0
+- **宪法版本**: 2.0.0
+- **身份版本**: 2.0.0
+- **最后更新**: 2025-11-14
+
+### 兼容性
+- **Python**: 3.8+
+- **操作系统**: macOS, Linux
+- **依赖**: PyYAML (核心)
+
+## 更新日志
+
+### v2.0.0 (2025-11-14)
+- ✨ 完整宪法治理体系
+- 🧠 分层记忆系统重构
+- 🤖 自主学习能力增强
+- 📚 渐进式披露文档架构
+- 🛠️ 工具装备系统优化