AI 协作文档初始化
将以下提示词粘贴到你的 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 交互规则与接口说明的存放位置