Simplicio开发CLI

📌 Skill基础信息

Skill名称：simplicio-dev-cli

简称：Simplicio开发CLI

来源：社区第三方（wesleysimplicio）

运行宿主：只能在使用 Simplicio Mapper 框架的Agent工具中运行

核心定位：提供确定性的代码变更与验证工作流，通过专用CLI工具实现安全的代码编辑、补丁应用、格式化和验证操作。

🧩 内部核心组成

该Skill基于Simplicio框架构建，主要包含以下核心组件：

核心能力模块：

• 代码编辑与补丁应用系统
• 预执行验证机制
• 后效验证检查
• 证据文件生成
• 重试策略管理

接口契约：

• references/capabilities.yaml - 机器可读的能力映射定义
• references/interfaces.md - 变更、验证、诊断的详细规则
• 标准化操作契约（operation_id, snapshot_id, 验证结果等）

验证工具：

• scripts/probe-capabilities.py - 能力清单验证和重复ID检测

🛠 安装与启用方式

安装命令：

skills install --user wesleysimplicio/simplicio-mapper

前置要求：

• 已部署Simplicio Mapper框架环境
• 具备相应的代码仓库访问权限
• 配置正确的路径和密钥范围

启用流程：

1. 安装Skill包
2. 生成或刷新Prism清单（能力清单）
3. 配置操作范围和验证规则
4. 通过Mapper传递执行计划和证据

📋 标准工作流

1. 输入接收：接受Mapper提供的代码快照、执行意图、范围约束
2. 预验证：在执行前验证仓库、路径、密钥和前置条件
3. 边界操作：执行单一有界变更或验证能力
4. 证据收集：收集标准输出、错误输出、退出状态、差异对比、测试结果和证据文件
5. 智能重试：仅根据能力契约进行重试，避免盲目振荡
6. 结果返回：返回持久化结果供Loop或Runtime进行协调

典型使用链路：Survey → Plan → Validate → Execute → Verify → Report

⚠️ 关键限制与注意事项

平台限制：

• 仅支持集成Simplicio框架的环境
• 依赖特定的代码仓库结构和访问权限

Token消耗：

• 涉及大量代码分析和验证操作，token消耗较高
• 证据文件和验证过程增加额外开销

适用项目类型：

• ✅ 适合需要严格变更控制的中大型项目
• ✅ 适合要求审计追踪和证据保留的场景

不适用场景：

• ❌ 小型快速原型项目
• ❌ 不需要严格验证的简单编辑任务

生产环境适用性：

• 具备完整验证机制，可用于生产环境
• 但需要充分测试和配置调优

已知注意事项：

• 必须预先生成能力清单映射
• 操作前必须完成范围验证
• 不支持向后兼容性维护

✅ 适用场景 & ❌ 不适合场景

适合使用：

• 企业级代码库的标准变更管理
• 需要完整审计追踪的代码修改
• 团队协作中的代码审查和验证
• 自动化代码重构和格式化流水线

不适合使用：

• 快速脚本编写和调试
• 探索性编程和实验性开发
• 简单的文本编辑任务
• 无需验证的快速修改

目标用户：

• 注重代码质量和可维护性的开发团队
• 需要严格变更控制的金融、安全敏感项目
• 自动化代码流水线维护人员

skills install --user wesleysimplicio/simplicio-mapper