Skaro 2.0：AI 开发的工件

Skaro 2.0：基于项目工件的AI协作开发环境

Skaro 2.0 是一个工作空间，开发者与 AI 在明确分工下共同攻克项目。人类负责架构设计、需求定义和关键决策，AI 则扮演工程师角色：讨论任务、编写代码并记录进度。核心是 工件——存储在代码库中的结构化文件，用于保存架构决策记录 (ADR)、计划、规范和里程碑。这些工件充当项目的外部记忆，避免上下文丢失。

没有工件，协作就会陷入混乱：决策被遗忘，AI 生成代码时无法参考先前约定。Skaro 将聊天直接嵌入工件，确保讨论就在该发生的地方。

目录结构：.skaro

工件在 .skaro 文件夹中形成层级结构。主要组件包括：

.skaro
│   config.yaml
│   constitution.md
│   devplan.md
│   secrets.yaml
│   state.yaml
│   token_usage.yaml
│   usage_log.jsonl
│
├───architecture
│   │   adr-001-using-fastapi-as-web-framework.md
│   │   adr-002-simplified-layered-monolith-as-arch-pattern.md
│   │   architecture.md
│   │   chat-conversation.json
│   └───diagrams
├───milestones
│   └───01-foundation
│       └───config-module
│           │   clarifications.md
│           │   plan.md
│           │   spec.md
│           │   tasks.md
│           │   tests.json
│           └───stages
│               └───stage-01
│                   AI_NOTES.md
├───chat
│   tasks.json
└───templates
    adr-template.md
    plan-template.md

• architecture/：包含决策理由的 ADR 文件和图表。
• milestones/：里程碑及其子模块、计划、测试和 AI 笔记。
• chat/：任务日志，提供上下文。
• templates/：标准化工件的模板。

这个结构存放在 Git 仓库中，确保版本控制和便捷访问。

典型工作流程

工作从与 AI 协作制定架构文档开始。接着创建 devplan.md，将项目拆分为里程碑。每个里程碑包含 spec.md、plan.md、tasks.md，以及带有 AI_NOTES.md 的阶段。

• 在 architecture/ 的聊天中讨论架构，敲定 ADR。
• 生成里程碑及其子任务。
• 对于每个任务，AI 从工件拉取初始上下文并请求文件。
• 实现完成后——自动提交（可选）。
• 更新首页的任务看板。

聊天完全上下文相关：嵌入在工件和任务中，无需切换上下文。

2.0 版本关键更新

Skaro 2.0 优化了整个流程：

• 上下文聊天：可在架构、里程碑、任务中使用。讨论保存为 chat-conversation.json。
• 任务前 LLM 上下文：模型在启动前审阅 spec.md、plan.md 和 ADR。
• 自动提交：在 config.yaml 中配置，任务结束后提交变更。
• 统计仪表盘：专用页面显示 token_usage.yaml 和 usage_log.jsonl。
• 看板：首页概览里程碑、阶段和任务。
• UI 自定义：主题和强调色，适应日常使用。

修复了稳定性和 UI 问题。

发展路线图

开源核心不变：工件和协作模式。未来计划：团队工作空间带访问控制、令牌分析、共享看板和支出管理。

关键要点

• 工件作为外部记忆：ADR 和里程碑防止 AI 开发中的上下文漂移。
• 角色分离：人类做架构师，AI 做实现者，依托结构化约束。
• 上下文聊天：讨论留在仓库中，不散落各窗口。
• 自动化：预上下文和自动提交减少摩擦。
• 可扩展性：从个人开发到团队协作。

— Editorial Team