[Conflict Resolving + minor updates] feat: Add support for Trae AI

[TCoherence]

Summary

This PR mainly fixes merging conflicts based on #764, additionally, adding the following:

1. Refactored trae description across multiple doc files to match IDE-based agent description
2. Fixed specify command issue in init.py file becaseu of some outdated changes.
3. Added "--template-file" option for specify init command to avoid downloading release packages from github when testing adding new agents.

Testing with screenshots

#	Description	Screenshot
1	Tested with local specify init run with Trae
2	Tested with /speckit.constitution prompt in Trae IDE

Acknowledge

The PR is based on the work done by @wolone in #764

AI Usage Disclosure

"--template-file" option is implemented with the help with Github Copilot with minor human code updates

[TCoherence]

Hey @localden Could you take a look at this PR when you free? Thanks!

[localden]

@TCoherence this looks reasonable. Please resolve the conflicts, and we should be good to go.

[chiaoyuan1991]

Dear Sir,

Thank you so much for all your hard work on the spec-kit project. I have a question regarding its usage: I created a release based on your branch and copied it to the project directory. However, when I ran /speckit.constitution, instead of generating the constitution.md as expected, it performed many unrelated tasks.

Could you kindly guide me on how to properly use spec-kit in the trae environment? Also, is the "/" command correctly recognized in trae?

I'm relatively new to this and would truly appreciate your help. Thank you in advance for your guidance.

[TCoherence]

@chiaoyuan1991 I was not able to see the screenshot you pasted. Just a quick note for awareness, currently Trae doens't officially support this, normally you need some tricks to enable slash commands in Trae. I have internally discussed with their PMs and they told me it wouldn't be added this Q4 (Previously planned for Q4 but pushed back because of some other high priority stuff...)
A small trick is that you can easily point it out for the agent to check the command file, or you can do some prompt engineering in your customized Trae agent and it should be good enough to follow you "slash commands". A quick example is as follows:

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

[TCoherence]

@localden Just merged from the remote main branch and solved the conflicts locally. Also retest it out locally. Please take a look at it when you have a chance.

Testing with screenshots

#	Description	Screenshot
1	Tested with local specify init run with Trae
2	Tested with /speckit.constitution prompt in Trae IDE

[chiaoyuan1991]

@chiaoyuan1991我没看到你贴的截图。简单说明一下，目前 Trae 官方不支持斜杠命令，通常需要一些技巧才能在 Trae 中启用斜杠命令。我内部和他们的产品经理讨论过，他们告诉我第四季度不会添加这个功能（计划在第四季度添加，但由于其他一些优先级更高的任务而被推迟了……）。 一个小技巧是，你可以轻松地制作代理检查命令文件，或者你可以在自定义的 Trae 之前代理中进行一些提示符工程，这样它应该就能识别你的斜杠命令了。以下是一个简单的示例：

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

您的意思是当我执行斜杠命令时，引用.trae/workflow中对应的文件吗？
比如在我执行/speckit.constitution时，使用#引用.trae/workflow/speckit.constitution.md。

[TCoherence]

@chiaoyuan1991我没看到你贴的截图。简单说明一下，目前 Trae 官方不支持斜杠命令，通常需要一些技巧才能在 Trae 中启用斜杠命令。我内部和他们的产品经理讨论过，他们告诉我第四季度不会添加这个功能（计划在第四季度添加，但由于其他一些优先级更高的任务而被推迟了……）。 一个小技巧是，你可以轻松地制作代理检查命令文件，或者你可以在自定义的 Trae 之前代理中进行一些提示符工程，这样它应该就能识别你的斜杠命令了。以下是一个简单的示例：

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

您的意思是当我执行斜杠命令时，引用.trae/workflow中对应的文件吗？ 比如在我执行/speckit.constitution时，使用#引用.trae/workflow/speckit.constitution.md。

@chiaoyuan1991 对的，现在这是一个trade off的方法，因为slash command本身解决的也是这个技术问题。但是如果只是使用的话，这是可以这么使用的。

[chiaoyuan1991]

@chiaoyuan1991我没看到你贴的截图。简单说明一下，目前 Trae 官方不支持斜杠命令，通常需要一些技巧才能在 Trae 中启用斜杠命令。我内部和他们的产品经理讨论过，他们告诉我第四季度不会添加这个功能（计划在第四季度添加，但由于其他一些优先级更高的任务而被推迟了……）。 一个小技巧是，你可以轻松地制作代理检查命令文件，或者你可以在自定义的 Trae 之前代理中进行一些提示符工程，这样它应该就能识别你的斜杠命令了。以下是一个简单的示例：

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

您的意思是当我执行斜杠命令时，引用.trae/workflow中对应的文件吗？ 比如在我执行/speckit.constitution时，使用#引用.trae/workflow/speckit.constitution.md。

