vault backup: 2026-04-20 23:28:57
This commit is contained in:
@@ -0,0 +1,30 @@
|
||||
---
|
||||
tags: [config, claude, standards]
|
||||
---
|
||||
|
||||
# Claude Code 项目配置
|
||||
|
||||
本项目是 Obsidian vault,Claude Code 作为 AI 协作者协助知识管理。
|
||||
|
||||
## 核心原则
|
||||
|
||||
1. **Obsidian Native**: 理解 Markdown、YAML frontmatter、Wiki-links
|
||||
2. **Safety First**: 从不未经理解覆盖数据,始终使用相对路径
|
||||
3. **Proactive**: 预期潜在问题(如断链、缺失文件)
|
||||
4. **Clarity**: 精准变更,最小化笔记噪音
|
||||
|
||||
## 操作规范
|
||||
|
||||
- 详见 [[config/agent/policies/standards.md]]
|
||||
- 正面清单:[[config/agent/policies/allowlist.md]]
|
||||
- 负面清单:[[config/agent/policies/blocklist.md]]
|
||||
|
||||
## 可用 Skills
|
||||
|
||||
- [[config/agent/skills/note-creation.md]]: 笔记创建
|
||||
- [[config/agent/skills/file-edit.md]]: 文件编辑
|
||||
- [[config/agent/skills/link-management.md]]: 链接管理
|
||||
|
||||
## 集成方式
|
||||
|
||||
Claude 会在每次任务开始时自动读取此文件,遵循定义的规范和约束。
|
||||
@@ -1,33 +0,0 @@
|
||||
---
|
||||
tags: [index, learning, cs]
|
||||
create time: 2026-04-17
|
||||
---
|
||||
|
||||
# 计算机科学学习索引
|
||||
|
||||
## 学习领域导航
|
||||
|
||||
### 计算机技术基础
|
||||
- [[CS/README|CS]] - 计算机科学总览
|
||||
- [[CS/OS/README|OS]] - 操作系统
|
||||
- [[CS/NET/README|NET]] - 计算机网络
|
||||
- [[CS/NET/Authorization]] - Authorization 授权机制
|
||||
- [[CS/DB/README|DB]] - 数据库
|
||||
- [[CS/TOOLS/README|TOOLS]] - 工具使用
|
||||
|
||||
### 开发实践
|
||||
- [[DEV/GO/README|GO]] - Go语言服务端开发
|
||||
- [[DEV/REACT/README|REACT]] - React前端开发
|
||||
|
||||
## 目录缩写说明
|
||||
|
||||
| 缩写 | 全称 | 描述 |
|
||||
|------|------|------|
|
||||
| CS | Computer Science | 计算机科学 |
|
||||
| OS | Operating Systems | 操作系统 |
|
||||
| NET | Network | 计算机网络 |
|
||||
| DB | Database | 数据库 |
|
||||
| TOOLS | Tools | 工具使用 |
|
||||
| DEV | Development | 开发实践 |
|
||||
| GO | Go Language | Go语言 |
|
||||
| REACT | React Framework | React框架 |
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
tags: [config, agent, policy]
|
||||
---
|
||||
|
||||
# Claude 操作正面清单
|
||||
|
||||
以下操作为明确允许的操作:
|
||||
|
||||
## 文件操作
|
||||
- ✅ 读取 vault 内任何 Markdown 文件
|
||||
- ✅ 创建新文件(遵循 [[config/agent/agent.md]] 规范)
|
||||
- ✅ 编辑现有文件(使用 Edit 工具进行精准变更)
|
||||
- ✅ 使用相对路径访问文件
|
||||
|
||||
## 内容结构
|
||||
- ✅ 添加/更新 YAML frontmatter
|
||||
- ✅ 使用 Wiki-links `[[note-name]]`
|
||||
- ✅ 使用标签 `#tag-name`
|
||||
- ✅ 保留或简化 Dataview 查询
|
||||
|
||||
## 搜索与导航
|
||||
- ✅ 使用 Grep 搜索内容
|
||||
- ✅ 使用 Glob 查找文件
|
||||
- ✅ 分析链接关系和依赖
|
||||
|
||||
## Git 操作(受限)
|
||||
- ✅ 运行 `git status` 查看状态
|
||||
- ✅ 运行 `git diff` 查看变更
|
||||
- ⚠️ 提交、推送等操作需要用户明确请求
|
||||
|
||||
## 资产管理
|
||||
- ✅ 读取本地图片(PNG, JPG, GIF, WebP)
|
||||
- ✅ 下载外部图片到 media 文件夹
|
||||
- ✅ 替换图片链接为本地 wiki-link
|
||||
|
||||
## 处理特殊情况
|
||||
- ✅ 配置文件和开发文件可灵活调整结构
|
||||
- ✅ 在用户明确要求时使用非标准结构
|
||||
@@ -0,0 +1,40 @@
|
||||
---
|
||||
tags: [config, agent, policy]
|
||||
---
|
||||
|
||||
# Claude 操作负面清单
|
||||
|
||||
以下操作为明确禁止的操作:
|
||||
|
||||
## 文件操作
|
||||
- ❌ 未经 Read 工具直接 Edit 文件
|
||||
- ❌ 使用绝对路径访问 vault 文件
|
||||
- ❌ 覆盖 `.obsidian/` 配置(除非明确要求)
|
||||
- ❌ 删除文件(除非用户明确要求)
|
||||
|
||||
## 内容变更
|
||||
- ❌ 添加 emoji(除非用户明确要求)
|
||||
- ❌ 创建文档文件(README.md, *.md)(除非明确要求)
|
||||
- ❌ 破坏 Dataview 查询语法
|
||||
- ❌ 移除必要的 YAML frontmatter 字段
|
||||
|
||||
## 路径规范
|
||||
- ❌ 在 vault 内使用 `/path/to/file` 格式
|
||||
- ❌ 使用 `/home/user/...` 绝对路径引用 vault 文件
|
||||
- ❌ 混淆 Wiki-links 和 Markdown 链接
|
||||
|
||||
## Git 操作
|
||||
- ❌ 跳过 hooks(--no-verify)
|
||||
- ❌ 跳过签名(--no-gpg-sign)
|
||||
- ❌ 强制 push 到 main/master(警告用户)
|
||||
- ❌ 使用 --interactive 或 --amend 标志
|
||||
|
||||
## 系统命令
|
||||
- ❌ 运行 find、grep、cat(使用专用工具代替)
|
||||
- ❌ 创建空 git commit
|
||||
- ❌ 修改全局 git 配置
|
||||
- ❌ 运行破坏性命令(reset --hard, clean -f 等)
|
||||
|
||||
## 数据安全
|
||||
- ❌ 提交包含凭据的文件(.env, credentials.json)
|
||||
- ❌ 分享 API 密钥或敏感信息
|
||||
@@ -0,0 +1,66 @@
|
||||
---
|
||||
tags: [config, agent, policy]
|
||||
---
|
||||
|
||||
# Claude 操作规范
|
||||
|
||||
## 通用原则
|
||||
|
||||
1. **遵循现有结构**: 严格遵循项目中已有的文件结构和格式
|
||||
2. **安全第一**: 在修改任何文件前都必须先读取,维护现有的内容和结构
|
||||
3. **清晰性**: 所有操作必须清晰、可理解,避免混乱或不明确的变更
|
||||
|
||||
## 内容创作规范
|
||||
|
||||
1. **结构**:
|
||||
- 优先使用 Markdown 标题格式
|
||||
- 保持一致的段落结构
|
||||
- 合理使用列表来组织信息
|
||||
|
||||
2. **标签**:
|
||||
- 使用 YAML frontmatter 包含适当的标签
|
||||
- 标签必须是数组形式 `tags: [tag1, tag2]`
|
||||
- 尽可能使用相关领域的标签
|
||||
|
||||
3. **链接**:
|
||||
- 内部链接使用 Wiki-links: `[[note-name]]`
|
||||
- 外部链接使用标准 Markdown 格式: `[text](url)`
|
||||
- 确保所有内部链接都指向实际存在的文件
|
||||
|
||||
4. **内容质量**:
|
||||
- 避免使用占位文本,如 "[内容]"、"[描述]" 等
|
||||
- 保持写作风格一致和专业
|
||||
- 根据内容添加相关图表或 Mermaid 图表
|
||||
|
||||
## 文件和路径规范
|
||||
|
||||
1. **路径使用**:
|
||||
- 仅使用相对路径进行文件访问
|
||||
- 路径不应包含绝对路径(如 `/home/...`)
|
||||
|
||||
2. **文件操作**:
|
||||
- 不应在 Vault 内创建 README.md、*.md 等文档文件
|
||||
- 创建新文件时,应遵循现有的文件结构规范
|
||||
|
||||
## Git 和版本控制
|
||||
|
||||
1. **提交操作**:
|
||||
- 不应自动执行任何 Git 提交或推送操作
|
||||
- 如需执行 Git 相关操作,必须让用户明确授权
|
||||
|
||||
2. **变更检查**:
|
||||
- 检查文件变更以维护链接一致性
|
||||
- 发现断链时应记录并报告
|
||||
|
||||
## 特殊情况处理
|
||||
|
||||
1. **知识库层面的处理**:
|
||||
- 若涉及高层架构、系统设计等内容,应优先根据已有文档进行整理补充
|
||||
- 不应创造新的结构或模式,而应遵循既有规范
|
||||
|
||||
2. **代码实现**:
|
||||
- 当需要编写代码示例时,优先使用 Go 语言(后端)或 React/TS(前端)
|
||||
- 所有实现示例应在当前环境中实际可行
|
||||
|
||||
3. **数据可视化**:
|
||||
- 使用 Mermaid 图表,但需确保其正确性和可读性
|
||||
Reference in New Issue
Block a user