Agent Skills
返回列表
AI 协作文档初始化

AI 协作文档初始化

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2689f551/project-docs-init。

技能介绍

解决什么问题

在多 Agent 协作或复杂业务迭代的项目里,文档往往散落在不同角落。新加入的开发者或 AI 助手很难快速建立对项目上下文的认知。这套骨架提供了一个标准化的沉淀位置,专门解决 docs/ai/ 目录缺失、根入口文件(如 CLAUDE.md 和 AGENTS.md)不存在的痛点。

核心工作流

该技能通过五个标准步骤完成初始化:

  • 目标确认:识别当前项目根目录,若非典型项目结构则请求确认。
  • 安全检查:严格检测 docs/ai/、.gitignore 等关键路径。发现冲突时绝不覆盖,必须等待用户选择跳过或覆盖。
  • 模板复制:完整保留子目录结构,将 9 个编号文件与 7 个子目录迁移至目标根目录。
  • 占位符替换:自动将 {{PROJECT_NAME}} 替换为目录名,并将 {{DATE}} 更新为当天日期。
  • 可选问答:最多询问 3 个项目定位、技术栈与阶段的问题,将答案直接写入 00_PROJECT_CONTEXT.md。

适用边界与注意

  • 初始化完成后,不会自动执行 git commit,需要手动提交。
  • 如果目标目录不是 git 仓库,技能会给出提示建议执行 git init,但不会越权代劳。
  • 文档骨架仅是起点,具体的接口目录和系统基线需要开发者在后续分步补全。

使用场景

  • 团队接手代码仓库,需建立标准的 AI 协作文档目录与根入口文件
  • 新项目启动,配置 CLAUDE.md 和 AGENTS.md 作为 Agent 交互依据
  • 重构现有项目结构,在根目录规范 docs/ai 文件夹及相关子目录
  • 手动撰写大量项目文档,利用技能快速生成带占位符的初始骨架

适合人员

  • 项目负责人,需要在新代码库中快速建立标准化的 AI 上下文文档体系
  • 软件开发工程师,希望通过模板快速生成项目背景和进度记录文件
  • 自动化工具维护者,为后续接入多种 Agent 提供统一的文档目录规范
  • 团队技术负责人,希望统一项目中关于 AI 交互规则与接口说明的存放位置