app-implement

app-implement 根据 APP_BRIEF.md 实现应用更改。与上次执行进行比较，只实现差异部分。 --dry-run（可选）：打印计划更改，不执行操作 /app-implement /app-implement --dry-run

执行前检查

继续之前，请确认你位于已搭建脚手架的 Cribl 应用文件夹中。如果不是，请停止并告知用户：“你必须在已搭建脚手架的 Cribl 应用文件夹中运行此技能。”

说明

你将根据 APP_BRIEF.md 文件实现 Cribl 应用。**默认对所有组件使用 Capra UI。**开始之前，请阅读 ./references/cribl-apps-guidance.md，避免在 KV 存储、状态管理、错误处理以及其他 Cribl 特定模式方面遇到常见问题。

请遵循以下工作流：

1. 验证前置条件

• 检查工作目录中是否存在 APP_BRIEF.md
• 如果不存在，报错：“未找到 APP_BRIEF.md。请先运行 /app-brief。”
• 如果 /executions 目录不存在，则创建该目录

2. 加载并比较版本

• 读取当前的 APP_BRIEF.md
• 在 /executions 中查找最新的 APP_BRIEF_*.md（按文件名中的时间戳排序）
• 如果没有之前的执行记录：将当前简介的全部内容视为新工作（差异 = 全部内容）
• 如果存在之前的执行记录：比较两者，找出：
  • 新增的章节/要求
  • 修改的章节/要求
  • 删除的章节（注意：不要撤销这些更改）

3. 将差异解析为操作项

• 从差异中提取具体的实现任务
• 为每项任务编写一行清晰、可执行的描述
• 示例：
  • “创建新组件：UserInput”
  • “更新 API 端点 /search，以支持筛选”
  • “为 AuthService 添加测试覆盖”

4. 试运行模式（如果提供了 --dry-run 标志）

• 打印标题：“=== DRY RUN: Planned Changes ===”
• 将每个操作项单独打印为一行（仅列出操作，不添加描述）
• 打印结尾：“=== End Dry Run ===”
• 输出示例：

  === DRY RUN: Planned Changes ===
  Create new component: UserInput
  Update API endpoint /search to support filtering
  Add test coverage for AuthService
  === End Dry Run ===
  

5. 实现模式（正常执行，不带 --dry-run）

• 执行差异：按需创建文件、修改代码、更新配置
• 从 APP_DEFINITION.md 中读取应用 ID（位于“## App ID”章节下）
• 更新 package.json 中的 "name" 字段，使其与应用 ID 一致
• 清除所有代码检查错误，并运行 npm run lint

6. 归档本次运行

• 将当前 APP_BRIEF.md 复制到 /executions/APP_BRIEF_[ISO8601-timestamp].md
• 使用格式：APP_BRIEF_2026-07-31T14-30-45Z.md（ISO 8601 格式，将冒号替换为连字符，以兼容文件系统）
• 此文件将作为下一次运行的基准

7. 确认 package.json 已更新

• 验证 package.json 的 "name" 字段现在与 APP_DEFINITION.md 中的应用 ID 一致

关键原则

• **事实来源：**始终以当前的 APP_BRIEF.md 为准
• **幂等性：**技能可以重复运行；每次运行只处理发生变化的内容
• 运行间无状态：/executions 文件夹是唯一的状态持久化方式