메뉴
开发日志记录规范。每次完成代码修改后，必须使用此技能记录开发日志到 docs/dev_logs/ 目录。当你完成任何代码变更、Bug 修复、功能开发或重构时，使用此技能。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | dev-logs |
| description | 开发日志记录规范。每次完成代码修改后，必须使用此技能记录开发日志到 docs/dev_logs/ 目录。当你完成任何代码变更、Bug 修复、功能开发或重构时，使用此技能。 |
每次开发任务完成后，你必须在 docs/dev_logs/ 下创建或追加开发日志。日志具有数据库快照属性，支持后续回滚。
隐私策略：开发日志中禁止写入明文敏感信息（数据库连接串、密码、token、私有地址等）；敏感信息统一记录到本地私有模块
docs/private_context/，日志仅写引用标识。
docs/dev_logs/{YYYY-MM-DD}/{序号}-{简短描述}.md
2026-02-07/01-init-knowledge-graph.md、02-bugfix-five-issues.md01 开始在日志最顶部，记录触发本次开发的完整对话。多轮对话时记录与本次变更相关的所有轮次，并按固定结构循环记录，便于几天后回看仍可理解上下文。
格式要求：
> 原文完整记录，不可省略或摘要## 对话记录
### 第 1 轮
- 背景: 正在初始化知识图谱站点，需要先确定技术栈与初始节点结构。
- 用户:
> 我正在研究学习AI, 创建一个网站，以graph的形式，进行知识点拓展
> 目前有三个类别 vibe coding skills, agent dev, llm fundemental
- 用户的意图解析: 先搭建可扩展的图谱基础框架，并把 3 个类别作为首批核心入口。
- LLM思考摘要: 采用 React + @xyflow/react，先实现根节点与基础交互，后续按类别扩展子节点。
### 第 2 轮
- 背景: 技术方案已确认，进入落地阶段。
- 用户:
> 对，开始搭建吧
- 用户的意图解析: 用户希望立即进入实现，不再停留在方案讨论。
- LLM思考摘要: 创建项目骨架、知识图谱组件与初始数据文件，确保可运行与可继续迭代。
精确到秒的时间戳。
**修改时间**: 2026-02-07 11:28:00
一句话说明本次开发做了什么（业务视角）。
表格形式列出每个被修改/新增/删除的文件，包含路径、修改时间和变更说明。
| 文件 | 操作 | 修改时间 | 说明 |
|------|------|----------|------|
| `web/src/App.tsx` | 修改 | 2026-02-07 11:26:43 | 添加路由配置 |
| `web/src/pages/Home.tsx` | 新增 | 2026-02-07 11:27:10 | 首页组件 |
对关键变更提供详细说明，包括：
记录 TypeScript 检查、ESLint、Vite 构建、测试等验证结果。
## 验证结果
- ✔ TypeScript 类型检查通过
- ✔ ESLint 代码规范通过
- ✔ Vitest 测试通过 (6/6)
- ✔ Vite 生产构建通过
用于后续快速回放到对应代码状态。至少包含：
branch：当前分支commit：本轮对应提交哈希（未提交则写 N/A 并说明原因）tag/backup：如创建了检查点标签或备份分支需写明示例：
## Git 锚点
- branch: `main`
- commit: `abc1234`
- tag: `checkpoint/2026-02-07-knowledge-trash`
当本轮涉及敏感信息时，必须记录引用而非明文：
privacy_ref，例如：privacy_ref: docs/private_context/refs.local.md#db-sync-20260207docs/private_context/（该目录默认不入库）docs/dev_logs/{今天日期}/ 目录背景 → 用户（原文引用）→ 用户的意图解析 → LLM思考摘要privacy_ref 并把明文移入 docs/private_context/代码构建全链路质量门禁。当你完成代码修改后，必须使用此技能运行构建检查确保代码质量。适用于任何前端代码变更后的验证。
依赖关系优先的 AI Review 总调度 Skill。通过“机械门禁 + LLM 判读 + 人工兜底”输出可执行评审结论。
本地开发全链路 SOP。接到任何开发任务时，按此流程从需求理解到 Git 管理完整执行，串联所有子 Skills 形成闭环。
通用模块化治理 Skill。用于通过机械量化脚本检查模块边界、依赖方向、循环依赖与变更风险，并以 PASS/REFINE/BLOCK 输出可修复反馈。适用于 LLM 分治式开发中的框架校验、自动 review 闭环、以及模块重构验收。
Git 管理规范。出现阶段性成果或准备进行大改动时，使用此技能建立可回滚、可追溯的版本控制节奏。
仓库架构文档同步。当文件结构发生变化（新增/删除/移动文件或目录）时，必须使用此技能更新仓库元数据和架构文档。