用途:为 TAKT(前提版本 v0.30.0)单独创建或编辑五类 facet 文件——Persona、Policy、Instruction、Knowledge、Output Contract,按各自风格指南生成符合规范的单体文件。
主要能力:先判定 facet 种别(Persona 为单智能体身份与专业知识;Policy 为多智能体共享行为规范;Instruction 为某 movement 的执行步骤;Knowledge 为判断前提的参考信息;Output Contract 为输出结构定义),再检查可复用的内置 facet,最后按模板生成并校验。参考资料位于 references/takt/builtins/ja/,包括 STYLE_GUIDE.md、PERSONA_STYLE_GUIDE.md、POLICY_STYLE_GUIDE.md、INSTRUCTION_STYLE_GUIDE.md、OUTPUT_CONTRACT_STYLE_GUIDE.md、faceted-prompting.ja.md、templates/ 以及内置 personas、policies、instructions、knowledge、output-contracts 目录。创建前必须先阅读对应风格指南。
使用方式:按 Step 1 判定种别、Step 2 确认内置、Step 3 选择模板并创建、Step 4 应用共通规则、Step 5 验证的流程操作。模板如 templates/personas/{simple,expert,character}.md、templates/policies/policy.md、templates/instructions/.md、templates/knowledge/knowledge.md、templates/reports/.md。文件命名用 {name}.md、连字符分隔、英文小写,放置于 ~/.takt/{facet-type}/ 或项目固有位置。可用命令校验:bash .agents/skills/takt-facet/scripts/validate-takt-files.sh,支持 --pieces / --facets 限定范围。
限制:各 facet 有大小上限与禁止事项(如 Persona 不得混入 Policy 详细规则、Instruction 不得手写自动注入变量、Output Contract 不得写执行步骤);见出し深度最多到 ###;文体上 Persona/Policy/Knowledge 用常体,Instruction 用敬体命令调。资料未提供收费、价格与平台信息。