AGENT SKILL
codex-project-memory
Use for project memory, decisions, handoffs, genome, knowledge index, changelog, and patterns that must persist across sessions.
- License 许可
- MIT
- 最近更新
- 2026-07-15
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- codex-project-memory
- description
- Use for project memory, decisions, handoffs, genome, knowledge index, changelog, and patterns that must persist across sessions.
- load_priority
- on-demand
02 资源文件 43
- 参考文档agents/openai.yaml201 B
- 参考文档references/artifact-lifecycle-policy.md2.5 KB
- 参考文档references/behavior-guide.md4.5 KB
- 参考文档references/changelog-spec.md1.0 KB
- 参考文档references/ci-readiness.md4.4 KB
- 参考文档references/codebase-index.schema.json2.3 KB
- 参考文档references/context-compactor-spec.md1.4 KB
- 参考文档references/decision-journal-spec.md1.0 KB
- 参考文档references/feedback-tracker-spec.md3.5 KB
- 参考文档references/growth-report-spec.md1.1 KB
- 参考文档references/handoff-spec.md5.4 KB
- 参考文档references/knowledge-graph-spec.md6.2 KB
- 参考文档references/knowledge-graph.schema.json4.0 KB
- 参考文档references/knowledge-index.schema.json2.4 KB
- 参考文档references/output-schemas.md10.4 KB
- 参考文档references/pattern-learner-spec.md4.3 KB
- 参考文档references/project-memory-tools.json8.0 KB
- 参考文档references/project-memory-tools.schema.json2.1 KB
- 参考文档references/scale-sla.md3.7 KB
- 参考文档references/script-commands.md5.9 KB
- 参考文档references/session-summary-spec.md3.5 KB
- 参考文档references/skill-evolution-spec.md4.3 KB
- 脚本scripts/analyze_patterns.py28.2 KB
- 脚本scripts/build_knowledge_graph.py75.1 KB
- 脚本scripts/build_knowledge_index.py38.2 KB
- 脚本scripts/codebase_indexer.py41.2 KB
- 脚本scripts/compact_context.py13.9 KB
- 脚本scripts/dashboard_template.html107.5 KB
- 脚本scripts/decision_logger.py5.1 KB
- 脚本scripts/generate_changelog.py8.0 KB
- 脚本scripts/generate_genome.py3.2 KB
- 脚本scripts/generate_growth_report.py14.6 KB
- 脚本scripts/generate_handoff.py19.6 KB
- 脚本scripts/generate_scale_fixture.py8.4 KB
- 脚本scripts/generate_session_summary.py13.3 KB
- 脚本scripts/genome_builder.py44.7 KB
- 脚本scripts/memory_status.py11.2 KB
- 脚本scripts/project_traversal.py13.4 KB
- 脚本scripts/redaction.py3.6 KB
- 脚本scripts/run_scale_gate.py12.6 KB
- 脚本scripts/track_feedback.py11.4 KB
- 脚本scripts/track_skill_usage.py12.7 KB
- 脚本scripts/write_scale_gate_summary.py1.6 KB
03 SKILL.md 正文
TL;DR
12 scripts for project knowledge persistence. Decision tree: Log -> decision/feedback/skill-usage. Generate -> changelog/session-summary/handoff/growth-report. Analyze -> patterns/knowledge-graph/knowledge-index/project-genome. Maintain -> compact old context. Triggers: $changelog, $growth-report, $session-summary, $log-decision, $compact-context, $knowledge, $codex-genome.
Codex Project Memory
Activation
- Activate after complex tasks involving architecture, design decisions, or refactors.
- Activate on explicit
$codex-project-memoryor$memory. - Activate on explicit command
$log-decision. - Activate on
$handoffor when user asks to generate handoff context. - Activate on
$session-summaryor when user asks to summarize a coding session. - Activate on
$analyze-patternsor "learn project style". - Activate on
$log-feedbackor "track my fix". - Activate on
$feedback-summaryfor aggregated feedback recall. - Activate on
$skill-trackto record skill usage analytics. - Activate on
$skill-reportto generate skill evolution report. - Activate on
$build-graphor "map project" to generate project knowledge graph. - Activate on
$changelogto generate release-oriented commit summaries. - Activate on
$growth-reportto generate a developer growth report. - Activate on
$compact-contextor "clean up old sessions". - Activate on
$codex-genome,$generate-genome, or$genometo create layered project context docs. - Activate on
$knowledge, "make tacit knowledge visible", or "build knowledge index" to generate.codex/knowledge/INDEX.md,.codex/knowledge/index.json,.codex/knowledge/knowledge-graph.json, and an offline interactive.codex/knowledge/index.html. - Activate on "memory status", "validate project memory", or before CLI/tool-harness handoff to run
scripts/memory_status.pyagainst generated artifacts.
Decision Tree Routing
User intent -> Memory action?
|- Log/record -> What?
| |- Decision -> decision_logger.py
| |- Feedback -> track_feedback.py
| `- Skill usage -> track_skill_usage.py
|
|- Generate/export -> What?
| |- Handoff -> generate_handoff.py
| |- Session recap -> generate_session_summary.py
| |- Changelog -> generate_changelog.py
| `- Growth report -> generate_growth_report.py
|
|- Analyze -> What?
| |- Patterns -> analyze_patterns.py
| |- Dependencies -> build_knowledge_graph.py
| |- Tacit knowledge index -> build_knowledge_index.py
| `- Context genome -> generate_genome.py
|
|- Maintain -> What?
| `- Compact old memory -> compact_context.py
|
`- Not memory -> skip
Rules
- Use the decision tree to choose one memory action before invoking scripts.
- Run
--helpbefore invoking helper scripts and treat them as black-box tools unless customization or bug fixing is required. - Review existing files in
.codex/decisions/before logging a similar technical choice. - Use the default output paths and chaining guidance from
references/behavior-guide.mdunless the user requests overrides. - Return the created path plus the headline metrics from each script JSON payload.
- See
skills/.system/REGISTRY.mdfor full script paths.
Reference Files
references/decision-journal-spec.md: decision logging criteria and naming conventions.references/handoff-spec.md: handoff usage guidance.references/session-summary-spec.md: session summary workflow and retention guidance.references/changelog-spec.md: release-focused changelog generation rules.references/growth-report-spec.md: developer growth analytics and reporting behavior.references/pattern-learner-spec.md: project style learning behavior.references/feedback-tracker-spec.md: feedback logging and aggregate usage.references/skill-evolution-spec.md: skill usage analytics and optimization.references/knowledge-graph-spec.md: deep architecture mapping and refresh guidance.build_knowledge_index.py: schema-versioned project knowledge index from genome, role docs, decisions, commits, config, and the structural knowledge graph; redacts secret-like values, stores provenance/confidence, and writes an offline interactive HTML dashboard for AI and human review.references/knowledge-index.schema.json: output contract for.codex/knowledge/index.json.references/knowledge-graph.schema.json: output contract for.codex/knowledge/knowledge-graph.jsonand.codex/knowledge-graph.json.references/context-compactor-spec.md: retention policy, archive layout, and dry-run expectations.references/behavior-guide.md: detailed per-script behaviors, defaults, and chaining guidance.references/script-commands.mdreferences/output-schemas.mdreferences/project-memory-tools.json: machine-readable tool manifest for CLI/MCP-style harness generation.references/project-memory-tools.schema.json: schema for the tool manifest.references/ci-readiness.md: release gate commands, strict mode, and Windows symlink deselection.references/scale-sla.md: scale tiers,run_scale_gate.pyreport, and CI workflow mapping for large codebases.references/artifact-lifecycle-policy.md: hybrid commit policy for schemas vs generated.codex/artifacts.
04 同仓库更多 Skills
codex-test-driven-development
Fixture stub for TDD skill.
★ 2
codex-subagent-execution
Fixture stub for subagent execution skill.
★ 2
codex-runtime-hook
Fixture stub for runtime hook skill.
★ 2
codex-plan-writer
Fixture stub for plan writer skill.
★ 2
codex-execution-quality-gate
Fixture stub for quality gate skill.
★ 2
codex-demo
Minimal fixture skill for Agency CLI skill-md parser tests.
★ 2