AI开发工具中引入sdd-riper会生成很多文件

[Apple-Sugar-Xing]

在AI开发工具（qoder）中引入sdd-riper技能会生成很多文件，如截图所示

这类文件的作用是什么？我看大多数都是说明文件。会导致git中产生很多待提交的。还是说我的使用方式不正确吗？

[wq02322370-del]

正常的，你导入skill进去，肯定会将skill的文件也一起导入进去，这些文件都是属于sdd-riper的文件

[Apple-Sugar-Xing]

正常的，你导入skill入口，一定要把skill的文件也一起导入入口，这些文件都是属于sdd-riper的文件

代码提交时，那这些文件是否需要提交呢？是不是只需要提交生成的相关文件（spec,codemap等）就行了

[huisezhiyin]

感谢反馈，前面的回复不够完整。你目前的使用方式不一定有问题，但这里需要区分三类文件。

1. Skill 安装载荷

例如 SKILL.md、README.md、references/、examples/、scripts/。这些不是每次任务生成的业务文档，而是 Skill 本身的定义、按需加载规则、模板和辅助脚本。Qoder 如果把 Skill 安装到当前项目目录，就会把这些文件一起复制进来，所以 Git 会看到很多新增文件。

• 只供个人使用：建议安装到 Qoder 的用户级／全局 Skill 目录，不要放进业务仓库。
• 团队希望固定版本并共享同一套工作流：可以把选定的 Skill 目录作为项目配置提交。此时建议保留完整 Skill 载荷，不要只复制 SKILL.md，因为它可能会按需读取 references/ 或调用 scripts/。

2. 任务过程中生成的 mydocs/ 产物

• spec、handoff、Project Memory 默认是本地任务上下文，不默认提交。
• codemap 如果已经脱敏，而且团队后续会复用，可以按项目约定提交。
• context bundle 可能包含原始需求或内部信息，通常应谨慎处理。
• 是否提交不能简单理解为“生成的都提交”，而应由项目的 AGENTS.md、隐私要求和团队协作方式决定。

3. 本地运行数据

例如 .agent-memory/、.expcap/、SQLite/Milvus 数据、trace、日志、.env 和凭据。这些不应提交。

当前 sdd-riper 仓库本身已经在 .gitignore 中忽略了 mydocs/。也不建议让 Agent 擅自修改 .gitignore、使用 git add -f，或者把包含内部信息的产物强行加入版本库。更完整的边界可以参考 README 的 Spec 与记忆边界。

简单总结：

• 个人安装：Skill 放到用户级目录。
• 团队固定工作流：可提交完整 Skill 目录。
• spec / handoff / memory：默认不提交。
• codemap：脱敏且确有团队复用价值时再提交。
• 运行数据和凭据：永远不提交。