vault backup: 2026-04-22 10:10:19
This commit is contained in:
@@ -1,30 +0,0 @@
|
||||
---
|
||||
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 会在每次任务开始时自动读取此文件,遵循定义的规范和约束。
|
||||
@@ -0,0 +1,42 @@
|
||||
|
||||
# 文件创建/修改规范
|
||||
|
||||
## 格式
|
||||
|
||||
```yaml
|
||||
---
|
||||
tags: []
|
||||
create time: YYYY-MM-DD HH:mm
|
||||
---
|
||||
|
||||
# <标题>
|
||||
|
||||
## 概述
|
||||
[简短描述]
|
||||
|
||||
## 正文
|
||||
[按照内容规范生成的内容]
|
||||
|
||||
## 关联笔记
|
||||
- [[相关笔记-可不填-无需链接README]]
|
||||
```
|
||||
|
||||
## 必填项
|
||||
|
||||
| 字段 | 格式 | 说明 |
|
||||
|------|------|------|
|
||||
| `tags` | 数组 | 必须存在 `[]`,智能填充相关标签 |
|
||||
| `create time` | `YYYY-MM-DD HH:mm` | 当前系统时间 |
|
||||
|
||||
## 文档结构
|
||||
|
||||
1. **## 概述**: 简短描述文档内容,不要保留占位文本
|
||||
2. **## 正文**: 主要内容,详略得当,注重拓展进阶
|
||||
3. **## 关联笔记**: 相关笔记 Wiki-links,若无可移除
|
||||
|
||||
## 内容规范【IMPORTANT】
|
||||
|
||||
- **教学者模式**: 假设你是教学者,你需要先规划如何记录这个知识点,让读者能够容易理解。你也可以穿插问题在文档中,启发学生的思考。
|
||||
- **代码示例**: 优先 Go (后端) + React/TS (前端),代码示例点到为止,不要过于冗长。可以适当通过注释省略一部分代码增强可读性,体现核心逻辑即可。当你给出代码时,一定要给出对应的文本解释。
|
||||
- **图表**: 遇到关键概念、流程,仅仅靠文字不容易清晰说明,此时应该使用 Mermaid。
|
||||
- **风格**: 详略得当,注重实用性。文风严谨但是不失“活人感”,循序渐进,深入浅出。
|
||||
@@ -1,63 +0,0 @@
|
||||
---
|
||||
tags: [config, agent, standards]
|
||||
create time: 2026-04-17 11:29
|
||||
update time: 2026-04-18
|
||||
---
|
||||
|
||||
# 文件创建规范
|
||||
|
||||
## 核心规则
|
||||
|
||||
**所有新文件必须遵循以下结构:**
|
||||
|
||||
```yaml
|
||||
---
|
||||
tags: []
|
||||
create time: YYYY-MM-DD HH:mm
|
||||
---
|
||||
|
||||
# <标题>
|
||||
|
||||
## 概述
|
||||
[简短描述]
|
||||
|
||||
## 正文
|
||||
[内容]
|
||||
|
||||
## 关联笔记
|
||||
- [[相关笔记]]
|
||||
```
|
||||
|
||||
## 必填项
|
||||
|
||||
| 字段 | 格式 | 说明 |
|
||||
|------|------|------|
|
||||
| `tags` | 数组 | 必须存在 `[]`,智能填充相关标签 |
|
||||
| `create time` | `YYYY-MM-DD HH:mm` | 当前系统时间 |
|
||||
|
||||
## 文档结构
|
||||
|
||||
1. **## 概述**: 简短描述文档内容,不要保留占位文本
|
||||
2. **## 正文**: 主要内容,详略得当,注重拓展进阶
|
||||
3. **## 关联笔记**: 相关笔记 Wiki-links,若无可移除
|
||||
|
||||
## 内容规范
|
||||
|
||||
- **代码示例**: 优先 Go (后端) + React/TS (前端)
|
||||
- **图表**: 选择性使用 Mermaid
|
||||
- **风格**: 详略得当,注重实用性
|
||||
|
||||
## Agent 执行步骤
|
||||
|
||||
1. 读取模板: `[[config/template/default-template.md]]`
|
||||
2. 创建文件并填充 `create time`
|
||||
3. 智能填充 `tags`
|
||||
4. 替换占位文本为实际内容
|
||||
5. 添加相关 Wiki-links
|
||||
|
||||
## 特殊情况
|
||||
|
||||
配置文件、开发文件等可灵活调整结构,但需保留:
|
||||
- `tags` 字段
|
||||
- `create time` 记录
|
||||
- 清晰的组织结构
|
||||
@@ -1,38 +0,0 @@
|
||||
---
|
||||
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
|
||||
|
||||
## 处理特殊情况
|
||||
- ✅ 配置文件和开发文件可灵活调整结构
|
||||
- ✅ 在用户明确要求时使用非标准结构
|
||||
@@ -1,40 +0,0 @@
|
||||
---
|
||||
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 密钥或敏感信息
|
||||
@@ -1,66 +0,0 @@
|
||||
---
|
||||
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 图表,但需确保其正确性和可读性
|
||||
@@ -1,18 +0,0 @@
|
||||
---
|
||||
tags: []
|
||||
create time: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
---
|
||||
|
||||
# <% tp.file.title %>
|
||||
|
||||
## 概述
|
||||
|
||||
添加笔记的概述或简短描述。
|
||||
|
||||
## 正文
|
||||
|
||||
在这里写下你的笔记内容...
|
||||
|
||||
## 关联笔记
|
||||
|
||||
- 添加关联笔记的链接
|
||||
Reference in New Issue
Block a user