llm-wiki-for-code

分类: 文档与知识管理 | 上传者: szw321127 | 下载: 0 | 版本: v1.0（最新）

在当前项目的“.project-knowledge/”目录中构建和维护项目服务知识库。当 Codex 应该初始化项目知识库、检查当前项目知识状态、重建项目知识图或将当前任务中的稳定知识具体化为项目本地 Markdown 时使用。

更新日志: Source: GitHub https://github.com/szw321127/llm-wiki-for-code

目录结构

当前层级: tree/main/

📁 .agents/
- 📁 plugins/
  - 📄 marketplace.json 374 B
📁 .claude-plugin/
- 📄 marketplace.json 477 B
📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.md 609 B
  - 📄 docs_feedback.md 381 B
  - 📄 feature_request.md 485 B
- 📄 PULL_REQUEST_TEMPLATE.md 164 B
📁 assets/
- 📁 graph/
  - 📄 evidence-format.mjs 1.4 KB
  - 📄 graph-runtime.mjs 3.7 KB
  - 📄 knowledge-graph.css 19.9 KB
  - 📄 knowledge-graph.html 3.7 KB
  - 📄 knowledge-graph.js 39.0 KB
  - 📄 node-label-layout.mjs 3.2 KB
📁 docs/
- 📁 plans/
  - 📄 2026-04-22-exhibition-knowledge-graph-ui-design.md 4.4 KB
  - 📄 2026-04-22-exhibition-knowledge-graph-ui.md 6.8 KB
  - 📄 2026-04-22-interactive-practice-knowledge-graph-design.md 4.9 KB
  - 📄 2026-04-22-interactive-practice-knowledge-graph.md 7.8 KB
  - 📄 2026-04-23-open-graph-launcher-design.md 2.1 KB
  - 📄 2026-04-23-open-graph-launcher.md 1.8 KB
  - 📄 2026-04-23-project-graph-canvas-focus-filter-design.md 4.2 KB
  - 📄 2026-04-23-project-graph-canvas-focus-filter.md 6.9 KB
  - 📄 2026-04-23-project-graph-interaction-refresh-design.md 4.3 KB
  - 📄 2026-04-23-project-graph-interaction-refresh.md 5.0 KB
  - 📄 2026-04-23-project-knowledge-skill-design.md 8.6 KB
  - 📄 2026-04-23-project-knowledge-skill-plan.md 11.9 KB
  - 📄 2026-04-28-practice-recommendation-loop-design.md 4.5 KB
  - 📄 2026-04-28-practice-recommendation-loop.md 5.0 KB
  - 📄 2026-04-30-auto-governance-design.md 1.7 KB
  - 📄 2026-04-30-auto-governance-implementation.md 2.8 KB
📁 knowledge/
- 📁 constraints/
  - 📄 constraint-auditability.md 227 B
  - 📄 constraint-backward-compatibility.md 253 B
  - 📄 constraint-low-operational-complexity.md 265 B
  - 📄 constraint-no-extra-runtime.md 262 B
- 📁 contexts/
  - 📄 context-automation-script.md 265 B
  - 📄 context-backend-api.md 251 B
  - 📄 context-engineering-workflow.md 258 B
  - 📄 context-frontend-crud.md 236 B
- 📁 graph/
  - 📄 graph-data.json 73.3 KB
  - 📄 graph-index.json 20.7 KB
  - 📄 graph-runtime.mjs 3.7 KB
  - 📄 knowledge-graph.css 18.2 KB
  - 📄 knowledge-graph.html 3.7 KB
  - 📄 knowledge-graph.js 33.2 KB
- 📁 options/
  - 📄 option-centralized-config.md 807 B
  - 📄 option-centralized-error-handler.md 806 B
  - 📄 option-direct-call.md 724 B
  - 📄 option-exponential-backoff.md 863 B
  - 📄 option-inline-config.md 739 B
  - 📄 option-inline-error-handler.md 733 B
  - 📄 option-local-status-handling.md 734 B
  - 📄 option-no-retry.md 667 B
  - 📄 option-plain-logging.md 698 B
  - 📄 option-shared-status-layer.md 851 B
  - 📄 option-structured-logging.md 802 B
  - 📄 option-unified-client.md 826 B
- 📁 practices/
  - 📄 practice-config-management.md 1.1 KB
  - 📄 practice-error-handling.md 1.1 KB
  - 📄 practice-http-client.md 1.1 KB
  - 📄 practice-logging.md 1.0 KB
  - 📄 practice-retry-strategy.md 1.0 KB
  - 📄 practice-task-status-feedback.md 1.0 KB
