feat(knowledge): 支持模块级技术画像与双读

This commit is contained in:
zhiye.sun
2026-09-03 17:13:14 +08:00
parent 018bc2e914
commit 5e465faa7b
7 changed files with 26 additions and 11 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "knowledge",
"version": "0.5.0",
"version": "0.6.0",
"description": "项目初始化、任务交接、复盘与知识沉淀工作流。",
"author": {
"name": "CraftKit"
+4 -4
View File
@@ -5,7 +5,7 @@ description: 初始化或更新项目的 AGENTS.md 与 .craftkit 项目资料;
# 项目初始化
建立可持续维护的项目上下文,使后续 Agent 能识别项目用途、技术栈、代码边界、内部依赖标识和适用规范。只初始化 Agent 与知识资料,不默认生成业务代码。
建立可持续维护的项目上下文,使后续 Agent 能识别项目用途、模块级技术栈、代码边界、内部依赖标识和适用规范。只初始化 Agent 与知识资料,不默认生成业务代码。
## 选择模式
@@ -21,15 +21,15 @@ description: 初始化或更新项目的 AGENTS.md 与 .craftkit 项目资料;
1. 确认项目根目录、初始化模式和参考材料范围。
2. 扫描当前项目;只在用户授权的路径中扫描参考项目。
3. 展示自动识别的信息、证据、冲突和待确认项。
3. 展示自动识别的信息、证据、冲突和待确认项;读取已有画像时兼容 Schema 1 和 Schema 2。
4. 通过简短提问补齐无法可靠推断的项目用途、包名、框架、精确版本、公共 profile、内部依赖和约束;前端项目还需确认组件库、组件根、文档入口及参考项目范围。禁止默认最新版本。
5. 展示拟创建或修改的文件及关键内容,取得确认后再写入。
5. 展示拟创建或修改的文件及关键内容,取得确认后再写入;Schema 1 升级必须展示完整字段差异。
6. 从 [assets](assets/project.json) 中选择模板,生成或合并 `AGENTS.md`、`.craftkit/project.json`、目录说明、嵌套忽略规则、必要索引和 `.craftkit/standards/document-maintenance.md`;存在前端能力时同时准备 `.craftkit/standards/frontend/components.md` 的最小索引。
7. 已有文件必须先完整读取并做保守合并;不明确的用户章节和字段原样保留,不直接覆盖。
8. 初始化后验证 JSON、索引链接、文档维护规范,以及 `.craftkit/local/`、`.craftkit/cache/` 的 Git 忽略状态;按[文档目录配置](references/project-config.md#文档目录)验证过程、共享设计、归档路径和生命周期策略,不创建示例任务或业务文档。
9. 使用 `guidance` 对一个真实项目问题执行检索验证;未安装该 Skill 时改用相同的入口顺序手工验证。
框架版本写入 `technology.frameworks`。成熟项目优先从构建清单和锁文件探测;空项目根据用户选择或参考项目建议填写。只有公共 profile 已真实存在且版本范围匹配时才写入 `profile`,否则保留为空并记录待确认事项。
Schema 1 的框架版本继续从 `technology.frameworks` 读取。Schema 2 保留顶层兼容概要,并把精确语言、框架、版本和证据写入 `modules[].technology`。`preferredProfiles` 只记录用户确认的项目偏好,不表示当前机器已经安装插件;运行时发现结果不得写入共享画像。
前端组件信息写入 `frontend`。成熟项目从依赖清单、锁文件、组件目录、类型和现有调用提取;空项目根据用户已确认的技术选型或授权参考提议填写。未知组件库或版本保持为空,不根据框架名称自行猜测。
@@ -1,9 +1,10 @@
{
"schemaVersion": 1,
"schemaVersion": 2,
"initialization": { "mode": "new", "references": [] },
"project": { "name": "", "description": "", "type": "other" },
"technology": { "languages": [], "frameworks": [], "buildTools": [], "databases": [] },
"code": { "sourceRoots": [], "packageRoots": [], "modules": [] },
"modules": [],
"dependencies": { "internal": [], "public": [] },
"frontend": {
"framework": "",
@@ -15,6 +15,16 @@
- `guidance` 指向 `.craftkit/` 内的索引入口。
- `initialization.references` 记录参考项目名称、用途、允许提炼范围和可共享的相对位置。
## Schema 兼容
- Schema 1 没有顶层 `modules` 时,将顶层技术栈和 `code` 边界作为根模块候选,不自动改写文件。
- Schema 2 保留顶层 `technology` 原有字段类型,增加 `modules[].technology` 表达模块级精确信息。
- `modules[].technology.preferredProfiles` 是项目确认的偏好,不表示当前机器已安装对应插件。
- 插件发现、匹配状态和本机路径属于运行时信息,只存在于任务上下文或 `.craftkit/local/`。
- 所有读取方完成 Schema 1/2 双读后,`init` 才能在用户确认差异后写入 Schema 2。
模块根使用项目相对正斜线路径。目标路径命中多个模块时采用最长根;同长度重复根视为配置冲突。
## 文档目录
| 字段 | 默认值 | 用途 |