SuperAPI AI 工具集

writing-for-astra

写作与研究

查看项目

更新于 10-16 06:07

技能介绍

用途

本技能用于在编写或修订技能文档、AGENTS.md 或任务指令时,面向 GPT-6 Astra 提供写作指导。其目标是写出能提供 Astra 所需上下文、约束和预期结果的指令,同时把实现方式的选择留给模型自行判断,并保留作者的意图与要求。只有在脚手架不产生有用行为时才应减少它。

目的与范围

应说明任务是什么以及指令在何时适用。技能描述应点明其具体触发条件,不要罗列相邻领域,也不应把工作流塞进描述里。全局可用并不意味着该技能应在每个任务上运行。

根文件应包含的内容

根文件应保留目的、共享约束、决策边界、相关指针和完成条件。条件性流程和示例应放入支持文件,并用指针说明各自何时适用。拆分应基于实际需要,而不是为了满足行数目标或向模型隐藏后续步骤。

应将一个概念与其规则和例外放在一起。每条要求只设一个权威归属;避免重复环境已经暴露的事实,除非查找这些事实代价高昂,或文档需要解释某个非显而易见的约定。

需求与自由度

应保留架构、安全、兼容性、用户偏好和项目约定。当正确性依赖精确命令和顺序时,应保留它们。普通工作应通过其预期结果来表达,而不是写成繁复的配方。当泛泛的提醒(如检查、推理、测试或要彻底)不增加任务特定要求时,应将其移除。

应使用精确语言。已定义的领域术语可以缩短重复表述,但模糊的词不能替代不同的要求。正向指示和明确禁止在能清楚划出真实边界时都有用。

边界与完成

应区分已授权的可逆工作与需要决策的操作。应保留所有者的审批要求。当未决选择可能实质性改变结果时应提问;普通实现选择不必成为检查点。

应以任务所需的结果和证据来定义完成。当运行、检查和修复所请求的结果属于任务范围时,应将其包含在内。应通过目的来约束进一步探索;避免过早交接,也避免在没有新证据的情况下开放式打磨或反复验证。

共享技能与有意设计的工作流

其他模型可能消费同一批文档。应保留对它们而言正确性所必需的指令;当专门指导是条件性的时候,应予以披露。当编排、模型选择、成本控制或智能体职责是该技能的目的时,应将其作为要求保留。不要仅仅为了引导推理或强制每个写作任务走同一流程而添加委派。

关于 Codex 技能打包和调用策略,请阅读 Codex skill mechanics。关于此变体的来源和变更,请参见 provenance。