- 📁 projects/
  - 📄 project-example-enterprise-web.md 1.1 KB
  - 📄 project-global.md 389 B
- 📁 rules/
  - 📄 rule-centralized-config-default.md 253 B
  - 📄 rule-shared-status-first.md 289 B
  - 📄 rule-structured-log-first.md 251 B
  - 📄 rule-use-unified-client.md 268 B
- 📁 templates/
  - 📄 option-template.md 421 B
  - 📄 practice-template.md 375 B
  - 📄 project-profile-template.md 285 B
- 📁 tests/
  - 📁 fixtures/
    
    📁 minimal-knowledge/
    
    📁 constraints/
    
    📄 constraint-sample.md 151 B
    
    📁 contexts/
    
    📄 context-sample.md 151 B
    
    📁 options/
    
    📄 option-sample-a.md 505 B
    
    📄 option-sample-b.md 487 B
    
    📁 practices/
    
    📄 practice-sample.md 443 B
    
    📁 projects/
    
    📄 project-sample.md 376 B
    
    📁 rules/
    
    📄 rule-sample.md 139 B
  - 📄 build-graph-data.test.mjs 3.8 KB
  - 📄 graph-runtime.test.mjs 6.6 KB
  - 📄 graph-shell.test.mjs 3.3 KB
  - 📄 serve-knowledge.test.mjs 399 B
- 📁 tools/
  - 📄 build-graph-data.mjs 839 B
  - 📄 graph-lib.mjs 14.7 KB
  - 📄 serve-knowledge.mjs 2.4 KB
- 📄 README.md 2.1 KB
- 📄 scoring.md 1.7 KB
- 📄 workflow.md 1.4 KB
📁 plugins/
- 📁 pk/
  - 📁 .claude-plugin/
    
    📄 plugin.json 281 B
  - 📁 .codex-plugin/
    
    📄 plugin.json 1.5 KB
  - 📁 assets/
    
    📁 graph/
    
    📄 evidence-format.mjs 1.4 KB
    
    📄 graph-runtime.mjs 3.7 KB
    
    📄 knowledge-graph.css 19.9 KB
    
    📄 knowledge-graph.html 3.7 KB
    
    📄 knowledge-graph.js 39.0 KB
    
    📄 node-label-layout.mjs 3.2 KB
  - 📁 scripts/
    
    📄 auto-crystallize-session.mjs 12.2 KB
    
    📄 build-project-graph-data.mjs 1.3 KB
    
    📄 build-project-graph-page.mjs 1.1 KB
    
    📄 crystallize-session.mjs 15.3 KB
    
    📄 evidence-paths.mjs 5.1 KB
    
    📄 govern-project-knowledge.mjs 9.7 KB
    
    📄 init-project-knowledge.mjs 17.3 KB
    
    📄 knowledge-lib.mjs 20.0 KB
    
    📄 lint-project-knowledge.mjs 8.9 KB
    
    📄 obsidian-lib.mjs 7.8 KB
    
    📄 pk-auto-crystallize.mjs 647 B
    
    📄 pk-crystallize.mjs 623 B
    
    📄 pk-govern.mjs 390 B
    
    📄 pk-graph.mjs 872 B
    
    📄 pk-init.mjs 504 B
    
    📄 pk-lint.mjs 384 B
    
    📄 pk-preflight.mjs 439 B
    
    📄 pk-serve.mjs 723 B
    
    📄 pk-status.mjs 375 B
    
    📄 preflight-session.mjs 11.1 KB
    
    📄 scan-project.mjs 6.9 KB
    
    📄 serve-project-knowledge.mjs 3.6 KB
    
    📄 shared.mjs 560 B
    
    📄 status-report.mjs 3.5 KB
  - 📁 skills/
    
    📁 pk-auto-crystallize/
    
    📄 SKILL.md 1.8 KB
    
    📁 pk-crystallize/
    
    📄 SKILL.md 1.1 KB
    
    📁 pk-govern/
    
    📄 SKILL.md 705 B
    
    📁 pk-graph/
    
    📄 SKILL.md 600 B
    
    📁 pk-init/
    
    📄 SKILL.md 825 B
    
    📁 pk-lint/
    
    📄 SKILL.md 846 B
    
    📁 pk-preflight/
    
    📄 SKILL.md 1.2 KB
    
    📁 pk-serve/
    
    📄 SKILL.md 523 B
    
    📁 pk-status/
    
    📄 SKILL.md 597 B
  - 📁 templates/
    
    📄 auto-crystallize-input-template.json 340 B
    
    📄 constraint-template.md 282 B
    
    📄 context-template.md 264 B
    
    📄 crystallize-input-template.json 356 B
    
    📄 option-template.md 507 B
    
    📄 practice-template.md 417 B
    
    📄 project-profile-template.md 493 B
    
    📄 rule-template.md 288 B
    
    📄 session-template.md 402 B
