SuperAPI AI 工具集

cs-build-getting-started

智能体与模型

查看项目

更新于 10-15 19:50

技能介绍

用途:这是 CodeSpring 的入门入口技能,先连接账号、报告项目真实进度,再给出唯一下一步建议,然后交给后续技能。

主要能力与用法:

  1. 连接。检查 CLI 是否安装,缺失时执行 npm i -g @codespring-app/cli;用 codespring auth status 检查认证,未登录则请用户运行 codespring auth login 并等待(也会刷新过期令牌);用 codespring status 检查项目是否已关联。未关联可先用 codespring projects 查看再执行 codespring init --project <id> --force,或新建项目。若项目须放在团队工作区,需先在网页端创建,因为项目创建会忽略 --org,且 CLI 无法移动或删除项目。始终以本地 .codespring/config.json 判断当前项目,并打印 projectId。
  2. 报告状态。不要凭肉眼读 CLI 输出,而应运行随附的 codespring 技能中的确定性脚本:bash ../codespring/scripts/fetch-project.sh --out /tmp/cs-state(只读快照,打印 projectId),node ../codespring/scripts/state.mjs /tmp/cs-state。因工作目录是用户仓库,需先把路径解析为绝对路径。最后用一行报告,如:已连接为某工作区、项目名——6 个核心功能、25 个子功能、6 条笔记、0 个 PRD、0 个任务;审计:尚未。
  3. 给下一步。按 project-state.md 的分支表只给一个建议,不罗列菜单;已有地图、笔记、PRD 或任务时不从头开始。项目为空时只问两个问题:有没有代码;若有,它是否真能胜任。第二问用五问诊断:应用是否真能做需要做的事;是否出错或把编造、不可验证的数字当作事实呈现;当前架构能否支撑需求;能否可扩展地构建;用户使用时是否不崩溃。任一为否,走 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。任何有用户界面的项目都不可跳过 ui-mockup,它用笔记构建可点击的临时原型并进行评审,捕捉书面计划无法表达的内容;直接由未评审计划生成的 PRD 只会更详细地编码误解。

限制:官方文本未提供更多细节,包含收费、价格、平台支持等未说明;本介绍仅依据所给资料整理。