CraftKit/plugins/knowledge/skills/init/SKILL.md

name, description

name	description
init	初始化或更新项目的 AGENTS.md 与 .craftkit 项目资料；支持成熟项目延续既有风格，以及空项目根据需求和参考项目建立上下文。普通规范查询、代码脚手架生成或无确认覆盖已有配置不应触发本 Skill。

项目初始化

建立可持续维护的项目上下文，使后续 Agent 能识别项目用途、技术栈、代码边界、内部依赖标识和适用规范。只初始化 Agent 与知识资料，不默认生成业务代码。

选择模式

先只读探测源码、构建文件、依赖清单、AGENTS.md 和 .craftkit/：

• 存在有效源码或构建文件时建议“成熟项目”。
• 仓库为空或只有少量说明文件时建议“空项目”。
• 向用户说明判断结果，并询问是否有参考项目或参考材料；用户可以覆盖模式。

执行成熟项目模式时读取成熟项目流程；执行空项目模式时读取空项目流程。两种模式都遵循项目配置规则。

共同流程

1. 确认项目根目录、初始化模式和参考材料范围。
2. 扫描当前项目；只在用户授权的路径中扫描参考项目。
3. 展示自动识别的信息、证据、冲突和待确认项。
4. 通过简短提问补齐无法可靠推断的项目用途、包名、框架、精确版本、公共 profile、内部依赖和约束；前端项目还需确认组件库、组件根、文档入口及参考项目范围。禁止默认最新版本。
5. 展示拟创建或修改的文件及关键内容，取得确认后再写入。
6. 从 assets 中选择模板，生成或合并 AGENTS.md、.craftkit/project.json、目录说明、嵌套忽略规则和必要索引；存在前端能力时同时准备 .craftkit/standards/frontend/components.md 的最小索引。
7. 已有文件必须先完整读取并做保守合并；不明确的用户章节和字段原样保留，不直接覆盖。
8. 初始化后验证 JSON、索引链接，以及 .craftkit/local/、.craftkit/cache/ 的 Git 忽略状态。
9. 使用 guidance 对一个真实项目问题执行检索验证；未安装该 Skill 时改用相同的入口顺序手工验证。

框架版本写入 technology.frameworks。成熟项目优先从构建清单和锁文件探测；空项目根据用户选择或参考项目建议填写。只有公共 profile 已真实存在且版本范围匹配时才写入 profile，否则保留为空并记录待确认事项。

前端组件信息写入 frontend。成熟项目从依赖清单、锁文件、组件目录、类型和现有调用提取；空项目根据用户已确认的技术选型或授权参考提议填写。未知组件库或版本保持为空，不根据框架名称自行猜测。

安全边界

• 不读取或保存密码、令牌、私钥、完整数据库连接串和私有仓库认证信息。
• 扫描配置文件时只提取框架、数据库类型、依赖标识等非秘密元数据；疑似凭据只报告位置和风险。
• 参考项目只用于用户指定的结构、依赖、命名、测试、规范或工具范围，不复制业务代码和专属规则正文。
• 共享文件不保存个人机器绝对路径。无法转成工作区相对路径的参考位置只写入 .craftkit/local/，或仅记录参考项目名称和用途。
• 内部包名、框架名和依赖标识属于当前项目资料，是否提交由项目自身规则和用户决定；CraftKit 插件不预置这些内容。
• 不安装 Git Hook、不修改全局工具配置、不联网查询内部信息，也不自动提交初始化产物。