📁 scripts/
- 📄 auto-crystallize-session.mjs 12.2 KB
- 📄 build-project-graph-data.mjs 1.3 KB
- 📄 build-project-graph-page.mjs 1.1 KB
- 📄 crystallize-session.mjs 15.3 KB
- 📄 evidence-paths.mjs 5.1 KB
- 📄 govern-project-knowledge.mjs 9.7 KB
- 📄 init-project-knowledge.mjs 17.3 KB
- 📄 install-claude-local-plugin.mjs 8.2 KB
- 📄 install-codex-local-plugin.mjs 6.6 KB
- 📄 knowledge-lib.mjs 20.0 KB
- 📄 lint-project-knowledge.mjs 8.9 KB
- 📄 obsidian-lib.mjs 7.8 KB
- 📄 preflight-session.mjs 11.1 KB
- 📄 scan-project.mjs 6.9 KB
- 📄 serve-project-knowledge.mjs 3.6 KB
- 📄 status-report.mjs 3.5 KB
📁 seed/
- 📁 constraints/
  - 📄 constraint-auditability.md 227 B
  - 📄 constraint-backward-compatibility.md 253 B
  - 📄 constraint-low-operational-complexity.md 265 B
  - 📄 constraint-no-extra-runtime.md 262 B
- 📁 contexts/
  - 📄 context-automation-script.md 265 B
  - 📄 context-backend-api.md 251 B
  - 📄 context-engineering-workflow.md 258 B
  - 📄 context-frontend-crud.md 236 B
- 📁 options/
  - 📄 option-centralized-config.md 807 B
  - 📄 option-centralized-error-handler.md 806 B
  - 📄 option-direct-call.md 724 B
  - 📄 option-exponential-backoff.md 863 B
  - 📄 option-inline-config.md 739 B
  - 📄 option-inline-error-handler.md 733 B
  - 📄 option-local-status-handling.md 734 B
  - 📄 option-no-retry.md 667 B
  - 📄 option-plain-logging.md 698 B
  - 📄 option-shared-status-layer.md 851 B
  - 📄 option-structured-logging.md 802 B
  - 📄 option-unified-client.md 826 B
- 📁 practices/
  - 📄 practice-config-management.md 1.1 KB
  - 📄 practice-error-handling.md 1.1 KB
  - 📄 practice-http-client.md 1.1 KB
  - 📄 practice-logging.md 1.0 KB
  - 📄 practice-retry-strategy.md 1.0 KB
  - 📄 practice-task-status-feedback.md 1.0 KB
- 📁 projects/
  - 📄 project-example-enterprise-web.md 1.1 KB
  - 📄 project-global.md 389 B
- 📁 rules/
  - 📄 rule-centralized-config-default.md 253 B
  - 📄 rule-shared-status-first.md 289 B
  - 📄 rule-structured-log-first.md 251 B
  - 📄 rule-use-unified-client.md 268 B
📁 templates/
- 📄 auto-crystallize-input-template.json 340 B
- 📄 constraint-template.md 282 B
- 📄 context-template.md 264 B
- 📄 crystallize-input-template.json 356 B
- 📄 option-template.md 507 B
- 📄 practice-template.md 417 B
- 📄 project-profile-template.md 493 B
- 📄 rule-template.md 288 B
- 📄 session-template.md 402 B
📁 tests/
- 📁 fixtures/
  - 📁 init-sample-project/
    
    📁 docs/
    
    📄 engineering.md 191 B
    
    📁 src/
    
    📁 api/
    
    📄 client.ts 335 B
    
    📁 config/
    
    📄 env.ts 62 B
    
    📁 pages/
    
    📄 demo.ts 98 B
    
    📄 logger.ts 108 B
    
    📄 package.json 319 B
    
    📄 README.md 173 B
