SuperAPI AI 工具集

astrofy-implementation-planner

编程与开发

查看项目

更新于 10-16 03:49

技能介绍

用途:在 astrofy-page-planner 之后或已有等价已批准规格时使用,产出技术工作项,不改动页面、不执行发布。

输入:读取 page.md、page-spec.json、本地指令与 Git 状态,确认路由、布局、组件、配置、样式、测试和脚本;查阅 astrofy status --json、清单与报告,区分已评估失败、待人工复核、未完成执行和过期结果。对仍为 proposed 或 content_pending 的关键字段拒绝规划,保留已声明的可选待办。

分解:参考 Astrofy 检出目录中 docs/sitespec.md 的模型与约定,封闭 schema 在 packages/schemas/sitespec.schema.json。astrofy plan 已生成 route、content、check 三个机械任务,需据此判断是否还需额外任务。额外任务用 astrofy-sitespec-create 注册(page: <slug> 与自定义 kebab-case task,名称不得为 route、content、check),记录可观察交付物、执行技能 primarySkill 与复核技能 reviewSkills、相关文件 relatedFiles、真实依赖 dependsOn(用同页任务 id)、分钟估算 estimateMinutes/estimateBasis,以及带 {#id} 的技术步骤与验证命令清单。不要创建“做响应式”这类泛化任务;若一次改动与一次校验覆盖同一行为,不必把每个清单项拆成独立任务。

技能选择:组合用 astrofy-page-design 与 astrofy-sections,仅当格式需要时选 homepage 或 landing-pages;按实际工作加入 config、routing、forms、images、accessibility、seo、open-graph、structured-data、testing、documentation 等。每个任务一个主技能,可列复核技能,不要在阶段间重复同一改动。page.md 记录 Voz e redação 时,在展示或修改文本的任务中加载该指引;任务创建或修改可见文案时,将 astrofy-editorial-review 列为复核技能。

输出与恢复:任务位于 .sitespec/<id>-<slug>-<task>/SITEPEC.md,每个任务一个文件,front matter 含 page: <slug> 与 task。Markdown 的 sitespec 是唯一来源,由 astrofy sitespec list/progress 与 TUI 的 Specs 标签读取;不再有 .astrofy/plans/ 或 implementation-plan.json。恢复时重跑 astrofy plan --slug <slug>,它协调三个机械任务且不丢状态和已勾选项,并按最新 page-spec.json 更新文本与依赖;手工创建的额外任务同样需复查。执行时 astrofy apply --slug <slug> 启动下一个就绪任务,--task 与 --status 记录完成、失败或有意撤回;依赖任务在全部前驱 completed 或 skipped 后才移除 blockedBy。手工额外任务由 astrofy-sitespec-implement 执行更新,不用 apply。执行前先呈现计划,批准仅授权所请求工作;push、发布、购买与外部改动仍需对应授权。