peiiii/skild/project-os

Project OS

用于在新项目中快速落地“开发规范 + 迭代日志 + 发布闭环”的通用体系（Project OS），面向未来演进为可自治、可编排、自动驱动研发流程的 AI 操作系统。

三段式定位

1) 自治闭环 覆盖需求—实现—验证—发布—线上冒烟—复盘的端到端闭环，系统自动推动流程完成并形成可追踪证据链。

2) 自动化编排 将研发流程拆解为可编排的步骤与指令（commands/skills/workflows），以最小人工干预串联执行、回滚与验收。

3) 规则驱动执行 所有行为由 Rulebook 统一约束与裁决，确保执行一致性、合规性与可审计性；如需例外必须显式声明并记录。

适用场景

• 想把一套严格交付流程迁移到其他项目。
• 需要在团队内统一验证/冒烟/发布规范。

启用方式（必须先初始化才生效）

本 Skill 安装后不会自动生效，首次使用时需要初始化；初始化完成后规则与流程才会被执行。

初始化流程（首次使用）

1) 用户安装本 Skill 并开始与 agent 对话。 2) agent 检测到目标项目尚未初始化（如缺少 AGENTS.md/commands/docs/logs）。 3) agent 主动提示初始化必要性与影响，并请求确认。 4) 用户确认后，agent 自动完成初始化并反馈结果。

初始化会做什么

• 生成/更新 AGENTS.md（若已存在，则合并而非覆盖）
• 生成/更新 commands/commands.md
• 生成/更新 docs/logs 与 docs/workflows
• 保证规则、指令索引、日志制度完整落地

手动初始化（仅作为兜底）

将本 Skill 的模板复制到目标项目根目录（若已有文件，需合并而非覆盖）：

cp -R <skill>/assets/commands ./commands
cp -R <skill>/assets/docs ./docs
cp <skill>/assets/AGENTS.template.md ./AGENTS.md

关键约束

• “完成所有/完成全部”默认执行完整上线闭环（migrations -> deploy -> 线上冒烟）。
• 冒烟测试默认使用非仓库目录环境，禁止写入仓库子目录。
• 每次开发阶段结束必须完成 build/lint/tsc + 冒烟（如适用）。

扩展与维护

• 新增/修改指令：更新 commands/commands.md 并同步 AGENTS 索引。
• 新增/修改规则：只在 AGENTS 的 Rulebook 维护。
• 发布流程统一写入 docs/workflows/npm-release-process.md。

模板索引

• assets/AGENTS.template.md
• assets/commands/commands.md
• assets/docs/logs/TEMPLATE.md
• assets/docs/logs/README.md
• assets/docs/workflows/npm-release-process.md