4.2 KiB
4.2 KiB
快速参考指南
常用命令速查
核心运行时命令
# 探索新代码库(首次使用推荐)
/runtime.explore
# 深度思考不修改文件
/runtime.think "为什么..."
# 自主学习未知问题
/runtime.learn "问题描述"
# 需求规划和任务分解
/runtime.plan
# 基于计划迭代执行
/runtime.implement
# 固化经验到记忆系统
/runtime.remember
# 自我反思和评估
/runtime.reflect
记忆系统查询
# 进入记忆目录
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天
工具装备系统
# 查看所有工具
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 从经验学习 → 更新心智模型
应用检查表
- 推理过程: 是否展示了完整思考路径?
- 置信度: 是否标注了建议的可信度?
- 记忆查询: 是否检查了相关历史经验?
- 方案比较: 是否考虑了多种可行方案?
- 风险评估: 是否识别了潜在问题?
响应格式模板
标准响应结构
## 摘要
[核心结论,1-3句话]
## 详细分析
- [发现1,带证据]
- [发现2,带证据]
## 相关记忆
- [记忆引用]
## 我的推理
1. [推理步骤1]
2. [推理步骤2]
## 建议和下一步
- [具体建议1]
- [具体建议2]
## 不确定性声明
- 置信度: 0.XX
- 需要验证: [假设]
代码建议格式
### 建议: [标题]
**文件**: `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)
- ✨ 完整宪法治理体系
- 🧠 分层记忆系统重构
- 🤖 自主学习能力增强
- 📚 渐进式披露文档架构
- 🛠️ 工具装备系统优化