ctx-spec

仓库创建 2026年7月6日最近提交 21 天前SkillHot 收录 21 天前

▸ 精选理由

把决策约束与可测试验收标准写成可执行的规范，利于自动化交付。

这个 Skill 做什么

撰写可供 AI 代理直接构建的规范、ADR 与设计文档。

帮你把需求和设计写成能被 AI 编码代理直接执行的规范、ADR 或架构文档。适合在撰写或重构 spec、ADR、架构/设计文档时使用。强调恰当的粒度——给出约束而不是手写实现，提出可测试的 EARS 验收标准，并按 ADR 纪律只记录已决定的选项，便于代理无歧义地去实现。

▸ 展开 SKILL.md 英文原文

Writes specs, ADRs, architecture and design docs that an AI coding agent can build directly from — the right granularity (constraints, not hand-written implementation), testable EARS acceptance criteria, and ADR discipline (record only decided choices, supersede in place). Use when writing or restructuring a spec, a decision record (ADR), an architecture doc, or a design doc in a ctx knowledge base, or when deciding how detailed a spec needs to be.

Skill 开发管理规范ADR设计文档通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/motiful/ctx/main/skills/ctx-spec/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/motiful/ctx/main/skills/ctx-spec/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# ctx-spec — Write Docs an Agent Can Build From

> The lifetime model and shared conventions live in [`../ctx`](../ctx/SKILL.md); this is the spec / ADR / design how-to layer.

## The grounding — why a spec is not a report

The whole model rests on one professional distinction, named four ways. A spec holds **Reference / Normative / prescriptive** content; rationale and comparison go to a **report** (Explanation) or an **ADR** (the why).

- **Diátaxis** *(Procida, [diataxis.fr](https://diataxis.fr))* — a spec = **Reference**: neutral, normative, states conclusions and constraints; no teaching, no comparison. A report = **Explanation**: discursive, disposable. Mixing them ("**mode bleed**") i

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有