SuperAPI AI 工具集

proj-decide

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:当用户确认一项值得记录、供未来参考的架构决策时调用 proj-decide,用于撰写架构决策记录(ADR)。

主要能力:在 projects/{slug}/architecture/YYYY-MM-DD-{adr-slug}.md 中撰写 ADR,frontmatter 包含 kind=decision、status=in-progress 或 completed,以及项目链接;若不存在项目上下文,默认使用 playground。随后执行通用性检查:若该决策适用于本项目之外,则创建带 provenance 的 concepts/ 页面(provenance 为 project,若受研究启发则为 mixed)。写入顺序为:ADR →(可选)概念页 → vault index.md → vault log.md 与 project log.md。

使用方式:先进行预定向阅读(标准四项加项目上下文),再撰写 ADR,然后运行 skillwiki validate <adr>;若返回非零则停止。

限制与停止条件:任一页面 validate 返回非零即停止。禁止在未显式标注 provenance 的情况下归档概念页。

适用场景:记录项目架构决策并沉淀可复用概念。其他细节暂未提供。