diff --git a/config/agent/CLAUDE.md b/config/agent/CLAUDE.md new file mode 100644 index 0000000..4a083ee --- /dev/null +++ b/config/agent/CLAUDE.md @@ -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 会在每次任务开始时自动读取此文件,遵循定义的规范和约束。 \ No newline at end of file diff --git a/config/agent/file-creation-standards.md b/config/agent/agent.md similarity index 100% rename from config/agent/file-creation-standards.md rename to config/agent/agent.md diff --git a/config/agent/learning-index.md b/config/agent/learning-index.md deleted file mode 100644 index 88f6d4e..0000000 --- a/config/agent/learning-index.md +++ /dev/null @@ -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框架 | diff --git a/config/agent/policies/allowlist.md b/config/agent/policies/allowlist.md new file mode 100644 index 0000000..b325800 --- /dev/null +++ b/config/agent/policies/allowlist.md @@ -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 + +## 处理特殊情况 +- ✅ 配置文件和开发文件可灵活调整结构 +- ✅ 在用户明确要求时使用非标准结构 \ No newline at end of file diff --git a/config/agent/policies/blocklist.md b/config/agent/policies/blocklist.md new file mode 100644 index 0000000..9e275e8 --- /dev/null +++ b/config/agent/policies/blocklist.md @@ -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 密钥或敏感信息 \ No newline at end of file diff --git a/config/agent/policies/standards.md b/config/agent/policies/standards.md new file mode 100644 index 0000000..5f3597c --- /dev/null +++ b/config/agent/policies/standards.md @@ -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 图表,但需确保其正确性和可读性 \ No newline at end of file