- 📄 auto-crystallize.test.mjs 14.5 KB
- 📄 claude-local-plugin-install.test.mjs 12.4 KB
- 📄 codex-local-plugin-install.test.mjs 3.7 KB
- 📄 crystallize.test.mjs 6.3 KB
- 📄 governance-api.test.mjs 2.7 KB
- 📄 governance.test.mjs 7.0 KB
- 📄 graph-build.test.mjs 1.3 KB
- 📄 init.test.mjs 7.7 KB
- 📄 knowledge-lib.test.mjs 7.6 KB
- 📄 lint.test.mjs 10.8 KB
- 📄 plugin-command-shell.test.mjs 6.1 KB
- 📄 preflight.test.mjs 9.6 KB
- 📄 project-graph-shell.test.mjs 15.9 KB
- 📄 skill-shell.test.mjs 1.8 KB
- 📄 status.test.mjs 782 B
📄 .gitignore 165 B
📄 CONTRIBUTING.md 1.7 KB
📄 findings.md 1.9 KB
📄 LICENSE 1.0 KB
📄 package.json 1.6 KB
📄 progress.md 6.3 KB
📄 README.md 14.3 KB
📄 README_EN.md 15.2 KB
📄 SKILL.md 3.5 KB
📄 task_plan.md 5.7 KB

SKILL.md

---
name: llm-wiki-for-code
description: Build and maintain a project-serving knowledge base inside the current project's `.project-knowledge/` directory. Use when Codex should initialize a project knowledge base, inspect current project knowledge status, rebuild the project knowledge graph, or crystallize stable knowledge from the current task into project-local Markdown.
---

# LLM Wiki for Code Skill

Treat `.project-knowledge/` as the only fact source for a project's persisted knowledge.

## Core Rules

- Write project knowledge only under `.project-knowledge/`
- Read only local code and local docs for `pk-init`
- Do not read `git log` or browse the web for project analysis
- Do not modify business code as part of knowledge maintenance
- Keep Obsidian-facing files (`index.md`, `log.md`, `_views/`, `.obsidian/`) derived from Markdown knowledge
- Before finishing a task, do one lightweight crystallization judgment
- Prefer `pk-auto-crystallize` after task completion when touched files and a task summary are available
- If `.project-knowledge/project-profile.md` is missing, skip project knowledge workflows and suggest `pk-init` only when the user wants this project to opt in
- Use `pk-crystallize` with a JSON input file when recording hand-curated adopted nodes or stable updates

## Skill Entry Points

- `pk-init`: analyze the current project and bootstrap `.project-knowledge/`
- `pk-preflight`: inspect project knowledge before a task and return matching practices or local evidence hints
- `pk-status`: summarize current project knowledge state
- `pk-graph`: rebuild graph data and graph page from `.project-knowledge/`
- `pk-crystallize`: persist a session and, when justified, update stable or incubating knowledge
- `pk-auto-crystallize`: infer adopted recommendations or new incubating candidates from task text and touched files
- `pk-lint`: report recommendation-pool lifecycle governance, evidence health, and possible duplicate knowledge without modifying files
- `pk-govern`: automatically apply reversible governance actions such as promotion, demotion, and strong duplicate rejection
- `pk-serve`: serve the project knowledge graph locally

## Knowledge Rules

- Markdown is the only fact source
- New stable insights should default into low-score incubating space unless they are already clearly project defaults
- `session` records are always allowed; knowledge nodes require stable evidence
- `.project-knowledge/` is an Obsidian-compatible vault; generated node bodies should keep `Links` sections useful for backlink navigation
- `pk-preflight` output is context-budgeted: load full node Markdown or source files only after a summarized match needs deeper verification
- `pk-lint` governance findings are review prompts only: promotion candidates, eviction candidates, and possible duplicates still require human judgment before moving or deleting files
- `pk-govern` may move Markdown nodes between stable and incubating directories, but it must not physically delete knowledge files

## Crystallization Input

`pk-auto-crystallize` accepts a JSON input file after the project path. Use it at task end when the task adopted existing recommendations or produced a new code practice that should start in incubation.

```json
{
  "sessionId": "session-YYYY-MM-DD-topic",
  "title": "本轮任务标题",
  "topic": "本轮任务主题",
  "taskText": "用于匹配已有实践的任务描述",
  "decisionSummary": "一句话总结本轮关键决策。",
  "touchedFiles": [],
  "adoptedNodeIds": [],
  "incubatingNodes": [],
  "stableUpdates": []
}
```

登录后下载/点赞/收藏 ❤ 17 | ★ 0

llm-wiki-for-code

目录结构

SKILL.md

举报内容

提示