agent-os-framework

用途

Agent OS Framework 用于为代码仓库生成标准化的 .agent-os 目录结构，以支持 AI 原生（AI-native）的仓库工作流。它把产品愿景、技术选型、开发路线和架构决策等关键信息以固定模板沉淀到仓库中，便于人和 AI 工具共同读取与维护。

主要能力

该技能会创建完整的 .agent-os 结构，包含以下目录与文件：

product/：核心产品文档
- mission.md：产品定位、目标用户、痛点、成功指标、差异化、非目标
- tech-stack.md：技术选型与架构说明
- roadmap.md：开发阶段与里程碑
- decisions.md：决策日志
specs/：功能规格说明，含 README.md 作为规格索引
standards/：代码风格指南（code-style.md）与测试指南（testing.md）
instructions/：工作流说明，含 create-spec.md（如何创建规格）与 execute-tasks.md（如何执行任务）

每个模板都提供了结构化字段，例如 mission.md 包含产品推介、目标用户、痛点对比、成功指标表、差异化、竞争格局和非目标；tech-stack.md 包含技术总览表、核心技术说明、开发工具、基础设施、数据存储、外部依赖和决策理由；roadmap.md 包含愿景、当前阶段、阶段总览、详细阶段、里程碑、风险与缓解、依赖；decisions.md 包含决策模板和已记录决策（如包管理器、可视化库、测试框架的选择）。

使用方式

通过命令调用：

生成完整 .agent-os 结构：/agent-os-framework
为已有项目生成：/agent-os-framework --update（仅创建不存在的文件）
生成特定组件：/agent-os-framework --component mission

使用前提：仓库已用 git 初始化、对项目有基本了解、使命部分需要相关方输入。

适用场景

设置新仓库
为项目添加 AI 工作流支持
记录产品愿景
创建决策记录

限制与不适用场景

项目已有完整的 .agent-os 时不适用
非产品类仓库（如 dotfiles）不适用

最佳实践

保持 mission 最新，按季度审查
决策做出后及时记录
每周或每两周更新路线图状态
在 CLAUDE.md 中引用，从根配置链接

版本

1.0.0（2026-01-14）：初始发布，包含 mission、tech-stack、roadmap 和 decisions 的 .agent-os 框架。

技能介绍

用途