Files
2025-11-29 18:24:40 +08:00

4.2 KiB
Raw Permalink Blame History

快速参考指南

常用命令速查

核心运行时命令

# 探索新代码库(首次使用推荐)
/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)

  • 完整宪法治理体系
  • 🧠 分层记忆系统重构
  • 🤖 自主学习能力增强
  • 📚 渐进式披露文档架构
  • 🛠️ 工具装备系统优化