AgentSkillsCN

para-pkm

采用项目、领域、资源与档案的组织方式,管理基于 PARA 的个人知识管理系统。当用户需要:(1) 创建全新的 PARA 知识库;(2) 将现有知识库重新整理为 PARA 结构;(3) 决定内容应归入 PARA 的哪个层级(项目、领域、资源或档案);(4) 为知识库创建便于 AI 使用的导航文件;(5) 归档已完成的项目;(6) 验证 PARA 结构;或 (7) 学习针对特定用例的 PARA 组织模式(如开发者、顾问、研究人员等),此方法皆能派上用场。

SKILL.md
--- frontmatter
name: para-pkm
description: Manage PARA-based personal knowledge management (PKM) systems using Projects, Areas, Resources, and Archives organization method. Use when users need to (1) Create a new PARA knowledge base, (2) Organize or reorganize existing knowledge bases into PARA structure, (3) Decide where content belongs in PARA (Projects vs Areas vs Resources vs Archives), (4) Create AI-friendly navigation files for knowledge bases, (5) Archive completed projects, (6) Validate PARA structure, or (7) Learn PARA organizational patterns for specific use cases (developers, consultants, researchers, etc.)

PARA PKM

Organize by actionability, not topic. Projects/Areas/Resources/Archives for optimal AI navigation. Monthly review cadence.

Core Concepts

  • Projects = Time-bound goals with deadlines (completes → Archives); includes projects/stories/ for job applications
  • Areas = Ongoing responsibilities (use _overview.md per area for context)
  • Resources = Reference material; when unsure, put here temporarily
  • Archives = Inactive items from any category

Decision Tree

code
Has deadline/end state? → Projects
Ongoing responsibility? → Areas
Reference material? → Resources (default for uncertain items)
Completed/inactive? → Archives

Quick Start

  1. python scripts/init_para_kb.py <name> - Creates PARA + projects/stories/ + navigation
  2. Identify projects (deadlines) → areas (ongoing) → resources (reference)
  3. python scripts/generate_nav.py - Generate AI navigation

Scripts

ScriptPurposeUsage
init_para_kb.pyScaffold new KB<name> [--path <dir>]
validate_para.pyCheck structure, detect anti-patterns[path]
archive_project.pyArchive with metadata (date, origin)<project-file> [--kb-path]
generate_nav.pyCreate AI nav (<100 lines)[--kb-path] [--output]

Templates

TemplatePurpose
assets/AGENTS.md.templateAI navigation index
assets/project.md.templateProject file structure
assets/area-overview.md.templateArea _overview.md format
assets/README.md.templateKnowledge base README

Patterns by Role

  • Developers: projects/active/ features/bugs, areas/professional-development/, resources/coding-standards/
  • Consultants: projects/active/ deliverables + projects/stories/, areas/consulting/clients/, resources/templates/
  • Researchers: projects/active/ papers/grants, areas/research-program/, resources/literature-review/
  • Product Builders: projects/active/ launches, areas/product-development/{active,research,graduated,legacy}/

Complex Scenarios

Client = project + relationship: projects/active/client-x.md (deliverables) + areas/consulting/clients/client-x.md (relationship, billing)

Research lifecycle: areas/product-development/{research → graduated → active → legacy} with cross-references

Anti-Patterns

  • inbox/ folder (capture directly into PARA; use Resources when uncertain)
  • Deep nesting (max 2-3 levels; flat > nested)
  • Topic-based organization ("work/personal" → use actionability)
  • Todo folders (tasks belong with their projects/areas)
  • Perfectionism (move freely as understanding evolves; monthly review catches misplacements)

Content Lifecycle

code
Resources → Projects → Archives (research → active work → completed)
Areas → Archives (no longer responsible)
Projects ⟺ Areas (goal becomes ongoing or vice versa)

AI Navigation & Success Tips

  • Keep nav under 100 lines; point to paths not files; minimize tokens
  • Start simple ("What am I working on now?"); one home per item (use links)
  • Monthly review: archive completed, reassess areas; let patterns emerge

References