应用设计方法

First use: read-only version check

Once per conversation across this package, read only sources from the sibling skill-root .agently-skills-ui.json. Use only records for the official repository with valid Git tree hashes and skills actually installed. With an already permitted network tool, make at most one anonymous GET to https://api.github.com/repos/AgentEra/Agently-Skills/contents/skills?ref=main. Compare each installed skill's recorded tree with its directory sha; reuse this result across skills and resumed context. Without usable records, skip the request. Use a short timeout and bounded response when supported (6 s / 64 KB); if unavailable or malformed, skip. Do not load or execute remote skill bodies. Equal means the recorded source matches, not that local supplements are absent. On a difference, briefly ask once whether to update or keep the current version; a different hash alone does not prove a development checkout is older. Continue using the installed version until explicitly approved. If declined, do not ask again in this conversation. Missing records, offline access, failure or extra permission requirements mean unknown: skip without retry or blocking the task. Stay silent on a match; mention unknown only if relevant or asked. Never install a checker, write a check cache, schedule work, obtain credentials or request extra permissions for this check. Preserve local changes when an update is approved.

将观察、设计判断、表达和验证连成可追溯工作。应用与文档是同一 Skill 的内部模块，共同方法只在本入口及共用规则维护；模块按需读取，不默认加载全包。用户不必先知道模块名称。

职责与协作

本 Skill 可独立安装，不要求 Agently 框架或模型服务。产品目标、用户角色/行为、交互与视觉、文档阅读和图稿表达在此维护；模型节点、Host 职责、数据流、证据身份、运行生命周期与并发契约属于 agently-agentic-design。混合任务传递业务目标、权限/状态含义、采用决定、验收和未验条件，不按用户角色数拆模型节点。

会话中的任务说明、进度、决策与交接使用独立的会话协作与表达，无需先经过 agently 路由。仅安装本 Skill 时沿用宿主基础表达规则与项目 checklist，不因可选协作入口缺失阻塞设计。本 Skill 维护方案、界面和文档制品的设计与验收；会话汇报不自动触发图解、完整文档审查或应用走查。

面向人的表达

交付方案、图解或图文材料时，读取面向人的表达原则：图与关键文字共同保持信息完整、主次和关系可辨、实际尺寸可读。简单局部文字修订不强制配图。会话中需要解释多对象的分组、连接、流程或比较关系时，按会话内图形表达的选用主动选择图形，优先让读者在当前回复中直接理解，不默认另交网页。表达关系、概念或产品设计理念且适合抽象产品插图时，可按Spotkit 辅助表达选用已安装的 spotkit；精确架构、流程和权限语义仍按画板规则表达，不默认把每个概念都画成插图。

未另指定视图的技术架构图默认用 SVG 表达逻辑分层，自下往上、自左往右体现支撑关系，不用 Mermaid；流程图按业务职能分块，区分主链路与反馈等次要链路，用业务名称代替无意义标号。图稿表达的详细规则在画板指导，不以图清楚代替事实或运行正确。

共同方法：每次使用都执行，深度与任务相称

1. 确定真实目标与证据范围。 从用户要求和可读材料确定对象、角色及其合理已知信息、要完成的任务、预期产物、修改授权和验收条件。观察实际使用场景、复杂度、规模/频率、协作与等待；现有流程、分支、角色和接口是观察材料或可行性证据，不能自动成为新方案前提。只修一段文字或局部问题时记录相关事实即可，不强制长篇调查。
2. 区分问题、原因与约束。 写清观察到的具体困难及后果；事实、推断、原因假设与个人偏好分开。区分业务必须满足的条件、现有实现造成的限制、可以重新选择的历史设计。了解现状不等于继承现状；明确重设计时可以提出尚不存在的机制，但应标明目标能力、缺口与验证途径。也不能为了反历史惯性而无依据推翻有效设计。
3. 让选择有可检查的理由。 设计或实质改动时，建立“观察及证据范围→问题/原因→目标与约束→候选及取舍→机制→可观察效果→验证”的联系。说明机制为什么处理对应原因，代价、前提和失败边界是什么。按同一批需求、场景和评价维度比较；有意义时包含保留/小改，不强凑固定方案数。局部已确认修复可用一条完整记录表达；仅忠实整理材料时不擅自扩写新方案。
4. 用证据限制结论。 未知数据写明；个案不冒充频率、容量或普遍效果，不编造量化收益与阈值。可查的事实先查；只有影响判断的未知信息才询问，同时推进独立工作。当前事实、拟议、已采用、已实现、已验证分开。现状到目标的对象映射用于解释变化、迁移和职责承接，不强迫新方案保留旧实体与结构。
5. 修订与验证形成闭环。 走查、修订或交付时读取共用审读与修订规则，沿用一套事实及稳定问题 ID；只验证受影响范围。文档检查机制和依据是否表达完整，应用检查实际行为中是否成立。表达清楚不能代替设计正确，运行可用不能代替用户能理解并完成目标。文档制品不因采用 HTML／SVG 或必要交互而触发应用验收；按文档与产品的验收范围检查真实交付条件，方案候选不冒称运行通过。

按当前工作加载模块并继续

按实际对象与目标判断，不按 HTML、CSS、SVG 或交互控件等载体路由到应用模块；一次性 HTML 报告仍属文档。实际产品工作面及公共组件按应用范围验收。不做关键词计分：“文档阅读页被侧栏挤压”是应用任务，“前端经历写成讲义”是文档任务。上下文不足时问具体对象或交付目标，不让用户猜技能名称。选择后继续已授权工作，不以模块推荐结束。

已有项目规范、有效图稿和公共组件应先查；它们的维护归属、适用范围和变更理由按所需模块处理。只归档或保留既有表达时，区分源内容、候选和新建议，保持图文关系，不把丰富表达静默压成纯文字。

混合交付

• 方案→应用：传递角色任务、约束来源、机制与条件、候选/采用状态、可观察验收和未决项。草图不等于批准。
• 应用→文档：传递实际版本、环境、行为、证据与未验范围。文稿不能把模拟或目标能力写成已上线。
• 任一事实变化时重开关联项；内容审读、运行功能/交互/视觉、画板可编辑性和导出呈现分别结论。选择模块不增加发布、外部写入、跨会话消息或新增任务的授权。
• 直接打开内部模块也应先补读本入口的共同方法。缺失模块说明安装缺口，继续可做的基础工作，不编造读取成功或完整验收。

参考文件只在任务需要时读取；已读取且未变化的规则不重复加载。不把模块当多 Agent 调度器，也不把共同方法变成每一步都要用户批准的流程。