This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
本仓库的全部开发指南、常用命令、架构说明与开发规范统一维护在 AGENTS.md 中,请先完整阅读并严格遵循该文件。
其中与本仓库协作的关键约定(详见 AGENTS.md):
- 回复语言:所有沟通及文档必须使用中文。
- 双版本线:仓库同时维护 17.x(JDK 17 /
jakarta.*)与 8.x(JDK 8 /javax.*)两条版本线,处理 issue 必须遵循docs/conventions/workflow/github-issue.md的 worktree + 特性分支流程。 - 编码前必读:
docs/conventions/index.md(规范,最高优先级)与docs/capabilities/index.md(已有能力,必须复用)。
进入计划模式或实现功能前,必须按以下优先级查阅:
- docs/conventions/index.md — 项目开发规范
规范具有最高优先级。 所有代码必须遵循已注册的 Convention,违反规范的代码视为缺陷。 编码前必须逐条检查相关规范,确保命名、结构、模式完全符合要求。
- docs/capabilities/index.md — 已有可复用能力
已有能力必须复用,禁止重新实现。优先组合已有能力解决问题。
计划方案中必须包含:
- 遵循了哪些规范 — 列出遵守的 Convention(必须首先说明)
- 复用了哪些已有能力 — 列出从 PKR 中找到并复用的 Capability
- 是否有新增能力 — 如果本次开发产生了可复用的新能力,完成后通过
/pkr-add注册
| 命令 | 用途 |
|---|---|
/pkr-init |
扫描项目,发现候选能力和规范(自动跳过已有文档) |
/pkr-sync |
全量同步,对比代码变更 |
/pkr-update <module>/<name> [desc] |
单项更新,可带描述指导更新 |
/pkr-add <module>/<name> <desc> |
从代码/框架扫描注册 |
/pkr-add plan <module>/<name> <desc> |
注册计划中的能力 |
/pkr-export <module> ... |
导出模块文档供其他项目使用 |