用途
wkc-setup 用于将某个项目配置为使用面向 AI-SDLC 的技能工作流。它面向每个仓库运行一次，在 wkc-tracker 之前使用；也可重新运行以更换跟踪器，或把旧配置更新到当前字段。它通过访谈方式了解仓库情况，搭建项目结构，并写出后续工具读取的配置文件。
主要能力
- 检测模式：通过读取文件（而非假设）判断仓库是全新项目（无源码树）还是已有项目（存在源码目录、包清单、git 历史）。
- 读取已有信息：已有 config.md、git 仓库状态、git remote、根目录的 AGENTS.md 与 CLAUDE.md、已有的产品意图文档、项目测试命令。
- 访谈：按顺序逐节提问，一次一节、一节一问。提供编号选项并将推荐项放在首位，支持输入数字作答。
- 选择问题跟踪器后端：GitHub、Linear、本地 markdown、其它（Jira、GitLab 等）。
- 收集产品意图文档位置、上下文文件、测试命令。
- 搭建目录：创建 docs/dev-agents/、config.md、rules/、必要时 issues/。
- 在配置的上下文文件中添加一行引用，使每个会话加载开发配置。
- 执行一次性的跟踪器设置。
- 对已有项目提供（非强制）逆向梳理当前架构到配置的 spec_file。
- 报告并提议提交脚手架与配置。
使用方式
无调用参数。上下文来自当前仓库、已有配置，以及用户对访谈的回答。不带参数调用即可开始或继续配置。
访谈分为若干节：
- 第 A 节：问题跟踪器。GitHub（使用 gh CLI，issues 位于仓库的 GitHub Issues）；Linear（使用 Linear MCP 服务器，需提供团队 key 和项目名）；本地 markdown（issues 作为 docs/dev-agents/issues/ 下的文件，适合个人项目或无远程仓库）；其它（描述工作流，记录为自由文本并将 issue_tracker 设为 other）。此节还会现场确认后端的先决条件。
- 第 B 节：产品意图文档位置，默认 docs/dev-agents/PRD.md、SPEC.md、ROADMAP.md。
- 第 C 节：上下文文件，默认 AGENTS.md，或对 Claude Code 专用项目使用 CLAUDE.md。
- 第 D 节：测试命令，确认或询问。
适用场景
- 希望为仓库引入 AI-SDLC 技能工作流的项目。
- 需要在不覆盖既有配置的前提下更换跟踪器或升级配置字段的项目。
- 已有代码库希望通过逆向梳理形成当前架构说明。
限制
- 依赖 git；GitHub 后端需要 gh，Linear 后端需要 Linear MCP 服务器。
- 无 git 仓库时需先处理 git init。
- 不创建空的 PRD.md、SPEC.md 或 ROADMAP.md（唯一例外是第 6 步从已有代码库写出 spec）。
- 不猜测路径写入配置。
- 不迁移已有规则文件，不重写项目已有的 AGENTS.md/CLAUDE.md 主体。
- Linear 缺失必需状态时停止，不自行映射到现有状态；多余状态作为警告报告。
- 关于安装状态、更新或移除，需显式调用 wkc-manage，setup 不维护安装报告。
- 具体收费、价格、平台、效果等信息暂未提供。