dev-km
4-layer knowledge capture system for development sessions with session management, retrospectives, and knowledge distillation.
- License 许可
- MIT
- 所属仓库
- goffity/dev-km
- 最近更新
- 2026-11-10
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- dev-km
- description
- 4-layer knowledge capture system for development sessions with session management, retrospectives, and knowledge distillation.
- user-invocable
- false
02 资源文件 109
- 参考文档.claude/hooks.example.json1.0 KB
- 脚本.claude/scripts/notify.sh2.6 KB
- 参考文档.claude/settings.json1.0 KB
- 参考文档.github/workflows/auto-pr-review.yml6.0 KB
- 参考文档.github/workflows/release.yml4.6 KB
- 其他.gitignore144 B
- 资产文件assets/commands/cleanup.md3.2 KB
- 资产文件assets/commands/commit.md753 B
- 资产文件assets/commands/distill.md2.2 KB
- 资产文件assets/commands/docs-update.md4.8 KB
- 资产文件assets/commands/example.md2.3 KB
- 资产文件assets/commands/flow.md1.8 KB
- 资产文件assets/commands/focus.md11.1 KB
- 资产文件assets/commands/improve.md2.0 KB
- 资产文件assets/commands/jira.md11.7 KB
- 资产文件assets/commands/mem.md1.2 KB
- 资产文件assets/commands/pattern.md1.6 KB
- 资产文件assets/commands/permission.md8.6 KB
- 资产文件assets/commands/pr-poll.md4.8 KB
- 资产文件assets/commands/pr-review.md13.3 KB
- 资产文件assets/commands/pr.md15.0 KB
- 资产文件assets/commands/README.md22.2 KB
- 资产文件assets/commands/recap.md4.8 KB
- 资产文件assets/commands/review.md4.0 KB
- 资产文件assets/commands/search.md2.0 KB
- 资产文件assets/commands/share.md1.3 KB
- 资产文件assets/commands/summary.md3.4 KB
- 资产文件assets/commands/td.md14.0 KB
- 参考文档AUTO-CAPTURE.md7.1 KB
- 参考文档CHANGELOG.md5.7 KB
- 参考文档CLAUDE.md4.0 KB
- 其他docs/auto-captured/.gitkeep—
- 参考文档docs/auto-captured/2026-06/19/11.55_session-4959.md1.6 KB
- 参考文档docs/current.md134 B
- 其他docs/examples/.gitkeep—
- 其他docs/flows/.gitkeep—
- 其他docs/knowledge-base/.gitkeep—
- 参考文档docs/knowledge-base/claude-instance-configuration.md5.1 KB
- 参考文档docs/knowledge-base/git-workflow-patterns.md4.1 KB
- 参考文档docs/knowledge-base/github-api-patterns.md9.5 KB
- 参考文档docs/knowledge-base/heredoc-quoting.md3.7 KB
- 其他docs/learnings/.gitkeep—
- 参考文档docs/learnings/2025-12/23/17.23_no-footer-in-github-issues.md1.0 KB
- 参考文档docs/learnings/2026-02/10/01.18_no-co-authored-by-in-commits.md1.4 KB
- 参考文档docs/learnings/2026-02/10/01.25_global-claude-md-rules-specialist-visible.md1.6 KB
- 其他docs/logs/activity.log3.9 KB
- 其他docs/patterns/.gitkeep—
- 其他docs/retrospective/.gitkeep—
- 参考文档docs/retrospective/2026-01/12/retrospective_2026-01-12_114152.md4.0 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-09_182730.md3.7 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-09_193400.md3.7 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-09_203700.md3.7 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-09_211600.md3.6 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-10_092500.md5.1 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-10_111725.md3.9 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-14_022800.md3.5 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-14_032400.md4.1 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-14_225435.md4.3 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-14_230857.md3.1 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_000912.md3.7 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_003021.md3.8 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_004629.md4.7 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_010945.md4.7 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_192930.md4.5 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_200134.md3.5 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_223200.md5.0 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_231500.md4.8 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-15_234500.md3.6 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-22_232800.md4.2 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-23_152435.md3.6 KB
- 参考文档docs/retrospective/2026-01/retrospective_2026-01-23_165317.md5.6 KB
- 参考文档docs/retrospective/2026-02/retrospective_2026-02-04_145905.md4.2 KB
- 参考文档docs/retrospective/2026-02/retrospective_2026-02-09_120700.md4.8 KB
- 参考文档docs/retrospective/2026-02/retrospective_2026-02-09_123729.md4.5 KB
- 参考文档docs/retrospective/2026-02/retrospective_2026-02-10_011353.md6.2 KB
- 参考文档docs/retrospective/2026-03/retrospective_2026-03-05_015400.md4.4 KB
- 其他docs/shared-knowledge/.gitkeep—
- 其他docs/summaries/.gitkeep—
- 参考文档docs/summaries/2026-01-week04.md4.5 KB
- 参考文档docs/summaries/2026-02-week06.md3.3 KB
- 参考文档hooks.json1.0 KB
- 许可证LICENSE1.0 KB
- 参考文档README.md29.1 KB
- 参考文档references/bash-helpers.md1.6 KB
- 参考文档references/distill-template.md3.3 KB
- 参考文档references/improve-workflow.md4.0 KB
- 参考文档references/jira-integration.md11.0 KB
- 参考文档references/language-guide.md13.7 KB
- 参考文档references/mem-template.md1.3 KB
- 参考文档references/td-template.md4.9 KB
- 参考文档ROADMAP.md7.0 KB
- 脚本scripts/ai-capture.sh6.9 KB
- 脚本scripts/auto-capture.sh4.3 KB
- 脚本scripts/build-index.sh5.2 KB
- 脚本scripts/claude-wrap.sh4.4 KB
- 脚本scripts/cleanup.sh11.7 KB
- 脚本scripts/consolidate.sh18.0 KB
- 脚本scripts/docs-push-detect.sh668 B
- 脚本scripts/init.sh4.5 KB
- 脚本scripts/install-symlinks.sh1.7 KB
- 脚本scripts/jira-client.sh58.3 KB
- 脚本scripts/notify.sh3.6 KB
- 脚本scripts/pr-review-poll-start.sh2.6 KB
- 脚本scripts/pr-review-poll-status.sh2.3 KB
- 脚本scripts/pr-review-poll-stop.sh1.0 KB
- 脚本scripts/pr-review-poll.sh19.0 KB
- 脚本scripts/uninstall-symlinks.sh1.3 KB
- 参考文档SETUP.md3.0 KB
- 参考文档USAGE.md13.0 KB
03 SKILL.md 正文
Development Knowledge Management System
4-layer system for capturing and organizing development knowledge.
Dev Flow
/recap → /focus (issue + branch) → /tdd (red-green loop) + /commit → /td (retrospective) + /mem (capture knowledge)
Core Skills (user-invocable)
| Skill | Layer | Output | Trigger |
|---|---|---|---|
/mem [topic] |
1 | kb/05-ai-reviewed/learnings/YYYY-MM/DD/HH.MM_slug.md |
Quick insight capture |
/distill [topic] |
2 | kb/02-patterns/<domain>/[topic].md |
3+ learnings on same topic |
/td |
3 | kb/05-ai-reviewed/retrospective/YYYY-MM/retrospective_*.md |
Task completed |
/improve |
4 | Implementation | Work on pending items |
/recap |
- | Context summary | Start new session |
/focus [task] |
- | Issue + branch | Set current task |
Git & PR Skills (user-invocable)
| Skill | Purpose |
|---|---|
/commit |
Atomic commits (TDD-aware, self-contained) |
/pr |
Tests, build, review, create PR |
/review |
Code review before push |
/pr-review |
Handle PR review feedback (own PR) |
/pr-audit [pr#] |
Reviewer-side deep audit of an open PR (clone+build, inline+summary) |
/pr-poll |
PR review notification daemon |
Knowledge & Docs Skills (user-invocable)
| Skill | Purpose |
|---|---|
/cleanup |
Retention policy management |
/consolidate |
Daily session file consolidation |
/summary |
Weekly/monthly summaries |
/search |
Search knowledge index |
/example |
Save code examples |
/flow |
Process flow diagrams |
/pattern |
Design pattern docs |
/share |
Cross-project knowledge sharing |
Integration & Config Skills (user-invocable)
| Skill | Purpose |
|---|---|
/jira |
Jira issue management |
/permission |
Manage Claude Code permissions |
Specialist Skills (context: fork, not user-invocable)
| Skill | Purpose |
|---|---|
code-reviewer |
Reviews code for bugs, security, performance |
session-analyzer |
Analyzes git changes for retrospective drafts |
knowledge-curator |
Scans learnings, suggests distill topics |
build-validator |
Validates build, tests, lint before push |
code-simplifier |
Simplifies code, reduces complexity |
security-auditor |
OWASP Top 10 security audit |
Directory Structure
kb/ # symlink to Obsidian second-brain vault
├── 02-patterns/ # /distill, /pattern output (curated patterns)
│ ├── <domain>/ # grpc, observability, database, k8s, ...
│ ├── anti-patterns/ # anti-pattern registry
│ ├── examples/ # /example output
│ └── flows/ # /flow output
├── 03-bugs/ # Bug postmortems (scanned by /improve)
├── 04-decisions/ # ADRs (scanned by /improve)
└── 05-ai-reviewed/
├── learnings/ # /mem output
│ └── YYYY-MM/DD/
├── retrospective/ # /td output
│ └── YYYY-MM/
└── summaries/ # /summary output
docs/ # repo-local, NOT in vault
├── auto-captured/ # Auto-capture output
├── shared-knowledge/ # /share output
├── logs/ # Activity log
└── current.md # Current focus state (STATE/TASK/ISSUE/BRANCH/LANGUAGE)
kb/= symlink to the Obsidian vault. Legacydocs/{learnings,knowledge-base,retrospective,...}paths are deprecated.
Setup
./scripts/init.sh $PROJECT_ROOT
Language Support
Output language is configured via LANGUAGE field in docs/current.md.
| Value | Behavior |
|---|---|
en (default) |
All generated output in English |
th |
Generated output in Thai (commit messages stay English) |
Set during /focus or manually edit docs/current.md. See references/language-guide.md for translation reference.
References
references/bash-helpers.md- Common bash snippets (TZ, language detection, focus context)references/mem-template.md- Full /mem templatereferences/distill-template.md- Full /distill templatereferences/td-template.md- Full /td templatereferences/improve-workflow.md- /improve detailed workflowreferences/language-guide.md- Thai/English translation guide
04 同仓库更多 Skills
wait-what
Stop. That last message did not land: re-pitch it.
tdd
Test-driven development loop (red-green-refactor) with commit-based phase state and Jira traceability. Use when the user wants to build a feature or fix a bug test-first, mentions "tdd", "red-green-refactor", or "test-first". Replaces the tdg plugin — combines its commit/phase discipline with seam-based test quality rules from kb Testing Standards.
td
Creates post-task retrospectives with Before/After context and session documentation.
summary
Generates weekly or monthly session summaries from retrospectives and activity logs.
share
Shares knowledge across projects by copying to shared-knowledge directory with cross-project metadata.
session-analyzer
Analyzes git changes and creates retrospective drafts with Before/After context.