SuperAPI AI 工具集

build-cs-skill

编程与开发

查看项目

更新于 10-15 19:51

技能介绍

用途:build-cs-skill 是 CodeStable 的技能编写与演进协议,适用于创建、重构、精简或审查 plugins/codestable/skills/<skill-name>/ 或 .claude/skills/<local-skill-name>/ 下的 cs-* 技能。目标是构建最小的常驻控制面,让智能体能选择相关上下文、遵守硬性门禁、安全协作并留下可恢复证据;SKILL.md 是薄壳,references 与仓库事实是厚上下文。

主要能力:定义技能类型(OperatorSkill、WorkflowSkill、MethodologySkill、CompatibilityShim、ReferenceDoc)与形态(NoActiveSkill、ThinOperator、ContextualWorkflow、ToolBackedWorkflow、ShimSkill、ReferenceSkill),并给出 selectSkillShape、selectProcessProtocol、placeRule、buildContextPlan、buildThinHarness 等选择逻辑。规则放置分为 Harness、StageContext、ProjectContext、DeterministicGate、Remove,要求每条规则只有一个规范归属。

使用方式:按构建协议执行——先确定范围与职责,再选最小形态,逐条放置规则,先建上下文计划再写薄壳,按触发/前置、职责、上下文契约、决策契约、硬门禁、协作、完成/失败顺序编写;仅在有用时添加协作,委派需有明确所有权与独立完成检查,默认 LeafExecutor,只有 Orchestrator 可继续委派。最后压缩、验证并收尾,运行相关仓库测试与 git diff --check,必要时加载 references/cs-skill-quality-gates.md 制定验证计划。

适用场景:技能作者、维护者进行技能创建、重构、精简、审查与持续演进;处理路由、检查点、失败、兼容或禁止动作等场景。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息。技能须可独立安装,不依赖同级技能文件或集中式运行时;项目上下文应放在 .codestable/attention.md、.codestable/lessons/、.codestable/work/ 或项目现有文档与 ADR 中;v2 技能可搜索 v1 产物但不得执行其工具。目标或输出不明确、编辑冲突无法保留、权限边界冲突、必要上下文无法识别或压缩会移除恢复/安全契约时,返回 NeedsHuman。