关于 cs-build-getting-started
为 CodeSpring 项目提供入门引导的 Agent 技能，通过本地状态脚本盘点项目，并依据项目阶段给出唯一下一步建议。适合需要确定从审计、导入还是规划开始的团队。
主要功能
- 01检查 CLI、身份验证和项目关联
- 02用脚本检测项目状态
- 03报告项目资源数量
- 04依据五项诊断选择下一步
- 05说明后续构建流程
适用场景
- 01确认当前关联的项目及其内容
- 02为现有代码选择审计或导入
- 03为尚无代码的想法规划应用
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/cs-build-getting-started确认已加载。
详细介绍
开始使用 CodeSpring
连接，说明项目位于何处，指出一个下一步。简短说明，然后交接。
使用 codespring 技能的 references/project-state.md（状态检测、五个问题、三个阶段）、references/pitfalls.md 及其 scripts/（确定性状态检测）。
第 1 步 — 连接
- 是否已安装 CLI？ 如果缺少
codespring：npm i -g @codespring-app/cli。 - 是否已通过身份验证？
codespring auth status。如果没有，请让他们运行codespring auth login并等待。（运行此命令也会刷新已过期的令牌。） - 项目是否已关联？
codespring status。- 已关联 → 记下名称并继续。
- 尚未关联 → 关联现有项目（
codespring projects→codespring init --project <id> --force），或创建一个项目。如果项目必须位于团队工作区中，他们应先在 Web 应用中创建项目 —project create会忽略--org，而且无法通过 CLI 移动或删除项目（pitfalls.md）。 - 始终以本地
.codespring/config.json为准，确定当前启用的项目，并输出 projectId。
第 2 步 — 说明项目的状态
运行状态检测脚本，不要凭 CLI 输出目测判断 — 每次运行的摘要都必须完全一致。脚本位于 codespring 技能中，该技能与此技能一起安装，因此路径相对于此技能的文件夹；先将其解析为绝对路径，因为当前工作目录将是用户的仓库。
bash ../codespring/scripts/fetch-project.sh --out /tmp/cs-state # read-only snapshot; prints the projectId
node ../codespring/scripts/state.mjs /tmp/cs-state # the one-line summary + the counts
然后用一行报告：
已连接为 workspace，项目 name — 6 个核心功能、25 个子功能、6 条备注、0 个 PRD、0 个任务。审计：尚未进行。
这一行就是此技能的全部意义。它会告诉用户他们已经有什么，让他们不再猜测该运行哪个技能。
第 3 步 — 指出唯一的下一步
使用 project-state.md 中的分支表。只给一个建议，不要列出选项。 如果项目已有地图、备注、PRD 或任务，下一步应按该表决定 — 不要从头开始。
如果项目为空，只有两个问题：是否有代码？ 如果有，它能否完成工作？ 第二个问题就是 project-state.md 中的五问诊断 — 要提出这些问题，不要问“你信任它吗”：
- 应用能完成它实际需要完成的工作吗？
- 它会出错，或把编造的、无法核实的数字当作事实呈现吗？
- 当前架构能让它完成所需的工作吗？
- 我们能否在此基础上进行可扩展的构建？
- 用户能否使用它而不遇到故障？
| 回答 | 下一步 |
|---|---|
| 五个问题中任何一个回答否 | cs-build-audit-codebase — 诊断代码，提供一份通俗易懂的问题清单，并按代价排序，给出重建或修复的结论（有真实用户这一点本身就足以否决重建）。随后会创建地图和任务。 |
| 五个问题的回答全是肯定 | cs-build-import-codebase — 将真实代码映射为核心功能，并附上备注和 PRD。（如果代码看起来有问题，它仍会建议进行审计。） |
| 还没有代码 — 只有一个想法 | cs-build-plan-app — 对应于导入流程的无代码版本。它会采访他们（或分析通话录音）、逐个梳理界面、根据能力选择平台、找出一个难点及其真实先例，将范围缩减到可销售的 v1，然后在写入任何内容前完整复述整个计划，等待确认。它会自行编写地图和备注，然后交接给 cs-build-create-prd。 |
“代码能运行”并不等于“代码能完成工作”。 氛围编码的应用通常能正常运行，但仍无法通过第 1–3 个问题，因此不要把“它能用”当作五个肯定答案。如果用户无法凭已有知识作答 — 大多数人都不能 — 就运行 project-state.md 中的快速健康状况检查，并根据证据作答：“通常意味着应用需要诊断的 6 个迹象中，有 4 个存在”，然后让他们选择。
他们是否选“错”并不重要。每个技能在启动时都会检测真实状态，并采取正确的下一步。
旅程的其余部分
有了地图和备注后，流程如下：cs-build-ui-mockup → cs-build-create-prd → cs-build-create-tasks → cs-build-feature → cs-build-resync-codebase。
对于任何带有用户界面的项目，cs-build-ui-mockup 都应先于 PRD 执行，而且不是可选步骤。 它会根据备注制作一个可点击的临时样稿，并进行评审，找出书面计划无法表达的问题——屏幕顺序、层级、位置，以及最终发现并不完整的选项。根据无人审阅过的计划生成的 PRD，只会把误解描述得更加详细。Understand 生成上下文（地图 + 备注）；Plan 生成指令（PRD + 任务）；PRD 的质量取决于它读取的备注（project-state.md）。
好的结果是什么样
- 首先完成身份验证，并指向正确的本地项目——如果一个应用对应两个项目，应告知用户哪个项目是权威版本（
project-state.md）。 - 根据脚本输出，用一句话告知用户项目的实际位置，而不是手动计数。
- 路由依据的是五个问题，而不是“你信任它吗”——也不能把“它能运行”当作五个肯定回答。
- 只指出一个下一步，而且符合项目的实际状态——不要列出一长串选项。