把一套可验证、可迁移的 AI 编码方法，交给当前项目中的 Agent。
项目级优先 · 跨 IDE 中立资产 · 六个按需 Skills · 从功能实现到最低交付
快速开始 · 框架共存 · 六个-skills · 安装验收 · 参考资料
Warning
兼容性说明：EasyUseAIDE 当前不支持 Qoder / Qoder CN。
实际验证表明，Qoder 虽然能够发现规则和 Skills，但在开发任务中无法稳定保证确定性路由、Skill 正文加载及交付门禁持续执行。EasyUseAIDE 当前不提供也不维护 Qoder 专用适配；请勿在 Qoder 中按本项目说明安装，也不要把 .qoder/skills/ 中存在文件视为框架已经生效。
Qoder 用户可以改用其原生工程化流程，参见：Qoder 原生工程化逻辑。
不同 AI IDE 对规则文件、Skills 目录和加载方式有各自的约定。直接复制某个工具的配置，换一个 IDE 可能无法识别；全部装到用户级，又可能把不适合当前项目的规则带进其他项目。
EasyUseAIDE 把可复用的方法整理成一套中立资产源，再让 Agent 根据当前 IDE 的真实机制安装到当前项目：
- 不绑定单一受支持 IDE：不预设
AGENTS.md、.agents/skills/或某个专用目录一定有效；中立资产不表示支持所有 IDE，当前排除 Qoder / Qoder CN； - 先查真实配置和最新文档：自动安装要求 Agent 能读取当前 IDE 配置，并能联网核对当前版本的官方文档；
- 项目级优先：默认只影响当前项目，减少不同项目和不同 IDE 之间的规则污染；
- 规则与流程分开：长期原则放规则，多步骤工作流放 Skills，模板跟随对应 Skill；
- 确定性任务路由：规则先按明确条件分类任务，再显式加载对应 Skill，不只依赖 IDE 猜测；
- 与其他框架共存：保留当前项目已经生效的规则和工作流，每个任务阶段只保留一个主流程；
- 安装后必须验证：文件复制成功不等于规则和 Skills 已被当前会话加载；
- 完成门禁不可省略：长期或含数据的项目在实施前、交付前各运行一次只读检查器，并结合人工验收阻止过早宣布完成；
- Secret 不进入输出：完整值、截断值和轻微变形都不得出现在终端、日志、自检或回复中；
- 面向个人开发全流程：覆盖调研、实现、调试、交付准备和公开发布等常见任务。
当前工作版本为 1.2.0，版本及路径核验日期为 2026-07-23。
| 内容 | 位置 | 用途 | 是否安装 |
|---|---|---|---|
| 使用说明 | README.md、MANIFEST.md、PLACEMENT-GUIDE.md |
告诉人和 Agent 如何理解、放置与验证 | 否，只阅读 |
| 长期规则 | assets/rules/AGENTS.md |
每次编码都应遵循的稳定原则 | 是，按 IDE 的项目规则机制安装 |
| 六个 Skills | assets/skills/*/ |
在特定任务中按需加载的工作流 | 是，完整复制目录 |
| Skill 模板 | 各 Skill 内的 assets/ |
PRD、架构、任务卡、状态等项目工件 | 随对应 Skill 一起安装 |
Note
复制 Skill 时必须保留完整目录及其内部相对路径。只复制 SKILL.md 会丢失它引用的模板资产。
flowchart LR
A["EasyUseAIDE 中立资产"] --> B["Agent 识别 IDE、版本与项目"]
B --> C["读取真实配置并查询最新官方文档"]
C --> D{"交叉确认发现机制与冲突"}
D --> E["项目级规则"]
D --> F["项目级 Skills"]
E --> G["重启 IDE 或新开对话"]
F --> G
G --> H["验证加载与真实任务路由"]
H --> I["实现前显式加载适用 Skill"]
I --> J["实施前与交付前执行门禁"]
EasyUseAIDE 采用“中立资产唯一来源、项目级默认、用户级可选”的安装模型：
assets/rules/和assets/skills/始终是跨 IDE 的权威资产源；- Agent 先识别当前 IDE 或 Coding Agent、版本、操作系统和项目根目录；
- 读取当前 IDE 的真实配置、已加载规则和 Skills，并联网查询与当前版本匹配的最新官方文档；
- 交叉确认项目规则机制、Skills 路径、发现顺序和刷新方式，再比较名称、路径、触发范围、强制流程和工件位置；
- 安装前解决冲突并备份，安装后重启或新开会话；
- 新会话按确定性条件显式加载对应 Skill，不把自动调用当作唯一保障；
- 项目专属规则在开发中生成或更新后，再次刷新规则或新开会话验证其已生效；
- 只有规则、Skills 和至少一个真实只读路由场景都被验证，才算配置完成。
项目自身的技术栈、目录、命令和业务约束始终属于项目级内容，不应提升为所有项目共享的全局规则。
EasyUseAIDE 不替代项目已经采用的开发方法论。发现其他规则、插件、Hooks、Commands、Workflows 或 Skills 时，不卸载、不重装、不移动、不改名，也不把双方文件复制进对方目录。
运行时遵循三个原则：
- 每个任务阶段只选择一个主流程：不同阶段可以顺序使用不同 Skill，但不重复执行两套需求澄清、计划、调试、测试、评审或收尾；
- 专项能力只补缺口：EasyUseAIDE 在项目上下文、依赖决策、复杂故障、交付基线、公开发布和高风险 Git 边界出现时增加专项检查；
- 证据和工件只保留一份：复用已有计划、设计、测试、日志、评审和构建结果，同一事实只维护一个权威来源。
“按需”不等于“等待模型想起来”。始终加载的项目规则包含确定性触发表；条件命中时，Agent 必须使用 IDE 的手动调用方式或直接读取 SKILL.md，并在交付时报告实际加载结果。
与其他工作流一起使用时，按能力而不是按产品名称分工：
| 场景 | 主流程 | EasyUseAIDE 的参与方式 |
|---|---|---|
| 已有需求澄清、实施计划、TDD 或代码评审流程 | 项目已有流程 | 提供项目规则和范围边界，不重复流程 |
| 普通 Bug | 项目已有调试流程 | 不启动第二套完整调试 |
| 间歇性、并发、性能、资源泄漏或反复复发 | 项目已有调试流程 | easyuseaide-complex-debugging 只补充专项检查 |
| 新建正式工程，或项目上下文缺失、混乱 | easyuseaide-project-bootstrap |
首次实现前建立最小持续上下文，不复制已有事实 |
| 依赖选型或升级 | easyuseaide-dependency-research |
已有框架继续负责实施节奏 |
| 长期、共享、部署、公开或含持久化数据的项目 | easyuseaide-project-delivery-readiness |
建立交付基线，并在首次里程碑完成前执行检查器和人工门禁 |
| 公开仓库或发布版本 | easyuseaide-public-repository-release |
复用已有测试和评审，增加公开边界检查 |
| 历史重写、强推等危险 Git 操作 | easyuseaide-high-risk-git-operation |
只在危险步骤增加恢复和确认门禁 |
用户当前指令和项目规则始终优先。两套强制要求无法同时满足时，Agent 必须报告差异并等待决定，不能默默选择。
| Skill | 什么时候使用 |
|---|---|
easyuseaide-project-bootstrap |
新建正式工程首次实现前，或长期项目上下文缺失、冲突时使用 |
easyuseaide-dependency-research |
选择或首次写入外部依赖前使用 |
easyuseaide-complex-debugging |
为复杂、间歇性或反复故障补充专项检查 |
easyuseaide-project-delivery-readiness |
长期、共享、部署、公开或含数据项目在里程碑完成前必须使用 |
easyuseaide-public-repository-release |
安全检查并公开发布代码仓库或版本 |
easyuseaide-high-risk-git-operation |
为历史重写、强推等危险 Git 操作增加安全门禁 |
其中 easyuseaide-project-delivery-readiness 会按项目的真实需要检查：
- 可重复启动；
- 基础 CI；
- 数据备份与迁移；
- 配置与密钥隔离；
- 发布与回滚说明；
- 最基础的错误日志。
这些能力按需启用。一次性脚本和准备丢弃的实验不会被机械套用完整交付流程。
该 Skill 被加载后，首个交付动作是运行只读检查器；交付前必须再次运行。检查器仍有失败、恢复演练等人工门禁未完成或核心验收未验证时，Agent 只能报告“实现完成，交付验证未完成”。
下载或克隆本仓库，并让目标 AI IDE 中的 Agent 能够读取整个 EasyUseAIDE 文件夹。不要只提供单个规则文件或某一个 Skill。
请把 EasyUseAIDE 配置到当前项目。开始前完整读取 EasyUseAIDE 根目录的 README.md、MANIFEST.md 和 PLACEMENT-GUIDE.md。
自动安装有两个必要前提：你必须能够读取当前 IDE 或 Coding Agent 的真实配置，并且能够联网查询其最新官方文档。请先识别当前工具、具体版本、操作系统和项目根目录；再检查当前实际生效的项目级与用户级规则、Skills、插件、Hooks、工作流、配置路径和加载顺序；同时联网查阅与当前版本匹配的官方文档，核对项目规则机制、项目级 Skills 路径、优先级、刷新或重启方式。实际配置与文档不一致时，先报告差异，不要自行猜测。
如果当前工具是 Qoder 或 Qoder CN，请停止安装并明确说明 EasyUseAIDE 当前不支持该工具；不要复制到 `.qoder/skills/`，不要创建 Qoder 规则或适配文件，也不要声称可以通过手动配置获得受支持状态。
如果你不能读取 IDE 的真实配置，或者不能联网核对最新官方文档，请停止自动安装，明确告诉我缺少哪项能力，以及我需要提供什么信息或手动完成什么步骤。不得仅凭模型记忆、文件名或其他 IDE 的惯例推测安装位置，也不得把未经验证的路径描述成通用方案。
满足前置条件后，默认只安装到当前项目。根目录说明文件只供阅读，不安装。写入前检查目标位置、现有项目规则和 Skills；对确实会修改的已有文件先做可恢复备份。把 assets/rules/AGENTS.md 的内容合并到官方文档和真实配置共同确认的项目规则机制中，把 assets/skills/ 下六个完整 Skill 目录复制到共同确认的项目级 Skills 位置，并保持每个 Skill 的内部相对路径不变。
如果规则只能通过 IDE 设置界面导入，或者当前 Agent 不能操作该界面，不要创建一个不会生效的文件并声称安装成功；告诉我需要手动导入的内容、入口和验证方法。
如果当前项目已经存在其他规则、Skills 或工作流，保留它们并检查名称冲突、路径覆盖、触发重叠、规则矛盾和重复工件。每个任务阶段只使用一个主流程；EasyUseAIDE 只补充现有流程没有覆盖的专项能力。发现真实冲突时停止相关写入并报告，不要擅自修改第三方内容。
未经我明确确认，不得改为用户级或全局安装，不得删除或覆盖未备份的有效内容，不得安装额外软件，也不得绕过当前工具的权限和审批。
完成后报告：查询过的官方文档链接及核验日期、读取到的 IDE 配置来源、实际安装范围、规则的生效方式、六个 Skill 的路径、备份和冲突处理、无法确认或未完成的事项。提醒我按照当前工具支持的方式重启 IDE、刷新配置或新开对话，再验证规则和 Skills 是否真正加载；文件存在不等于已经生效。
新会话中还必须完成一次只读路由演练：以“新建一个包含数据库、准备长期运行并计划开源的项目”为场景，实际加载 easyuseaide-project-bootstrap 和 easyuseaide-project-delivery-readiness，确认能够读取正文、模板以及交付检查器；只列出 Skill 名称不算通过。此演练保持只读，不运行项目命令。
Important
安装完成后，请先完全重启当前 AI IDE，或者关闭当前对话并新开一个对话。
很多 AI IDE 会在启动或创建会话时读取规则与 Skills，安装前已经打开的旧会话可能仍使用缓存。此时旧会话显示“没有识别到”，并不能直接证明安装失败。
建议按这个顺序完成：
- 等待 Agent 完成复制、合并和备份，并记下它报告的实际安装位置；
- 优先完全退出并重新打开 AI IDE；如果当前 IDE 的官方说明明确支持刷新会话，则至少关闭旧对话并新建对话；
- 在新对话中让 Agent 报告它实际读取到的项目规则、已有工作流和六个
easyuseaide-Skills； - 让 Agent 对一个包含数据库、长期运行并计划开源的新项目执行只读路由演练，实际加载 bootstrap 和 delivery-readiness，而不是只说明它们存在；
- 确认 delivery-readiness 的模板和
scripts/check_delivery_baseline.py可以读取； - 对照下方验收清单检查；只有“已加载、真实路由正确、附属资源可读”而不只是“文件存在”，才算安装成功。
可以在新对话中发送：
请不要修改任何文件。请根据当前会话能够实际访问的信息，报告本项目已经加载的规则来源和 Skills，并列出能够发现的六个 easyuseaide- Skills，同时说明它们是项目级还是用户级。
然后以“新建一个包含数据库、准备长期运行并计划开源的项目”为只读演练场景，按照已加载规则完成任务路由，并实际加载 easyuseaide-project-bootstrap 与 easyuseaide-project-delivery-readiness。读取两者正文各自的入口要求，确认 bootstrap 模板和 delivery-readiness 的 scripts/check_delivery_baseline.py 可以访问。不要创建项目文件，也不要运行检查器。
最后说明“普通功能修改、复杂并发故障、依赖升级、公开发布、高风险 Git”分别应使用哪个主流程和哪个补充 Skill。能够列出 Skill 但不能实际加载正文或附属资源时，应判定验收未通过；无法确认时明确说未确认，不要根据文件存在推测。
Warning
上面的安装提示词授予的是“按说明配置”的任务目标，不代表允许 Agent 删除现有有效规则、覆盖未备份文件、绕过权限或审批、安装额外软件，或者在路径无法确认时猜测写入。
Agent 完成安装，并在重启后的新会话中复查后，应能报告：
- 能够确认的工具、版本和操作系统信息；
- 查询过的最新官方文档链接、核验日期及其对应版本；
- 实际读取的 IDE 配置来源；
- 读取了哪些 EasyUseAIDE 说明文件；
- 采用项目级还是用户级安装，以及选择依据；
- 当前 IDE 是否自动发现
AGENTS.md，规则究竟通过文件、专用目录还是设置界面生效； - 选择了哪些规则与 Skills 目录；
- 备份了哪些旧文件，备份位置在哪里；
- 是否安装了六个完整 Skill 目录及其模板资产；
- 六个 Skill 是否都以
easyuseaide-开头； - 发现了哪些第三方框架、插件、Hooks 或 Skills；
- 名称、路径、触发、规则和工件冲突如何处理；
- 是否存在同名的项目级和用户级副本，以及实际优先级；
- 使用了什么官方发现机制；
- 哪些规则与 Skills 已被新会话实际加载；
- 只读演练是否在实际使用记录或会话上下文中加载了 bootstrap 和 delivery-readiness；
- delivery-readiness 的模板和只读检查器是否可访问；
- 新功能、普通 Bug、复杂故障、依赖决策、交付准备和公开发布是否各自只有一个主流程；
- 哪些内容未安装或未验证；
- 是否存在需要人工决定的冲突。
如需用户级或全局安装，应另行明确说明“将六个通用 Skill 安装到当前 IDE 的用户级位置”，并在执行前确认影响范围、同名优先级和现有副本。不要把全局安装隐藏在默认提示词中。
EasyUseAIDE/
├── README.md
├── MANIFEST.md
├── PLACEMENT-GUIDE.md
├── TREE.txt
├── REFERENCES.md
├── LICENSE
└── assets/
├── rules/
│ └── AGENTS.md
└── skills/
├── easyuseaide-project-bootstrap/
├── easyuseaide-dependency-research/
├── easyuseaide-complex-debugging/
├── easyuseaide-project-delivery-readiness/
├── easyuseaide-public-repository-release/
└── easyuseaide-high-risk-git-operation/
详细文件分类、资产数量和完整路径分别见：
MANIFEST.md：说明文件、规则资产和 Skill 资产清单；PLACEMENT-GUIDE.md：不同 IDE 的放置决策与验证方法；TREE.txt：完整目录树。
本地运行：
ruby scripts/validate-skills.rb验证覆盖六个 Skill 的 YAML、命名空间、description、目录一致性、模板引用、交付检查器自测、本地文档链接、文件总数和 CI 配置。GitHub Actions 会在推送和 Pull Request 时执行同一脚本。
- 中立规则资产只放长期稳定、跨项目可复用的原则；
- 默认安装到项目级，用户级或全局安装必须由用户明确选择；
- 多步骤流程放入 Skills；始终加载的规则按确定性条件显式路由，不只依赖 IDE 自动调用；
- 项目特有的技术栈、目录、命令和业务约束放入项目级规则；
- 长期项目使用 PRD、architecture、task-card 和 project-status 保存跨会话上下文；
- 已有框架继续负责其通用流程，每个任务阶段只选择一个主流程；
- 长期维护、共享、发布或使用持久化数据的项目，在首次里程碑完成前使用
easyuseaide-project-delivery-readiness建立并验证最低交付能力； - 交付检查器在实施前和交付前各运行一次；失败项或人工门禁未解决时，不得声称可交付；
- Secret 的完整值和截断值都不得进入终端、日志、自检和回复，只报告安全引用；
- 只读分析、解释和审查任务不得因为本包的上下文机制变成写入任务；
- 权限和危险命令限制应在各工具自身的审批、沙箱、Hook 或权限系统中单独配置；
- 本包不提供自动安装脚本。
EasyUseAIDE 是独立整理的工程化配置体系。对本项目产生启发的公开项目和教程列在 REFERENCES.md 中；列入参考不表示原作者参与、认可或为本项目背书。
EasyUseAIDE 自有内容采用 MIT License 发布。外部参考资料仍分别适用其各自的许可证或网站条款。