concept-design-cn
仅在显式调用时,用 Daniel Jackson 的概念与同步方法设计、写规格、实现、审查、重构或解释软件。将功能放进独立模块,将协作写成明确规则,让软件更模块化、行为更透明、更容易理解与修改。支持 CONCEPT.md/SYNCS.md 结构检查与 Mermaid 关系图。
SKILL.mdskills/zh-CN/concept-design-cn/SKILL.md
GitHub概念设计
用概念定义独立功能,用同步规则定义概念之间的协作。 先写明用户需要的行为,再选择实现。 理解或修改行为时,定位对应概念和规则。
本技能参考 Meng 与 Jackson 的 WYSIWID 方法。
从需要出发
- 明确受益者及其需要的可观察结果。
- 概念为一个目的提供独立行为。
- 状态与动作定义允许的行为。
- 运作原理(OP)用一段代表性历史说明行为如何达成目的。
- OP 不覆盖全部行为,也不保证进展。
- 每个概念实例拥有自己的状态。
- 概念 MUST NOT 互调或互读状态。
- 外部身份不假定另一概念的字段。
- 应用协调放在概念之外的同步规则中。
- 组合 MAY 限制行为,但 MUST 保持各概念契约。
检验论证
- 说明主张、证据及其所需前提。
- 寻找能使主张不成立的场景。
- 比较备选,包含不改。
- 多次修复在同一前提下失败时,重新检验该前提。
- 检查契约能否支持 OP。
- 检查 OP 能否达成目的。
- 应用场景与概念正确性分别检查。
- 所需时限、失败与一致性前提须明确。
- 缺少的决定保留未决;未执行的测试保留未验证。
每项决定只定义一次
- 区分
confirmed(已确认)、proposed(建议)、inferred(推断)、open(未决)。 - 建议或推断 MUST NOT 经转录变成确认需求。
- 每个模型元素只有一处权威定义。
- 沿用已确认决定,直到需求或证据支持重新评估。
- 增加机制前,检查能否删除规则或职责而保持所需行为。
- 重构保持行为,有意重新设计须另行说明。
选择工作
以下为提示词选择器,不是已安装的 shell 命令:
$concept-design-cn [design|settle|prd|build|review|guard|refine|explain] [范围与请求]
$concept-design-cn guard [audit|concept|drift|pipeline|sync|map] [范围]
未指明模式时按请求判断。 意图不清时先只读检查,再询问阻碍工作的取舍。 只读当前工作所需流程。 跨模式沿用已有授权。
| 模式 | 按需读取 | 产出 |
|---|---|---|
design |
设计 | 概念、组合与决策 |
settle |
整理 | 带确认状态的讨论结论 |
prd |
规格 | 记录确认模型与验收 |
build |
实现 | 范围内实现、结构审查或重构 |
review |
审查 | 带证据的只读发现 |
guard |
维护 | 覆盖、回填、漂移、管道或概念与同步关系图 |
refine |
精炼 | 修正建议或授权修复 |
explain |
图解 | 有源码依据的行为解释 |
审查、审计、漂移和仅规划请求 MUST 保持只读。 其他模式只在本次范围内写入。 回填 MUST 区分观察行为、推断目的、缺陷与确认需求。 MUST NOT 改规格掩盖代码缺陷。
规格与检查
图 MUST 使用 Markdown 中的 Mermaid 代码块。 编写或比较规格时使用 CONCEPT/SYNCS 格式。
python3 <技能目录>/scripts/concept_lint.py <CONCEPT.md或SYNCS.md> [其他文件] --json
语法结果不证明目的达成、契约符合性或运行时正确性。 参考资料。