From 5e465faa7b16e5c17879bca1e38ec4d16675e4a6 Mon Sep 17 00:00:00 2001 From: "zhiye.sun" Date: Thu, 3 Sep 2026 17:13:14 +0800 Subject: [PATCH] =?UTF-8?q?feat(knowledge):=20=E6=94=AF=E6=8C=81=E6=A8=A1?= =?UTF-8?q?=E5=9D=97=E7=BA=A7=E6=8A=80=E6=9C=AF=E7=94=BB=E5=83=8F=E4=B8=8E?= =?UTF-8?q?=E5=8F=8C=E8=AF=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .craftkit/project.json | 5 ++++- plugins/knowledge/.codex-plugin/plugin.json | 2 +- plugins/knowledge/skills/init/SKILL.md | 8 ++++---- plugins/knowledge/skills/init/assets/project.json | 3 ++- .../knowledge/skills/init/references/project-config.md | 10 ++++++++++ plugins/skill/.codex-plugin/plugin.json | 2 +- plugins/skill/skills/guidance/SKILL.md | 7 ++++--- 7 files changed, 26 insertions(+), 11 deletions(-) diff --git a/.craftkit/project.json b/.craftkit/project.json index 3b2392d..167e7e8 100644 --- a/.craftkit/project.json +++ b/.craftkit/project.json @@ -30,7 +30,10 @@ "plugins/doc", "plugins/git", "plugins/knowledge", - "plugins/skill" + "plugins/skill", + "plugins/profile", + "plugins/java", + "plugins/python" ] }, "dependencies": { diff --git a/plugins/knowledge/.codex-plugin/plugin.json b/plugins/knowledge/.codex-plugin/plugin.json index 66e040c..478200a 100644 --- a/plugins/knowledge/.codex-plugin/plugin.json +++ b/plugins/knowledge/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "knowledge", - "version": "0.5.0", + "version": "0.6.0", "description": "项目初始化、任务交接、复盘与知识沉淀工作流。", "author": { "name": "CraftKit" diff --git a/plugins/knowledge/skills/init/SKILL.md b/plugins/knowledge/skills/init/SKILL.md index 102ab6c..8058d9d 100644 --- a/plugins/knowledge/skills/init/SKILL.md +++ b/plugins/knowledge/skills/init/SKILL.md @@ -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`。成熟项目从依赖清单、锁文件、组件目录、类型和现有调用提取；空项目根据用户已确认的技术选型或授权参考提议填写。未知组件库或版本保持为空，不根据框架名称自行猜测。 diff --git a/plugins/knowledge/skills/init/assets/project.json b/plugins/knowledge/skills/init/assets/project.json index 1694af2..120eef9 100644 --- a/plugins/knowledge/skills/init/assets/project.json +++ b/plugins/knowledge/skills/init/assets/project.json @@ -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": "", diff --git a/plugins/knowledge/skills/init/references/project-config.md b/plugins/knowledge/skills/init/references/project-config.md index 47b4dec..698e27d 100644 --- a/plugins/knowledge/skills/init/references/project-config.md +++ b/plugins/knowledge/skills/init/references/project-config.md @@ -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。 + +模块根使用项目相对正斜线路径。目标路径命中多个模块时采用最长根；同长度重复根视为配置冲突。 + ## 文档目录 | 字段 | 默认值 | 用途 | diff --git a/plugins/skill/.codex-plugin/plugin.json b/plugins/skill/.codex-plugin/plugin.json index 2bd9c8e..36e9036 100644 --- a/plugins/skill/.codex-plugin/plugin.json +++ b/plugins/skill/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "skill", - "version": "0.2.2", + "version": "0.3.0", "description": "项目规范检索与维护工具。", "author": { "name": "CraftKit" diff --git a/plugins/skill/skills/guidance/SKILL.md b/plugins/skill/skills/guidance/SKILL.md index 3700cd2..28c0b47 100644 --- a/plugins/skill/skills/guidance/SKILL.md +++ b/plugins/skill/skills/guidance/SKILL.md @@ -12,10 +12,11 @@ description: 检索当前项目的 AGENTS.md、.craftkit 项目资料和 CraftKi 1. 确定任务涉及的目录、文件类型和主题。 2. 读取从项目根到目标目录沿途适用的 `AGENTS.md`，距离目标更近的文件约束更具体。 3. 若存在 `.craftkit/project.json`，读取其中的项目类型、技术栈、代码边界和规范入口。 -4. 涉及框架时按[版本 Profile 路由](references/profile-routing.md)确定当前项目版本；普通开发只加载当前 profile，升级或版本比较才加载源、目标两个 profile。 +4. 涉及技术栈时先按目标路径确定模块，再按[版本 Profile 路由](references/profile-routing.md)确定当前版本；Schema 1 或没有模块时使用顶层技术栈作为根模块候选。 5. 按需读取 `.craftkit/agents/index.md`、`.craftkit/standards/index.md`、`.craftkit/knowledge/index.md`；涉及需求、设计、规范或知识时同时读取命中的文档维护规则，只继续读取索引命中的域、路由和正文。 -6. 项目资料未覆盖主题时，读取[公共基线索引](references/guidance/index.md)，只加载当前任务需要的规则。 -7. 索引缺失或没有命中时，才在相应目录做受控关键词搜索；不得先递归加载整个知识库。 +6. 当前会话发现对应语言提供方时，由提供方读取自身 Profile 资料；未发现时报告 `missing`，不扫描插件缓存。 +7. 项目资料和已发现的技术提供方均未覆盖主题时，读取[公共基线索引](references/guidance/index.md)，只加载当前任务需要的规则。 +8. 索引缺失或没有命中时，才在相应目录做受控关键词搜索；不得先递归加载整个知识库。 目录布局和优先级的详细说明见[检索布局](references/layout.md)。