AI onboarding: uwf prompt setup 引导流程改进建议 #99
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
背景
以 AI agent 视角从零体验
@united-workforce/cli@0.1.1安装配置流程，发现以下问题：问题 1：
uwf prompt usage输出了三个 skill 拼在一起运行
uwf prompt usage时，stdout 包含了uwf-usage+uwf-workflow-authoring+uwf-adapter-developing三个完整 SKILL.md（用---分隔拼接），而不是只输出uwf-usage一个。如果安装指南告诉 AI "把
uwf prompt usage的输出作为 SKILL.md 创建一个 skill"，AI 会拿到一个包含三段 frontmatter 的文件——这不是合法的 SKILL.md。预期行为：每个
uwf prompt <name>只输出对应的单个 SKILL.md 内容。问题 2：
uwf prompt setup的指导方式需要改进当前输出告诉 AI：
问题：
skill_manage）来创建 skill建议：
setup输出应该这样引导（框架无关）：AI 会自动执行命令、拿到输出、用框架的 skill API 完成创建，不需要中间预览步骤。
问题 3：
setup和bootstrap命名容易混淆uwf prompt setup输出安装指南，uwf prompt bootstrap输出 skill 内容，但这两个名字对 AI 来说含义太接近。AI 第一反应会觉得 bootstrap 才是安装指南，setup 才是 skill 内容——实际恰恰相反。建议：
bootstrap，让setup只做安装指南；或者uwf prompt quickref（快速参考卡片），和setup（安装步骤）明确区分整体评价
AI 友好度 7/10
uwf prompt setup很好找补充：问题 2 的安装引导可以更简化，不需要让 AI 先预览输出内容，直接一步到位：
uwf prompt usage，将输出内容作为 SKILL.md 创建一个名为uwf-usage的 skilluwf prompt workflow-authoring创建uwf-workflow-authoringskilluwf prompt adapter-developing创建uwf-adapter-developingskillAI 会自动执行命令、拿到输出、用框架 skill API 完成创建，不需要中间步骤。