$npx -y skills add Peiiii/skild --skill project-osAI project OS for autonomous loop, automated orchestration, and rule-driven execution.
| 1 | # Project OS |
| 2 | |
| 3 | 用于在新项目中快速落地“开发规范 + 迭代日志 + 发布闭环”的通用体系(Project OS),面向未来演进为可自治、可编排、自动驱动研发流程的 AI 操作系统。 |
| 4 | |
| 5 | ## 三段式定位 |
| 6 | |
| 7 | 1) 自治闭环 |
| 8 | 覆盖需求—实现—验证—发布—线上冒烟—复盘的端到端闭环,系统自动推动流程完成并形成可追踪证据链。 |
| 9 | |
| 10 | 2) 自动化编排 |
| 11 | 将研发流程拆解为可编排的步骤与指令(commands/skills/workflows),以最小人工干预串联执行、回滚与验收。 |
| 12 | |
| 13 | 3) 规则驱动执行 |
| 14 | 所有行为由 Rulebook 统一约束与裁决,确保执行一致性、合规性与可审计性;如需例外必须显式声明并记录。 |
| 15 | |
| 16 | ## 适用场景 |
| 17 | |
| 18 | - 想把一套严格交付流程迁移到其他项目。 |
| 19 | - 需要在团队内统一验证/冒烟/发布规范。 |
| 20 | |
| 21 | ## 启用方式(必须先初始化才生效) |
| 22 | |
| 23 | 本 Skill 安装后不会自动生效,首次使用时需要初始化;初始化完成后规则与流程才会被执行。 |
| 24 | |
| 25 | ## 初始化流程(首次使用) |
| 26 | |
| 27 | 1) 用户安装本 Skill 并开始与 agent 对话。 |
| 28 | 2) agent 检测到目标项目尚未初始化(如缺少 `AGENTS.md`/`commands`/`docs/logs`)。 |
| 29 | 3) agent 主动提示初始化必要性与影响,并请求确认。 |
| 30 | 4) 用户确认后,agent 自动完成初始化并反馈结果。 |
| 31 | |
| 32 | ## 初始化会做什么 |
| 33 | |
| 34 | - 生成/更新 `AGENTS.md`(若已存在,则合并而非覆盖) |
| 35 | - 生成/更新 `commands/commands.md` |
| 36 | - 生成/更新 `docs/logs` 与 `docs/workflows` |
| 37 | - 保证规则、指令索引、日志制度完整落地 |
| 38 | |
| 39 | ## 手动初始化(仅作为兜底) |
| 40 | |
| 41 | 将本 Skill 的模板复制到目标项目根目录(若已有文件,需合并而非覆盖): |
| 42 | |
| 43 | ```bash |
| 44 | cp -R <skill>/assets/commands ./commands |
| 45 | cp -R <skill>/assets/docs ./docs |
| 46 | cp <skill>/assets/AGENTS.template.md ./AGENTS.md |
| 47 | ``` |
| 48 | |
| 49 | ## 关键约束 |
| 50 | |
| 51 | - “完成所有/完成全部”默认执行完整上线闭环(migrations -> deploy -> 线上冒烟)。 |
| 52 | - 冒烟测试默认使用非仓库目录环境,禁止写入仓库子目录。 |
| 53 | - 每次开发阶段结束必须完成 build/lint/tsc + 冒烟(如适用)。 |
| 54 | |
| 55 | ## 扩展与维护 |
| 56 | |
| 57 | - 新增/修改指令:更新 `commands/commands.md` 并同步 AGENTS 索引。 |
| 58 | - 新增/修改规则:只在 AGENTS 的 Rulebook 维护。 |
| 59 | - 发布流程统一写入 `docs/workflows/npm-release-process.md`。 |
| 60 | |
| 61 | ## 模板索引 |
| 62 | |
| 63 | - `assets/AGENTS.template.md` |
| 64 | - `assets/commands/commands.md` |
| 65 | - `assets/docs/logs/TEMPLATE.md` |
| 66 | - `assets/docs/logs/README.md` |
| 67 | - `assets/docs/workflows/npm-release-process.md` |