用途:在进入方案讨论或实现之前,为某一个问题(issue)产出一段简洁的“当前状态”叙述,让参与者对现状形成一致认识。该技能属于调查、内省与讨论型工作流,运行期间不得修改应用代码、测试、配置或项目资源。\n\n主要能力与输出:阅读相关模块、调用方、测试、工单或文档,以该任务的主题专家身份梳理系统今天在该问题相关处的实际运作方式。输出为一段连贯的自然语言简述,说明今天系统如何工作,并在文中以内联 markdown 链接形式引用函数名、关键赋值、schema 字段等作为上下文。不包含图表或表格。\n\n叙述结构:按人跟随系统的顺序自上而下、向前、具体地讲述,从可识别的入口点(产品或 API 表面、主要作业)开始,说明工作如何流经与该问题相关的各层,深入程度以解释该缺口附近的当前行为为限。不要从深层叶子(私有 helper、单个 changeset 字段、内部作业)开头再向上回溯,也不要在叙述中途从某个窄函数重新起头。用具体机制说明谁调用谁、什么先运行、输入变成什么产物,避免用“flows”“feeds”等含糊动词代替机制。若尚不能说清,应继续读代码直到能说清。\n\n写作约束:每段最多三句话,绝不写第四句,超出则另起一段。整节“1 - Describe current state”是一段连贯故事,不要拆成冷开场加单独“深入分析”。不需要前言(如“在本节中”)。本步骤只描述当前状态,不得包含实现意图、建议、选项框架或未来行为;若句子漂向推荐或实现意图,应改写为当前行为或当前约束。\n\n与其它技能的配合:当该步骤在 solutionize 技能下运行时,输出何时以及如何持久化遵循该技能的规定。\n\n限制:资料未提供该技能的具体安装命令、运行平台、收费方式或更多使用示例。
describe-current-state
编程与开发
更新于 10-15 22:41