Learning Journal Skill

中文说明

learning-journal 是一个中英文工程学习日志 Skill，用于把调试、慢 SQL、登录鉴权、配置、部署、代码审查等工程问题沉淀为长期知识资产。

它明确区分三类配置和默认规则：

• 个人知识库：长期知识体系，支持目录、Git 仓库、Obsidian vault 或自定义知识库根目录。
• 问题记录 Markdown：可选的追加式 .md 流水记录，例如 今日学习.md 或 问题记录.md。
• GitHub 同步：可选的公有/私有仓库同步规则，包括仓库语言、commit、branch、push 和失败处理。

适合用于：

• 日常问题复盘
• 线上问题沉淀
• 慢 SQL / NPE / 鉴权 / 数据权限 / 配置部署问题总结
• 面试项目经验整理
• 多项目通用知识库建设

English Description

learning-journal is a bilingual engineering learning journal skill for turning debugging work, slow SQL analysis, authentication issues, configuration/deployment problems, code-review lessons, and production incidents into long-term reusable knowledge.

It separates three configuration domains:

• Personal knowledge base: a long-term knowledge system such as a folder, Git repository, Obsidian vault, or custom knowledge-base root.
• Problem-record Markdown: an optional append-only .md log such as today-learning.md or problem-record.md.
• GitHub sync: optional repository synchronization rules, including language, commit style, branch, push policy, and failure handling.

Useful for:

• Engineering retrospectives
• Incident learning notes
• Slow SQL / NPE / auth / data-permission / config / deployment summaries
• Interview-ready project stories
• Cross-project personal knowledge-base workflows

Repository Structure

learning-journal/
  SKILL.md

Install Locally

Clone this repository, then register the skill from the repository root or from your local skills directory according to your agent tool's skill installation workflow.

For Codex/Skills CLI users, a typical local registration flow is:

npx skills add <path-to-this-repo> -g -a codex --skill learning-journal -y

Then start a fresh Codex session before using:

$learning-journal

License

No license has been selected yet. Add a license before broad redistribution if needed.