cleanup: remove old framework files and update CLAUDE.md
- Remove legacy agent/, todo/, souls/, insights/, conversations/ folders - Remove outdated skills (coding.md, debugging.md, architecture.md) - Remove old memory files (core.json, current_mode.json) - Update CLAUDE.md with workspace structure and knowledge retrieval principles - Add .claude/ and .obsidian/ to .gitignore
This commit is contained in:
Zhengshou Lai
@@ -1,42 +0,0 @@
|
||||
# 架构设计技能 (Architecture Skill)
|
||||
|
||||
## 设计原则
|
||||
1. **简单优于复杂**: 能简单就不复杂
|
||||
2. **显式优于隐式**: 清晰的依赖和控制流
|
||||
3. **组合优于继承**: 通过组合实现复用
|
||||
4. **推迟决策**: 不确定时保持可变性
|
||||
|
||||
## 分层架构
|
||||
|
||||
```
|
||||
┌─────────────┐
|
||||
│ Interface │ ← API / CLI / Web
|
||||
├─────────────┤
|
||||
│ Application │ ← Use Cases / Services
|
||||
├─────────────┤
|
||||
│ Domain │ ← Entities / Business Logic
|
||||
├─────────────┤
|
||||
│Infrastructure│ ← Storage / External
|
||||
└─────────────┘
|
||||
```
|
||||
|
||||
## 设计检查清单
|
||||
- [ ] 职责是否清晰分离？
|
||||
- [ ] 模块间依赖是否合理？
|
||||
- [ ] 是否可测试？
|
||||
- [ ] 是否可扩展？
|
||||
- [ ] 错误如何处理？
|
||||
|
||||
## 反模式识别
|
||||
- 上帝类/上帝函数
|
||||
- 重复代码
|
||||
- 过度工程
|
||||
- 过早优化
|
||||
- 循环依赖
|
||||
|
||||
## 决策框架
|
||||
1. 当前需求的本质是什么？
|
||||
2. 未来可能的变化方向？
|
||||
3. 简单方案的代价？
|
||||
4. 复杂方案的收益？
|
||||
5. 推迟决策的成本？
|
||||
@@ -1,46 +0,0 @@
|
||||
# 编程技能 (Coding Skill)
|
||||
|
||||
## 代码风格
|
||||
- Python: Black (80字符), Ruff, MyPy
|
||||
- 优先可读性，其次简洁
|
||||
- 有意义的命名 > 注释解释命名
|
||||
|
||||
## 编码原则
|
||||
1. **单一职责**: 每个函数/类只做一件事
|
||||
2. **类型注解**: 使用类型提示提高可维护性
|
||||
3. **错误处理**: 显式处理边界情况和异常
|
||||
4. **测试友好**: 代码结构便于单元测试
|
||||
|
||||
## 代码审查清单
|
||||
- [ ] 是否有类型注解？
|
||||
- [ ] 错误处理是否完善？
|
||||
- [ ] 命名是否清晰？
|
||||
- [ ] 是否有过度工程？
|
||||
- [ ] 是否符合项目现有风格？
|
||||
|
||||
## 常用模式
|
||||
|
||||
### 异步代码
|
||||
```python
|
||||
async def process_items(items: list[T]) -> list[R]:
|
||||
tasks = [process_one(item) for item in items]
|
||||
return await asyncio.gather(*tasks)
|
||||
```
|
||||
|
||||
### 错误处理
|
||||
```python
|
||||
from typing import TypeVar, Generic
|
||||
|
||||
T = TypeVar('T')
|
||||
|
||||
class Result(Generic[T]):
|
||||
def __init__(self, ok: bool, value: T | None = None, error: str | None = None):
|
||||
self.ok = ok
|
||||
self.value = value
|
||||
self.error = error
|
||||
```
|
||||
|
||||
## 禁忌
|
||||
- 不要用 `except:` 捕获所有异常
|
||||
- 不要修改全局状态
|
||||
- 不要有副作用的 property
|
||||
@@ -1,42 +0,0 @@
|
||||
# 调试技能 (Debugging Skill)
|
||||
|
||||
## 调试原则
|
||||
1. **复现优先**: 能稳定复现才算找到原因
|
||||
2. **隔离变量**: 一次只改一个因素
|
||||
3. **最小化**: 找到最小复现路径
|
||||
4. **验证假设**: 每个假设都要有证据
|
||||
|
||||
## 调试流程
|
||||
|
||||
### 1. 问题确认
|
||||
- [ ] 错误信息是什么？
|
||||
- [ ] 什么情况下发生？
|
||||
- [ ] 是否可以稳定复现？
|
||||
- [ ] 最近有什么变更？
|
||||
|
||||
### 2. 信息收集
|
||||
- [ ] 完整错误堆栈
|
||||
- [ ] 相关日志
|
||||
- [ ] 输入数据样本
|
||||
- [ ] 环境信息
|
||||
|
||||
### 3. 定位方法
|
||||
- 二分法：注释掉一半代码，看问题是否还在
|
||||
- 对比法：对比正常情况和异常情况的差异
|
||||
- 日志法：在关键点插入日志，追踪执行路径
|
||||
|
||||
### 4. 修复验证
|
||||
- [ ] 修复后是否解决问题？
|
||||
- [ ] 是否引入新问题？
|
||||
- [ ] 测试用例是否通过？
|
||||
|
||||
## 常见陷阱
|
||||
- 不要根据现象猜测原因
|
||||
- 不要同时尝试多种修复
|
||||
- 不要忽略警告信息
|
||||
- 不要假设"不可能"
|
||||
|
||||
## 工具使用
|
||||
- 优先用日志而非调试器
|
||||
- 复杂状态用 pdb/ipdb
|
||||
- 性能问题用 profiler
|
||||
@@ -1,30 +0,0 @@
|
||||
---
|
||||
name: todo
|
||||
description: 管理 Todo 任务 - 支持直接操作和后台 Agent 模式。添加、列出、完成任务，或启动后台 Agent 异步处理。
|
||||
---
|
||||
|
||||
# Todo Skill
|
||||
|
||||
个人待办事项管理，支持两种模式。
|
||||
|
||||
## 模式一：直接操作（默认）
|
||||
|
||||
- `/todo add "任务内容" -p 1` - 添加高优先级任务
|
||||
- `/todo list` - 列出所有任务
|
||||
- `/todo done <id>` - 完成任务
|
||||
- `/todo delete <id>` - 删除任务
|
||||
|
||||
## 模式二：后台 Agent
|
||||
|
||||
启动后台 Agent 轮询处理异步指令：
|
||||
|
||||
```
|
||||
/loop 30s /todo agent
|
||||
```
|
||||
|
||||
Agent 工作流程：
|
||||
1. 轮询 `.claude/todo/inbox/` 目录
|
||||
2. 读取 `cmd_*.json` 指令文件
|
||||
3. 执行操作（add/list/done/delete/update）
|
||||
4. 写入 `rsp_*.json` 响应
|
||||
5. 更新心跳和日志
|
||||
Reference in New Issue
Block a user