@chiaoyuan1991 对的，现在这是一个trade off的方法，因为slash command本身解决的也是这个技术问题。但是如果只是使用的话，这是可以这么使用的。

依然有一个问题想要问您，我无法使用--template-file这个option，请问该如何解决。

[TCoherence]

@chiaoyuan1991我没看到你贴的截图。简单说明一下，目前 Trae 官方不支持斜杠命令，通常需要一些技巧才能在 Trae 中启用斜杠命令。我内部和他们的产品经理讨论过，他们告诉我第四季度不会添加这个功能（计划在第四季度添加，但由于其他一些优先级更高的任务而被推迟了……）。 一个小技巧是，你可以轻松地制作代理检查命令文件，或者你可以在自定义的 Trae 之前代理中进行一些提示符工程，这样它应该就能识别你的斜杠命令了。以下是一个简单的示例：

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

您的意思是当我执行斜杠命令时，引用.trae/workflow中对应的文件吗？ 比如在我执行/speckit.constitution时，使用#引用.trae/workflow/speckit.constitution.md。

@chiaoyuan1991 对的，现在这是一个trade off的方法，因为slash command本身解决的也是这个技术问题。但是如果只是使用的话，这是可以这么使用的。

依然有一个问题想要问您，我无法使用--template-file这个option，请问该如何解决。

这个需要你自己debug一下，我大概推测是你本地specify没有更新，这个template file option是我这个分支才有的，你需要切换到我这个分支，覆盖安装本地的specify。或者你可以尝试在本地setup venv之后，用过pip安装，这样只会安装到你的虚拟环境，这样不会污染你的全局环境了。

[chiaoyuan1991]

@chiaoyuan1991我没看到你贴的截图。简单说明一下，目前 Trae 官方不支持斜杠命令，通常需要一些技巧才能在 Trae 中启用斜杠命令。我内部和他们的产品经理讨论过，他们告诉我第四季度不会添加这个功能（计划在第四季度添加，但由于其他一些优先级更高的任务而被推迟了……）。 一个小技巧是，你可以轻松地制作代理检查命令文件，或者你可以在自定义的 Trae 之前代理中进行一些提示符工程，这样它应该就能识别你的斜杠命令了。以下是一个简单的示例：

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

您的意思是当我执行斜杠命令时，引用.trae/workflow中对应的文件吗？ 比如在我执行/speckit.constitution时，使用#引用.trae/workflow/speckit.constitution.md。

@chiaoyuan1991 对的，现在这是一个trade off的方法，因为slash command本身解决的也是这个技术问题。但是如果只是使用的话，这是可以这么使用的。

依然有一个问题想要问您，我无法使用--template-file这个option，请问该如何解决。

这个需要你自己debug一下，我大概推测是你本地specify没有更新，这个template file option是我这个分支才有的，你需要切换到我这个分支，覆盖安装本地的specify。或者你可以尝试在本地setup venv之后，用过pip安装，这样只会安装到你的虚拟环境，这样不会污染你的全局环境了。

我确实使用的是您的分支。 但是依然提示这个报错。

[TCoherence]

@chiaoyuan1991我没看到你贴的截图。简单说明一下，目前 Trae 官方不支持斜杠命令，通常需要一些技巧才能在 Trae 中启用斜杠命令。我内部和他们的产品经理讨论过，他们告诉我第四季度不会添加这个功能（计划在第四季度添加，但由于其他一些优先级更高的任务而被推迟了……）。 一个小技巧是，你可以轻松地制作代理检查命令文件，或者你可以在自定义的 Trae 之前代理中进行一些提示符工程，这样它应该就能识别你的斜杠命令了。以下是一个简单的示例：

/speckit.constitution Please create a general constitution spec for my static web blog page

#speckit.constitution.md (a `#` should pops out a context window like below where you can choose the file easily)

您的意思是当我执行斜杠命令时，引用.trae/workflow中对应的文件吗？ 比如在我执行/speckit.constitution时，使用#引用.trae/workflow/speckit.constitution.md。

@chiaoyuan1991 对的，现在这是一个trade off的方法，因为slash command本身解决的也是这个技术问题。但是如果只是使用的话，这是可以这么使用的。

依然有一个问题想要问您，我无法使用--template-file这个option，请问该如何解决。

这个需要你自己debug一下，我大概推测是你本地specify没有更新，这个template file option是我这个分支才有的，你需要切换到我这个分支，覆盖安装本地的specify。或者你可以尝试在本地setup venv之后，用过pip安装，这样只会安装到你的虚拟环境，这样不会污染你的全局环境了。

我确实使用的是您的分支。 但是依然提示这个报错。

不是的，你可以看到你的截图，安装是从github main分支安装的，你可以了解一下uv tool或者pip如何从特定分支进行安装。